ZuckerBot — Meta Ads MCP Server

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

为什么选择 ZuckerBot？

你的 Agent 已经能编写代码、管理文件和搜索网页。它也应该能管理你的广告。

ZuckerBot 通过 MCP 为任何 AI Agent 提供完整的 Meta Ads 功能。无需仪表盘，无需学习界面，也无需登录平台。你的 Agent 安装后连接广告账户，即可开始工作。

Agent 可以用 ZuckerBot 完成以下操作：

• 只需一条消息即可审计广告账户 — 标记待审核的支出、创意疲劳度、机会评分、优先级排序后的行动项（免费套餐包含）
• 获取广告系列表现并找出有效策略
• 分析广告创意并建议下一步测试内容
• 设置定向和预算，创建并启动广告系列
• 创建自定义受众和相似受众
• 设置服务器端转化跟踪（CAPI）
• 调研竞争对手、评价和市场基准
• 生成广告创意简报和文案

工作原理

You ↔ Your Agent (Claude, ChatGPT, OpenClaw, Cursor, etc.)
                  ↕
            ZuckerBot MCP
                  ↕
         Meta Marketing API

ZuckerBot 负责处理 Meta API 的复杂性。你的 Agent 负责对话。由你做出决策。

安装

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

OpenClaw

添加到 MCP 配置中：

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

Cursor / Windsurf / 任意 MCP 客户端

配置方式相同。ZuckerBot 适用于任何支持 Model Context Protocol 的客户端。

远程 MCP（无需安装）

不想在本地运行任何内容？https://zuckerbot.ai/api/mcp 是托管的 Streamable HTTP 端点，提供相同的工具。

• claude.ai — 将其添加为自定义连接器（Settings → Connectors → Add custom connector），并通过 OAuth 进行身份验证，或传递 Authorization: Bearer zb_live_... 标头。
• Claude Code：

claude mcp add --transport http zuckerbot https://zuckerbot.ai/api/mcp --header "Authorization: Bearer zb_live_..."

• 任何 Streamable HTTP 客户端 — 将其指向 https://zuckerbot.ai/api/mcp，并使用你的 API 密钥作为 Bearer 令牌。

CLI（供人类使用）

npm install -g zuckerbot-mcp

zuckerbot preview https://your-business.com
zuckerbot meta status
zuckerbot create https://your-business.com --budget 5000 --objective leads

工具（50 多种）

审计与许可（2）

设置与账户（7）

广告系列（9）

受众（6）

创意素材（8）

* 创意素材生成工具（generate_static_ad、generate_video_ad、get_video_ad_status、generate_creatives、request_creative）默认禁用——在 MCP 配置环境变量中设置 ZUCKERBOT_ENABLE_CREATIVE_TOOLS=1 即可启用（即将推出付费附加服务）。所有创意素材分析工具仍可使用。

转化跟踪 / CAPI（5）

报告（2）

get_campaign_insights 会提供三个不同的潜在客户数据，而非合并为一个数字，每项数据均已通过 Ads Manager 验证：

成本按 spend / count 计算；Meta 的 cost_per_action_type 不可加总，绝不会求和。同一组字段也会汇总到 summary 中，包括 total_meta_result / blended_cost_per_meta_result（含 meta_result_type）、total_meta_leads / blended_cost_per_meta_lead，以及 total_conversion_leads / blended_cost_per_conversion_lead（total_leads / blended_cpl 与其逐行对应字段一样已弃用）。

投资组合（5）

研究（3）

业务背景（4）

典型 Agent 工作流

0. Audit       →  audit_account (how is this account doing today?)
1. Research    →  research_reviews + research_competitors (parallel)
2. Preview     →  preview_campaign (show user what ads look like)
3. Create      →  create_campaign with mode=legacy (launch-ready draft)
4. Review      →  confirm targeting, creative, Meta connection, and budget
5. Launch      →  launch_campaign after explicit approval
6. Monitor     →  get_performance + creative_analysis
7. Pause       →  pause_campaign whenever delivery must stop
8. Optimise    →  sync_conversion + audience tools

每个工具都会返回一个 _hint 字段，提示接下来应采取的逻辑步骤，因此你的 Agent 始终知道下一步该做什么。 简写：旧流程为创建 → 审核 → 启动 → 监控。智能功能启用和广告组合启动暂不可用；现有 Meta 对象需对按规格构建的广告系列和外部广告系列使用下方经审核的恢复工作流。 MCP 名称包括 zuckerbot_enrich_business、zuckerbot_upload_business_context、zuckerbot_get_campaign、zuckerbot_activate_campaign 和 zuckerbot_create_seed_audience。 zuckerbot_duplicate_ad 会将一个受支持的广告复制到同一广告账户中的现有广告组——默认先进行试运行，创建的广告始终为暂停状态，并且只有显式提供 idempotency_key 才会执行，因此重试绝不会重复创建广告。 zuckerbot_upload_ad_asset 会通过托管的 https URL 将全新的图片或视频文件上传到已连接广告账户的素材库（Meta 会直接下载），并返回 image_hash 或 video_id；对于视频，请轮询 zuckerbot_get_ad_asset_status，直到视频处理完成。 随后，zuckerbot_create_ad 会利用该素材，在任意现有广告组中创建一个新的创意和一个新的暂停广告——包括在 ZuckerBot 之外创建的投放中广告系列——其契约与复制操作相同：先进行试运行，并且必须提供 idempotency_key 才能执行。

