SuperAPI AI 工具集

klaviyo-automation

智能体与模型

查看项目

更新于 10-16 08:03

技能介绍

用途:通过 Rube MCP(Composio 的 Klaviyo 工具包)自动化 Klaviyo 的邮件与短信营销操作,涵盖活动浏览、详情查看、消息内容检查、标签读取以及发送任务状态监控。

前置条件:需已连接 Rube MCP(RUBE_SEARCH_TOOLS 可用),并通过 RUBE_MANAGE_CONNECTIONS 使用 klaviyo 工具包建立有效的 Klaviyo 连接。应始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。设置方式为在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit klaviyo,若连接非 ACTIVE 则按返回的授权链接完成认证。

主要能力与工具:KLAVIYO_GET_CAMPAIGNS 列出并筛选活动(channel 为 email 或 sms,为 Klaviyo API 必填;支持 filter、sort、page_cursor、include_archived);KLAVIYO_GET_CAMPAIGN 获取活动详情(campaign_id,可 include_messages、include_tags);KLAVIYO_GET_CAMPAIGN_MESSAGE 查看消息内容(id,可用 fields__campaign__message 等稀疏字段集,点号表示嵌套字段,如 content.subject、content.from_email;邮件含 subject、preview_text、from_email 等,短信含 body);KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS 获取活动标签 ID(id,仅返回 ID);KLAVIYO_GET_CAMPAIGN_SEND_JOB 检查发送任务状态(id)。

常见做法:先按 channel 列出活动,使用 page_cursor 翻页直至游标耗尽,再在客户端按 state 校验状态;用稀疏字段集减小响应体积。

限制与注意事项:channel 必填;分页必须进行,单次调用仅返回一页(默认约 10 条);响应嵌套为 response.data.data[].attributes,状态位于 data[].attributes.status;状态字符串区分大小写且可能为复合值;服务端筛选可能返回混合状态,需客户端校验。速率限制:突发 10/s、稳态 150/m,标签端点更严(突发 3/s、稳态 60/m),遇到 429 需退避;所需权限范围为 campaigns:read。API 使用版本化端点,响应模式可能随版本变化,工具响应遵循 Composio 集成所配置的版本。