SuperAPI AI 工具集

klaviyo-automation

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:通过 Rube MCP 接入 Composio 的 Klaviyo 工具包,自动化 Klaviyo 的邮件与短信营销操作,覆盖营销活动浏览、详情查看、消息检查、标签关系和发送任务监控。

前提与配置:需要先连接 Rube MCP(确认 RUBE_SEARCH_TOOLS 可用),并通过 RUBE_MANAGE_CONNECTIONS 以 klaviyo 工具包建立有效的 Klaviyo 连接,连接状态需为 ACTIVE。每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。添加 MCP 端点 https://rube.app/mcp 到客户端配置即可,无需 API 密钥。工具包文档见 composio.dev/toolkits/klaviyo。

主要能力与用法:

  1. 列出并筛选活动:调用 KLAVIYO_GET_CAMPAIGNS,channel 必填(email 或 sms),支持 filter、sort、page_cursor 与 include_archived。分页为必需,需跟随 page_cursor 直至耗尽;服务端状态过滤可能返回混合状态,应在客户端校验 data[].attributes.status。
  2. 活动详情:先用 KLAVIYO_GET_CAMPAIGNS 获取 ID,再调用 KLAVIYO_GET_CAMPAIGN,可用 include_messages、include_tags 附加数据。活动 ID 为字母数字字符串。
  3. 检查活动消息:从活动响应提取消息 ID,再调用 KLAVIYO_GET_CAMPAIGN_MESSAGE,支持 fields__campaign__message 等稀疏字段集(点号语法,如 content.subject、content.from_email)。
  4. 管理活动标签:调用 KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS 获取标签 ID,仅返回 ID。
  5. 监控发送任务:调用 KLAVIYO_GET_CAMPAIGN_SEND_JOB,用发送任务 ID 查询排队、进行中、完成或失败状态。

限制:响应结构嵌套(response.data.data[].attributes),状态字符串区分大小写且可能为复合值(如 'Cancelled: No Recipients')。速率限制通常为突发 10/s、稳定 150/m,标签端点更严(3/s、60/m),遇 429 需退避。需要 campaigns:read 权限范围。Klaviyo 使用版本化端点,不同版本 schema 可能变化,工具响应遵循 Composio 集成中配置的版本。API 密钥、具体收费与价格暂未提供。