
关于
通过 Rube MCP(Composio)自动化 ConvertKit(Kit)任务:管理订阅者、标签、广播和广播统计。始终先搜索工具,再执行操作。
name: convertkit-automation description: "通过 Rube MCP (Composio) 自动化 ConvertKit (Kit) 任务:管理订阅者、标签、广播和广播统计。始终先搜索工具以获取当前模式。" risk: critical source: community date_added: "2026-02-27"
ConvertKit (Kit) 通过 Rube MCP 自动化
通过 Composio 的 Kit 工具包经由 Rube MCP 自动化 ConvertKit(现称为 Kit)邮件营销操作。
前提条件
- Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)
- 通过
RUBE_MANAGE_CONNECTIONS使用工具包kit建立活跃的 Kit 连接 - 始终先调用
RUBE_SEARCH_TOOLS获取当前工具模式
设置
获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS响应以验证 Rube MCP 可用 - 使用工具包
kit调用RUBE_MANAGE_CONNECTIONS - 如果连接不是 ACTIVE 状态,按照返回的认证链接完成 Kit 认证
- 在运行任何工作流之前确认连接状态显示 ACTIVE
核心工作流
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. 管理订阅者标签
何时使用:用户想要为订阅者添加标签以进行分组
工具序列:
KIT_LIST_SUBSCRIBERS- 通过邮箱查找订阅者 ID [前置步骤]KIT_TAG_SUBSCRIBER- 将订阅者与标签关联 [必需]KIT_LIST_TAG_SUBSCRIBERS- 列出特定标签下的订阅者 [可选]
标签关键参数:
tag_id:数字标签 ID(必填)subscriber_id:数字订阅者 ID(必填)
注意事项:
tag_id和subscriber_id必须为正整数- 标签 ID 必须引用已存在的标签;标签通过 Kit 网页界面创建
- 对已标记的订阅者重复标记是幂等操作(不会报错)
- 订阅者 ID 从 LIST_SUBSCRIBERS 返回;使用
email_address筛选查找特定订阅者
3. 取消订阅
何时使用:用户想要取消某个订阅者的所有通信
工具序列:
KIT_LIST_SUBSCRIBERS- 查找订阅者 ID [前置步骤]KIT_DELETE_SUBSCRIBER- 取消订阅该订阅者 [必需]
关键参数:
id:订阅者 ID(必填,正整数)
注意事项:
- 此操作将永久取消订阅者的所有邮件通信
- 订阅者的历史数据会保留,但不再接收邮件
- 操作是幂等的;对已取消订阅的用户再次取消不会报错
- 成功时返回空响应(HTTP 204 No Content)
- 订阅者 ID 必须存在;不存在的 ID 返回 404
4. 列出和查看广播
何时使用:用户想要浏览邮件广播或获取特定广播的详情
工具序列:
KIT_LIST_BROADCASTS- 使用分页列出所有广播 [必需]KIT_GET_BROADCAST- 获取特定广播的详细信息 [可选]KIT_GET_BROADCAST_STATS- 获取广播的性能统计 [可选]
列表关键参数:
per_page:每页结果数(1-500)after/before:分页游标字符串include_total_count:设为 'true' 获取总数
详情关键参数:
id:广播 ID(必填,正整数)
注意事项:
per_page广播最大值为 500- 广播统计仅对已发送的广播可用
- 草稿广播没有统计数据
- 广播 ID 为数字整数
5. 删除广播
何时使用:用户想要永久删除一个广播
工具序列:
KIT_LIST_BROADCASTS- 查找要删除的广播 [前置步骤]KIT_GET_BROADCAST- 验证是否为正确的广播 [可选]KIT_DELETE_BROADCAST- 永久删除广播 [必需]
关键参数:
id:广播 ID(必填)
注意事项:
- 删除是永久性的,无法撤销
- 删除已发送的广播不会撤回已送达的邮件
- 成功时返回空响应(HTTP 204 No Content)
- 广播 ID 必须存在;不存在的 ID 返回 404
重要提示
- 始终先调用
RUBE_SEARCH_TOOLS获取最新的工具模式和参数 - 工具模式可能随时更新;不要依赖缓存的参数信息
- 所有 ID 参数均为正整数
- 分页使用基于游标的方式,不是基于偏移量的
- 日期格式统一为 YYYY-MM-DD
- 删除操作不可逆,执行前务必确认
兼容工具
Claude CodeCursor
标签
后端开发
