SuperAPI AI 工具集

convertkit-automation

智能体与模型

查看项目

更新于 10-16 08:02

技能介绍

用途:通过 Composio 的 Kit 工具包配合 Rube MCP,自动化 ConvertKit(现名 Kit)邮件营销操作,如订阅者、标签、广播及广播统计管理。工具包文档见 composio.dev/toolkits/kit。

前提条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 toolkit kit 建立并确认 Kit 连接为 ACTIVE;每次操作前始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。

安装:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥,添加端点即可生效。随后确认 RUBE_SEARCH_TOOLS 有响应,调用 RUBE_MANAGE_CONNECTIONS 传入 toolkit kit,若连接非 ACTIVE 则按返回的授权链接完成 Kit 认证。

主要能力与用法: 1)订阅者列表与搜索:KIT_LIST_SUBSCRIBERS 支持 status(active/inactive)、email_address 精确匹配、created_after/before、updated_after/before(YYYY-MM-DD)、sort_field(id/cancelled_at/updated_at)、sort_order(asc/desc)、per_page、after/before 游标及 include_total_count(字符串 'true')。若 sort_field 为 cancelled_at,status 须设为 cancelled;日期无时间部分;不支持部分邮箱搜索;分页为游标式。 2)订阅者标签:先用 KIT_LIST_SUBSCRIBERS 找 ID,再用 KIT_TAG_SUBSCRIBER 传入 tag_id 与 subscriber_id(均为正整数),可用 KIT_LIST_TAG_SUBSCRIBERS 查看某标签下订阅者;标签需在 Kit 网页界面创建;重复打标签为幂等。 3)退订:KIT_LIST_SUBSCRIBERS 找 ID,再 KIT_DELETE_SUBSCRIBER 传 id,将永久退订该订阅者所有邮件,历史数据保留,操作幂等,成功返回 204 空响应。 4)广播列表与详情:KIT_LIST_BROADCASTS(per_page 最大 500,游标分页)、KIT_GET_BROADCAST、KIT_GET_BROADCAST_STATS;统计仅对已发送广播可用。 5)删除广播:先列表查找,可经 KIT_GET_BROADCAST 核对,再 KIT_DELETE_BROADCAST 传 id,删除不可撤销,且不会撤回已发邮件。

常用模式:按邮箱查找时调用 KIT_LIST_SUBSCRIBERS 获取 ID 后再执行标签、退订等操作;分页时检查响应中的 after 游标,用 include_total_count 'true' 跟踪进度;基于标签做细分。

限制与注意:所有 ID 均为正整数而非字符串;注意状态值限制;include_total_count 是字符串;Kit API 有按账户速率限制,遇 429 应退避并控制批量节奏;响应数据可能嵌套在 data 或 data.data 下,需防御性解析;游标为不透明字符串,须原样使用。