Mailchimp 营销 API Node.js SDK

它解决什么问题

对接 Mailchimp Marketing API 时，真正的成本不在 HTTP 调用本身，而在调用前后的细节：API Key 放进哪个配置项、audience_id 和 contact_id 分别指向什么、批量接口一次能接受多少条记录。Agent 若直接裸写请求，很容易在参数结构和错误码上反复试错，一次 audience sync 可能要调试好几轮。

技能如何工作

这个技能把官方 Node.js 客户端 @mailchimp/mailchimp_marketing 封装成可被 Agent 直接调用的路径。核心能力覆盖六个场景：

• 受众同步：把外部数据源的联系人写入 Mailchimp audience
• 标签：给 contacts 打 tag，用于后续分层
• 活动编排：创建和安排 campaign
• 自动化触发：通过 automation 触发器启动工作流
• Webhook：订阅和管理 webhook 回调
• 批量操作：在营销规模下进行批量读写

关键步骤是先建立客户端配置（mailchimp.setConfig({ apiKey })），再按上游文档的 getting-started 路径选择对应端点。技能文档从上游 README.md 中抽取了 API 结构和用法，让 Agent 不必在大量文档里翻找。

适用边界

它只做客户端侧的封装，不涉及 Mailchimp 账户权限、发送频率限制或模板渲染。上游文档没有列出额外的特殊限制，完整的端点说明仍需参照 Mailchimp 官方文档。另外，它依赖网络可达 Mailchimp API，所有操作都以账户持有的 API Key 权限为准。