Mailchimp Automation 是一个基于 Rube MCP(Composio)的自动化技能,用于在 AI 客户端中编排 Mailchimp 邮件营销工作流,涵盖活动创建与发送、受众与列表管理、订阅者操作、分组以及效果分析。
用途 该技能面向需要通过 AI 助手自动化 Mailchimp 邮件营销任务的用户,例如创建并发送邮件活动、管理受众和订阅者、执行批量分组操作,以及查看活动报告与订阅者互动数据。
主要能力
- 创建与发送邮件活动:支持创建活动、设置 HTML 内容、发送测试邮件、立即发送或定时发送。活动类型包括 regular、plaintext、rss、variate。
- 管理受众与订阅者:可列出受众、查看受众详情、列出成员(支持状态过滤与分页)、搜索成员、获取成员详情、列出分组。
- 添加与更新订阅者:支持新增订阅者、更新已有订阅者(upsert)、批量管理分组归属。
- 查看活动报告与分析:可列出已发送活动、搜索活动、获取活动详细报告、批量获取报告、查看链接点击详情、查看点击特定链接的订阅者、获取单个订阅者的活动记录、获取活动 HTML 内容。
使用方式 前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Mailchimp 连接(toolkit 为 mailchimp)。 设置步骤:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit mailchimp;若连接非 ACTIVE,按返回的授权链接完成 Mailchimp OAuth;确认连接状态为 ACTIVE 后再执行工作流。 使用约定:始终先调用 RUBE_SEARCH_TOOLS 获取当前工具结构;嵌套参数使用双下划线表示法(如 settings__subject__line、recipients__list__id);分页使用 count 与 offset,默认 count 为 10,最大 1000;搜索端点最多 10 页。
适用场景
- 需要批量创建、测试、发送或定时发送邮件活动。
- 需要查看、搜索、添加或更新受众与订阅者。
- 需要执行分组级别的批量成员管理。
- 需要分析活动打开率、点击率、退订、退信等指标,或查看链接点击与订阅者活动。
限制与注意事项
- MAILCHIMP_SEND_CAMPAIGN 不可撤销,发送前应先发测试邮件并获得用户明确确认。
- 活动发送前必须处于 save(草稿)状态,且具备有效受众、主题、发件人名称、已验证邮箱和内容。
- MAILCHIMP_SCHEDULE_CAMPAIGN 需要有效的未来时间,过去时间会失败。
- 模板与 HTML 内容必须包含合规的页脚/退订合并标签。
- subscriber_hash 必须是小写邮箱的 MD5 值,大小写错误会导致 404 或重复记录。
- stats.avg_open_rate 与 stats.avg_click_rate 是 0-1 的小数,不是 0-100 的百分比。
- 列出成员时建议使用 status="subscribed" 过滤活跃订阅者,否则会返回所有状态。
- 大批量订阅者操作可能触发限流,建议使用批量工具。
- MAILCHIMP_LIST_CAMPAIGNS 仅返回高层 report_summary,详细指标需使用 MAILCHIMP_GET_CAMPAIGN_REPORT。
- 草稿/未发送活动没有有意义的报告数据。
- MAILCHIMP_SEND_CAMPAIGN 成功时返回 HTTP 204(无响应体)。
- 部分事实(如具体收费、价格、平台支持范围)暂未提供。