convertkit-automation

通过 Rube MCP 自动化 ConvertKit（Kit）

通过 Rube MCP 使用 Composio 的 Kit 工具包，自动化 ConvertKit（现称为 Kit）的电子邮件营销操作。

工具包文档：composio.dev/toolkits/kit

前提条件

• 必须连接 Rube MCP（可用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Kit 连接，工具包为 kit
• 始终先调用 RUBE_SEARCH_TOOLS，以获取最新的工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 能够响应，以验证 Rube MCP 可用
2. 使用工具包 kit 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请按照返回的授权链接完成 Kit 身份验证
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

核心工作流

1. 列出和搜索订阅者

适用场景：用户想要浏览、搜索或筛选电子邮件订阅者

工具调用顺序：

1. KIT_LIST_SUBSCRIBERS - 使用筛选条件和分页列出订阅者［必需］

关键参数：

• status：按状态筛选（'active' 或 'inactive'）
• email_address：要搜索的完整电子邮件地址
• created_after/created_before：日期范围筛选（YYYY-MM-DD）
• updated_after/updated_before：日期范围筛选（YYYY-MM-DD）
• sort_field：按 'id'、'cancelled_at' 或 'updated_at' 排序
• sort_order：'asc' 或 'desc'
• per_page：每页结果数（最小值为 1）
• after/before：用于分页的游标字符串
• include_total_count：设为 'true' 以获取订阅者总数

注意事项：

• 如果 sort_field 为 'cancelled_at'，则 status 必须设为 'cancelled'
• 日期筛选使用 YYYY-MM-DD 格式（不含时间）
• email_address 仅支持完全匹配；不支持部分电子邮件地址搜索
• 分页使用基于游标的方式，需提供 after/before 游标字符串
• include_total_count 的值是字符串 'true'，而非布尔值

2. 管理订阅者标签

适用场景：用户想要为订阅者添加标签，以便进行细分

工具调用顺序：

1. KIT_LIST_SUBSCRIBERS - 按电子邮件地址查找订阅者 ID［前置步骤］
2. KIT_TAG_SUBSCRIBER - 将订阅者关联到标签［必需］
3. KIT_LIST_TAG_SUBSCRIBERS - 列出特定标签下的订阅者［可选］

添加标签的关键参数：

• tag_id：数字标签 ID（必填）
• subscriber_id：数字订阅者 ID（必填）

注意事项：

• tag_id 和 subscriber_id 都必须是正整数
• 标签 ID 必须对应现有标签；请通过 Kit 网页界面创建标签
• 为已有标签的订阅者再次添加同一标签是幂等操作（不会报错）
• 订阅者 ID 由 LIST_SUBSCRIBERS 返回；使用 email_address 筛选条件查找特定订阅者

3. 取消订阅者的订阅

适用场景：用户想要取消订阅者的所有通信

工具调用顺序：

1. KIT_LIST_SUBSCRIBERS - 查找订阅者 ID［前置步骤］
2. KIT_DELETE_SUBSCRIBER - 取消该订阅者的订阅［必需］

关键参数：

• id：订阅者 ID（必填，正整数）

注意事项：

• 这会永久取消该订阅者对所有电子邮件通信的订阅
• 会保留订阅者的历史数据，但其将不再收到电子邮件
• 此操作是幂等的；取消已退订订阅者的订阅会成功且不会报错
• 成功时返回空响应（HTTP 204 No Content）
• 订阅者 ID 必须存在；不存在的 ID 会返回 404

4. 列出和查看广播邮件

使用场景：用户想浏览邮件广播或获取某封邮件广播的详细信息

工具调用顺序：

1. KIT_LIST_BROADCASTS - 分页列出所有广播邮件［必需］
2. KIT_GET_BROADCAST - 获取特定广播邮件的详细信息［可选］
3. KIT_GET_BROADCAST_STATS - 获取广播邮件的效果统计数据［可选］

列出广播邮件的关键参数：

• per_page：每页结果数（1-500）
• after/before：用于分页的游标字符串
• include_total_count：设为 'true' 以获取总数

获取详细信息的关键参数：

• id：广播邮件 ID（必需，正整数）

注意事项：

• 广播邮件的 per_page 最大值为 500
• 仅已发送的广播邮件提供统计数据
• 草稿广播邮件没有统计数据
• 广播邮件 ID 为数值型整数

5. 删除广播邮件

使用场景：用户想永久删除一封广播邮件

工具调用顺序：

1. KIT_LIST_BROADCASTS - 找到要删除的广播邮件［前置步骤］
2. KIT_GET_BROADCAST - 确认这是正确的广播邮件［可选］
3. KIT_DELETE_BROADCAST - 永久删除广播邮件［必需］

关键参数：

• id：广播邮件 ID（必需）

注意事项：

• 删除操作不可撤销
• 删除已发送的广播邮件会将其移除，但不会撤回邮件
• 删除前请确认广播邮件 ID

常见模式

按电子邮件地址查找订阅者

1. Call KIT_LIST_SUBSCRIBERS with email_address='[email protected]'
2. Extract subscriber ID from the response
3. Use ID for tagging, unsubscribing, or other operations

分页

Kit 使用基于游标的分页：

• 检查响应中的 after 游标值
• 在下一个请求中将游标作为 after 参数传入
• 持续请求，直到响应中不再返回游标
• 使用 include_total_count: 'true' 跟踪进度

基于标签的细分

1. Create tags in Kit web UI
2. Use KIT_TAG_SUBSCRIBER to assign tags to subscribers
3. Use KIT_LIST_TAG_SUBSCRIBERS to view subscribers per tag

已知注意事项

ID 格式：

• 订阅者 ID：正整数（例如，3887204736）
• 标签 ID：正整数
• 广播邮件 ID：正整数
• 所有 ID 均为数值型，而非字符串

状态值：

• 订阅者状态：'active'、'inactive'、'cancelled'
• 某些操作受状态限制（例如，按 cancelled_at 排序要求 status='cancelled'）

字符串参数与布尔参数：

• include_total_count 是字符串 'true'，而不是布尔值 true
• sort_order 是字符串枚举值：'asc' 或 'desc'

速率限制：

• Kit API 有每个账户的速率限制
• 收到 429 响应时应实施退避
• 应适当控制批量操作的执行频率

响应解析：

• 响应数据可能嵌套在 data 或 data.data 下
• 使用备用模式进行稳健解析
• 游标值是不透明字符串；请原样使用

快速参考

任务	工具标识	关键参数
列出订阅者	KIT_LIST_SUBSCRIBERS	status, email_address, per_page
为订阅者添加标签	KIT_TAG_SUBSCRIBER	tag_id, subscriber_id
列出标签下的订阅者	KIT_LIST_TAG_SUBSCRIBERS	tag_id
取消订阅	KIT_DELETE_SUBSCRIBER	id
列出广播邮件	KIT_LIST_BROADCASTS	per_page, after
获取广播邮件	KIT_GET_BROADCAST	id
获取广播邮件统计数据	KIT_GET_BROADCAST_STATS	id
删除广播邮件	KIT_DELETE_BROADCAST	id

---

由 Composio 提供支持