Mailchimp 集成指南：为 Claude Code 与 AI Agent 构建邮件营销自动化能力

AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载导读Mailchimp 是面向中小企业的邮件营销平台覆盖 campaign活动、automation自动化与 audience受众管理三大核心能力。本指南以 mailchimp.md 为骨架完整讲解其在 Marketing Skills 仓库中的认证方式、常用 Agent 操作、报告指标与限流约束并结合 mailchimp.js 的零依赖 CLI 源码展示如何在不安装任何依赖的情况下让 Agent 直接操作 Mailchimp Marketing API。读完本文你将掌握从 API Key 解析数据中心、到创建/发送 campaign、再到解读投放报告的完整链路并能在 Claude Code 中直接复用现成的 CLI 命令。集成能力概览在仓库的 工具注册表 中Mailchimp 被归类为Email类工具并同时提供 API、MCP 与 SDK 三种接入形态集成方式可用性说明API✓Marketing API覆盖 campaigns、audiences、automationMCP✓可通过 Mailchimp MCP server 接入见 AGENTS.md 的 MCP 工具清单CLI仓库内置仓库提供了 mailchimp.js 单文件 CLI原生工具本身不提供官方 CLISDK✓官方 SDK支持多种语言在 AGENTS.md 中emails技能的实现被明确映射到 customer-io、mailchimp、resend 三个集成指南这意味着 Mailchimp 是 Agent 落地邮件序列、订阅者管理时的首选落地工具之一。而在 emails 技能 的工具对照表中Mailchimp 被标记为SMB email marketing场景的最佳选择且支持 MCP适合直接由 Agent 驱动。认证方式API Key 与 OAuth 2.0Mailchimp 支持两种认证API Key在 Mailchimp 账号后台生成形如xxxxxx-us19其中-后面的后缀就是数据中心标识dc。OAuth 2.0适用于需要代理多账号或走标准授权流的场景。请求头的两种写法二选一Authorization: Bearer {api_key} Authorization: apikey {api_key}Base URL 的格式由 API Key 的数据中心决定https://{dc}.api.mailchimp.com/3.0/这一点在 mailchimp.js 中有最直接的源码印证——CLI 通过API_KEY.split(-).pop()解析出 dc 并动态拼出 Base URLconst dc API_KEY.split(-).pop() const BASE_URL https://${dc}.api.mailchimp.com/3.0注意API Key 本身并不是标准的 Bearer Token。CLI 源码中实际使用的是 HTTP Basic Auth 封装anystring:${API_KEY}这也解释了为什么直接使用apikey头的形式仍然有效const auth Basic Buffer.from(anystring:${API_KEY}).toString(base64)环境变量约定仓库 CLI 总览 规定所有 CLI 统一从环境变量读取凭据Mailchimp 对应的是CLI环境变量mailchimpMAILCHIMP_API_KEYCLI 启动时会先校验该变量是否存在缺失则直接报错退出if (!API_KEY) { console.error(JSON.stringify({ error: MAILCHIMP_API_KEY environment variable required })) process.exit(1) }按仓库安全规范密钥应存放在 shell profile~/.bashrc、~/.zshrc或.env文件中严禁硬编码进脚本在任何命令后追加--dry-run可预览请求凭据会被掩码为***详见 CLI 安全章节。常用 Agent 操作Marketing API v3.0以下为邮件营销工作流中最常用的端点全部来自 mailchimp.md 的核心操作清单并标注了配套 CLI 命令。1. 列出受众listsGET https://{dc}.api.mailchimp.com/3.0/listsCLI 对应命令mailchimp lists list --count 100 --offset 0 mailchimp lists get list_id2. 获取受众成员GET https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members?count100CLI 支持按状态过滤对应status查询参数取值为subscribed/unsubscribed/cleaned/pending/transactionalmailchimp members list --list-id list_id --count 100 --status subscribed3. 添加订阅者POST https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members { email_address: userexample.com, status: subscribed, merge_fields: { FNAME: John, LNAME: Doe } }CLI 对应--tags支持逗号分隔的多个标签mailchimp members add list_id --list-id list_id --email userexample.com --status subscribed --first-name John --last-name Doe --tags customer,premium4. 更新订阅者PATCH https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members/{subscriber_hash} { merge_fields: { FNAME: Jane }, tags: [customer, premium] }更新时必须传入订阅者哈希subscriber hash其计算方式见下文「订阅者哈希」小节。CLI 中该命令以位置参数传入 hashmailchimp members update subscriber_hash --list-id list_id --status subscribed --first-name Jane5. 获取 campaign 列表GET https://{dc}.api.mailchimp.com/3.0/campaigns?count20CLI 支持按status与type过滤mailchimp campaigns list --count 20 --status sent --type regular6. 获取 campaign 报告GET https://{dc}.api.mailchimp.com/3.0/reports/{campaign_id}mailchimp reports get campaign_id7. 创建 campaignPOST https://{dc}.api.mailchimp.com/3.0/campaigns { type: regular, recipients: { list_id: {list_id} }, settings: { subject_line: Your Subject, from_name: Your Name, reply_to: replyexample.com } }CLI 对应type默认为regular支持自定义标题mailchimp campaigns create --list-id list_id --subject Your Subject --from-name Your Name --reply-to replyexample.com --title My Campaign8. 发送 campaignPOST https://{dc}.api.mailchimp.com/3.0/campaigns/{campaign_id}/actions/sendmailchimp campaigns send campaign_id9. 列出自动化automationsGET https://{dc}.api.mailchimp.com/3.0/automationsmailchimp automations list --count 50CLI 参数速查mailchimp.js 内置了完整的 usage 提示输入未知命令时自动输出lists: lists [list|get] [id] [--count n] [--offset n] members: members [list|add|update] [subscriber_hash] --list-id id [--email email] [--status status] [--first-name name] [--last-name name] [--tags t1,t2] campaigns: campaigns [list|get|create|send] [id] [--list-id id] [--subject subject] [--from-name name] [--reply-to email] reports: reports get campaign_id automations: automations list [--count n] [--offset n]使用仓库内置 CLI 落地 Agent 操作仓库所有 CLI 遵循统一的{tool} resource action [options]命令模式见 tools/clis/README.mdMailchimp 也不例外示例mailchimp campaigns list --count 20。三个安装选项方式一直接运行node tools/clis/mailchimp.js campaigns list --count 20方式二符号链接到全局路径ln -sf $(pwd)/tools/clis/mailchimp.js ~/.local/bin/mailchimp mailchimp campaigns list --count 20方式三将整个目录加入 PATHexport PATH$PATH:/path/to/marketingskills/tools/clis所有 CLI 均输出 JSON 到 stdout方便管道处理# 用 jq 提取报告字段 mailchimp reports get campaign_id | jq .opens.open_rate # 保存到文件 mailchimp campaigns list --count 50 campaigns.json源码层面mailchimp.js 的api()封装统一处理了 Basic Auth、JSON 序列化与响应解析--dry-run模式会返回{ _dry_run: true, method, url, headers, body }预览结构而不会真正发出网络请求非常适合 Agent 在正式操作前做参数校验if (args[dry-run]) { return { _dry_run: true, method, url: ${BASE_URL}${path}, headers: { ...headers, Authorization: *** }, body: body || undefined } }关键指标与报告解读Campaign 报告字段字段含义emails_sent总发送量opens打开次数unique_opens独立打开人数open_rate打开率clicks点击次数click_rate点击率unsubscribes退订人数bounces退信数含硬/软退信这些字段是 Agent 评估 campaign 效果、与 emails 技能 中的指标计划Metrics Plan对接时的标准口径。例如判断打开率是否健康、是否触发退订预警、bounce 率是否过高需要清理列表。订阅者哈希Subscriber Hash对订阅者做 PATCH 更新时URL 中的{subscriber_hash}是邮箱地址的 MD5 哈希小写化后计算const hash md5(email.toLowerCase());这是 API 的固定要求Agent 在拼更新 URL 前必须先完成该计算否则会得到 404 或参数错误。订阅者状态机Mailchimp 的订阅者状态有五种Agent 在同步订阅状态时必须正确映射状态含义subscribed活跃订阅者已确认订阅unsubscribed已退订cleaned硬退信邮箱无效Mailchimp 自动清理pending待确认双确认流程中transactional仅交易类邮件不参与营销统计在 mailchimp.js 的members add实现中status默认值即subscribed与--tags一起在创建时传入members update则通过 PATCH 修改status、merge_fields与tags。限流约束与批量操作调用 Marketing API 时需遵守以下限制10 个并发连接每秒 10 个请求批量操作应使用batch endpoints/batch端点单次请求内打包多条子请求Agent 在编排批量导入订阅者、批量打标签等场景时应优先使用 batch 端点而非逐条循环调用避免触发限流循环场景下也应控制并发数不超过 10。何时使用 MailchimpMailchimp 集成适合以下营销任务对应 mailchimp.md 的 When to Use 章节管理邮件列表与订阅者增删改查、状态迁移创建并发送邮件 campaign搭建邮件自动化流程automations分析 campaign 投放表现open/click/unsubscribe/bounce对受众进行细分segmentation对邮件进行 A/B 测试从仓库映射关系看它尤其适合SMB 场景下的邮件营销相比 resend.md开发者友好的交易邮件、sendgrid.md规模化交易邮件、customer-io.md行为驱动自动化与 nitrosend.mdAI 原生序列Mailchimp 的定位是受众管理 campaign 投放 自动化一站式 SMB 方案且是唯一同时具备 MCP 与仓库 CLI 的邮件平台之一见 emails 技能的工具对照。相关技能与扩展阅读Mailchimp 集成指南在仓库中与以下技能联动emails 技能邮件序列设计、campaign 类型与邮件文案规范是使用 Mailchimp 投放前的内容侧前置其 序列模板 与 邮件类型参考 可配合 campaign 创建使用analytics 技能用于将 campaign 报告指标纳入整体测量框架referrals 技能推荐计划类邮件的落地可与受众标签体系--tags结合工具注册表 tools/REGISTRY.md查看 Mailchimp 在仓库全量工具矩阵中的能力标记API/MCP/CLI/SDK 四列全绿CLI 总览了解所有 CLI 的统一安装、认证、安全与输出约定小结Mailchimp 集成是本仓库邮件营销工具链中受众与 campaign 管理的核心一环认证层面通过dc解析与 Basic Auth 封装屏蔽了 API 细节操作层面以lists → members → campaigns → reports → automations五类资源覆盖完整投放闭环能力层面同时提供 MCP 与零依赖 CLI让 Claude Code 和 AI Agent 既能通过自然语言驱动MCP也能通过MAILCHIMP_API_KEY 单文件命令完成脚本化批量操作。配合 emails 技能 的序列策略与 analytics 技能 的测量框架即可在 Agent 工作流中端到端落地「设计 → 投放 → 度量 → 迭代」的邮件营销闭环。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐构建智能日志分析系统Hermes Agent日志管理全栈解决方案构建智能日志分析系统Hermes Agent日志管理全栈解决方案 在AI代理系统日益复杂的生产环境中运维团队面临着一个关键挑战如何从海量日志数据中提取有价AI Agent人工智能AI 应用工具调用Agent 记忆交互助手RAG任务调度MCP 服务Tolt 联盟营销集成指南面向 Claude Code 与 AI Agent 的 SaaS 联盟计划自动化管理Tolt 联盟营销集成指南面向 Claude Code 与 AI Agent 的 SaaS 联盟计划自动化管理 Tolt 是专为 SaaS 产品设计的联盟AAI 技能人工智能用 GetQzonehistory 免费完整导出QQ空间历史说说用 GetQzonehistory 免费完整导出QQ空间历史说说 GetQzonehistory 是一款免费的 QQ空间备份 工具做 QQ空间历史数据导出把网页爬虫数据分析上一篇aws-cli 实战用 aws codeartifact delete-repository-permissions-policy 删除 CodeArtifact 仓库资源策略下一篇QMK Firmware 中的 4pplet Waffling60 Rev C编译、矩阵配置与 DFU 刷写实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考