ZuckerBot 与替代方案对比

定价

免费套餐助你起步。只需一个优化后的广告系列，Pro 套餐就能收回成本。

获取 API 密钥

终身优惠

如果你在 Dealify 购买了 ZuckerBot 终身许可证，兑换码格式为 ZB-XXXXX-XXXXX-XXXXX，可在一个账户上叠加使用：

你可以直接通过 Agent 使用 zuckerbot_redeem_license 工具兑换（“redeem my ZuckerBot code ZB-...”），也可以在浏览器中访问 zuckerbot.ai/start.html。兑换后，你账户中的每个 API 密钥都会升级；如果你还没有密钥，系统会为你生成一个（只显示一次，请妥善保存）。

对话示例

你： 我这周的 Meta 广告系列表现如何？

Agent 调用 get_account_insights + creative_analysis

Agent： 你本周在 4 个广告系列中花费了 $2,340。你的 LAL 广告系列表现非常出色，CPL 为 $28，比账户平均值低 40%。但你的广泛定位广告系列 CPL 高达 $95，还在持续消耗预算。“客户评价”创意的 CTR 为 3.2%，而产品图片只有 1.1%。我建议暂停广泛定位广告系列，并将预算转投 LAL。

你： 就这么办。

Agent 调用 pause_campaign +（调整预算）

开发

git clone https://github.com/DatalisHQ/zuckerbot.git
cd zuckerbot
npm install
npm run build
npm start

许可证

MIT

激活已暂停的规范构建广告系列

使用 zuckerbot_resume_campaign（POST /v1/meta/resume），并提供真实的 Meta campaign_id（规范构建或外部广告系列，不包括 ZuckerBot 管理的草稿）、可选的 business_id，以及 entity_level（ad、adset 或 campaign）。对于广告或广告组，请提供其 entity_id。

1. 使用 dry_run: true（默认值）调用。与用户核对返回的层级结构、账户 货币、预算、广告系列支出上限和广告组结束日期。金额以货币最小单位计；每日预算并非总支出上限。
2. 获得明确批准后，针对相同目标发送请求，并设置 dry_run: false、 confirm_spend: true、返回的 preview_hash，以及唯一的 idempotency_key（8–128 个字母、数字、点、下划线、冒号或连字符）。
3. 对于新的规范构建，请依次对每个目标广告、广告组，最后对 广告系列重复此流程。每项操作都要获取新的预览。激活不会级联到其他已暂停对象，并会保留所有支出控制。
4. 使用 zuckerbot_pause_campaign 停止这些对象中的任意对象。暂停广告系列时，请提供真实的 Meta 广告系列 ID；必要时传入 business_id。

传输失败后，请使用完全相同的请求和密钥重试。结果不确定时，必须先检查实时状态（或暂停对象），再进行后续激活。已存储的成功响应描述的是该操作；重放不会重新激活之后已暂停的对象。ACTIVE 是已配置的状态；Meta 审核、排期以及父级／子级状态仍可能阻止投放。广告组超过 100 个或广告超过 100 个的广告系列，必须使用 Ads Manager 完成此预览工作流。

托管 MCP 会在其 API 部署发布后提供此工具。本地安装的 MCP 客户端需要包含此工具的软件包版本。旧版草稿启动工具不用于激活通过规范构建器创建的对象。

本地广告素材上传

请在存放文件的计算机上运行 stdio MCP 或 CLI。 zuckerbot_upload_ad_asset 只能接受 asset_url、绝对 file_path 或 files: [{ file_path, label? }]（最多 20 个）中的一项。本地文件可以是 JPG/JPEG/PNG（最大 30 MB）或 MP4/MOV（最大 4 GB）。客户端会在批量上传开始前验证所有 文件，以有限大小的分块私密传输文件，并按顺序返回每个文件的结果。无需手动将文件托管在公开位置。 图片会包含 image_hash、原始 width、height 和 name；视频仍使用现有的处理状态／轮询流程。批次中某个条目失败不会撤销之前已上传到素材库的文件。托管 MCP 无法访问本地路径：请使用本地客户端 或 asset_url。上传到素材库不会创建广告，也不会启用投放。