---

name: mailchimp-automation description: "通过 Rube MCP (Composio) 自动化 Mailchimp 邮件营销，包括活动、受众、订阅者、分组和分析。操作前始终先搜索工具获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Mailchimp 自动化

通过 Composio 的 Mailchimp 工具包自动化邮件营销工作流，包括活动创建和发送、受众/列表管理、订阅者操作、分组和绩效分析。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit mailchimp 建立活跃的 Mailchimp 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

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

1. 确认 RUBE_SEARCH_TOOLS 响应正常以验证 Rube MCP 可用
2. 使用 toolkit mailchimp 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Mailchimp OAuth
4. 在运行任何工作流之前确认连接状态为 ACTIVE

核心工作流

1. 创建和发送邮件活动

适用场景：用户想要创建、配置、测试和发送邮件活动。

工具调用顺序：

1. MAILCHIMP_GET_LISTS_INFO - 列出可用受众并获取 list_id [前置条件]
2. MAILCHIMP_ADD_CAMPAIGN - 创建新活动，包含类型、受众、主题、发件人名称 [必需]
3. MAILCHIMP_SET_CAMPAIGN_CONTENT - 设置活动的 HTML 内容 [必需]
4. MAILCHIMP_SEND_TEST_EMAIL - 在正式发送前发送预览给审阅者 [可选]
5. MAILCHIMP_SEND_CAMPAIGN - 立即发送活动 [必需]
6. MAILCHIMP_SCHEDULE_CAMPAIGN - 安排未来发送而非立即发送 [可选]

MAILCHIMP_ADD_CAMPAIGN 关键参数：

• type："regular"、"plaintext"、"rss" 或 "variate"（必需）
• recipients__list__id：收件人的受众/列表 ID
• settings__subject__line：邮件主题行
• settings__from__name：发件人显示名称
• settings__reply__to：回复邮箱地址（发送时必需）
• settings__title：内部活动标题
• settings__preview__text：收件箱中显示的预览文本

MAILCHIMP_SET_CAMPAIGN_CONTENT 关键参数：

• campaign_id：创建步骤返回的活动 ID（必需）
• html：邮件的原始 HTML 内容
• plain_text：纯文本版本（省略时自动生成）
• template__id：使用预建模板替代原始 HTML

注意事项：

• MAILCHIMP_SEND_CAMPAIGN 不可逆；始终先发送测试邮件并获得用户明确批准
• 活动发送前必须处于 "save"（草稿）状态，且具有有效的受众、主题、发件人名称、已验证邮箱和内容
• MAILCHIMP_SCHEDULE_CAMPAIGN 需要有效的未来日期时间；过去的时间戳会失败
• 模板和 HTML 内容必须包含合规的页脚/退订合并标签
• Mailchimp 使用双下划线表示嵌套参数（例如 settings__subject__line）

2. 管理受众和订阅者

适用场景：用户想要查看受众、列出订阅者或检查订阅者详情。

工具调用顺序：

1. MAILCHIMP_GET_LISTS_INFO - 列出所有受众及成员数量 [必需]
2. MAILCHIMP_GET_LIST_INFO - 获取特定受众的详情 [可选]
3. MAILCHIMP_LIST_MEMBERS_INFO - 按状态筛选和分页列出成员 [必需]
4. MAILCHIMP_SEARCH_MEMBERS - 跨列表按邮箱或姓名搜索 [可选]
5. MAILCHIMP_GET_MEMBER_INFO - 获取特定订阅者的详细资料 [可选]
6. MAILCHIMP_LIST_SEGMENTS - 列出受众内的分组 [可选]

MAILCHIMP_LIST_MEMBERS_INFO 关键参数：

• list_id：受众 ID（必需）
• status："subscribed"、"unsubscribed"、"cleaned"、"pending"、"transactional"、"archived"
• count：每页记录数（默认 10，最大 1000）
• offset：分页偏移量（默认 0）
• sort_field："timestamp_opt"、"timestamp_signup" 或 "last_changed"
• fields：逗号分隔的字段列表以限制响应大小

注意事项：

• stats.avg_open_rate 和 stats.avg_click_rate 是 0-1 的小数，不是 0-100 的百分比
• 始终使用 status="subscribed" 筛选活跃订阅者；省略会返回所有状态
• 必须使用 count 和 offset 分页，直到收集的成员数匹配 total_items
• 大列表响应可能被截断；数据在 response.data.members 下

3. 添加和更新订阅者

适用场景：用户想要添加新订阅者、更新现有订阅者或批量管理列表成员。

工具调用顺序：

1. MAILCHIMP_GET_LIST_INFO - 验证目标受众存在 [前置条件]
2. MAILCHIMP_SEARCH_MEMBERS - 检查联系人是否已存在 [可选]
3. MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER - 创建或更新订阅者（upsert） [必需]