convertkit-automation

通过 Rube MCP 实现 ConvertKit (Kit) 自动化

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

前置条件

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

设置

获取 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 网页 UI 创建
• 对已打标签的订阅者再次打标签是幂等的（不会报错）
• 订阅者 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 下
• 使用回退模式进行防御性解析
• 游标值是不透明字符串；请严格按返回原样使用

快速参考

任务	工具 Slug	关键参数
列出订阅者	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

使用时机

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅当任务明确符合上述范围时才使用此技能。
• 请勿将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。