Meta Ads MCP

Meta Ads MCP

一个 模型上下文协议（MCP） 服务，可让 AI 助手——Claude、ChatGPT、Perplexity、Cursor 或任何 MCP 客户端——通过自然对话，端到端管理你的 Meta 广告：在 Facebook、Instagram 和 Meta 的所有广告版位上启动广告系列、上传创意素材、更新预算并分析效果。提供为托管式远程 MCP，无需开发者令牌，也无需自行托管。

这是 Pipeboard MCP 系列中的 Meta Ads 节点——由五个远程 MCP 服务（Meta、Google、TikTok、Snap、Reddit）和一个统一的 Pipeboard CLI 组成，共有 230 多种工具，采用统一身份验证和安全模型。如果你正在比较单平台 MCP，那么你看到的只是一个网络节点——请参阅下文的Pipeboard MCP 系列。

注意：这是一个使用 Meta 公共 API 的独立开源项目。其背后的托管服务 Pipeboard 是带徽章的 Meta Business Partner，也是经过官方批准的 Meta 应用，可通过一次登录管理 Meta、Google、TikTok、Snap 和 Reddit 广告（提供免费套餐），因此它既不只支持 Meta，也不要求你自行托管。Meta、Facebook、Instagram 及其他 Meta 品牌名称均为其各自所有者的商标。

mcp-name: co.pipeboard/meta-ads-mcp

社区与支持

• Discord。加入社区。
• 电子邮件支持。发送邮件联系我们获取支持。

目录

• Pipeboard MCP 系列
• 🚀 开始使用远程 MCP（推荐营销人员使用）
• Pipeboard CLI（MCP 的替代方案）
• 本地安装（仅限技术用户）
• 功能
• 配置
• 可用的 MCP 工具
• 许可
• 隐私与安全
• 测试
• 故障排除

Pipeboard MCP 系列

Pipeboard 为每个主要广告平台都提供远程 MCP 服务，并提供一个封装所有服务的单二进制文件 CLI。五个服务共用同一套 OAuth、同一种 tools/list 发现机制、同一写入确认安全模型，以及同一个 Pipeboard API 令牌——因此，Agent 学会使用一个服务，就能学会使用其余服务。

远程 MCP 服务

平台	远程 MCP URL	功能
Meta Ads MCP（Facebook + Instagram）	https://meta-ads.mcp.pipeboard.co/	42 个工具 — 广告系列、广告组、广告、创意素材（包括动态创意测试）、图片上传、数据洞察、兴趣 / 行为 / 人口统计 / 地理位置定向、主页管理
Google Ads MCP	https://google-ads.mcp.pipeboard.co/	59 个工具 — 广告系列、广告组、自适应搜索广告、Performance Max、关键字、GAQL 查询、扩展（附加链接、宣传信息、结构化摘要）、受众群体、素材上传、通用变更
TikTok Ads MCP	https://tiktok-ads.mcp.pipeboard.co/	59 个工具 — 广告系列、广告组、广告、身份、图片和视频上传、受众群体和创意素材管理、数据洞察
Snap Ads MCP	https://snap-ads.mcp.pipeboard.co/	37 个工具 — 广告账户、广告系列、广告组、广告、创意素材、媒体上传、数据洞察
Reddit Ads MCP	https://reddit-ads.mcp.pipeboard.co/	33 个工具 — 账户、广告系列、广告组、广告、效果报告

五个广告平台上共有 230 多个工具，只需一次身份验证即可使用。 将任一 URL 接入 Claude、Cursor、ChatGPT、Perplexity 或任何兼容 MCP 的客户端。在 pipeboard.co 一次性连接广告账户，所有客户端即可访问。

Pipeboard CLI — 在命令行中使用相同的工具

Pipeboard CLI 是一个 Go 单文件二进制程序，可将上述每个 MCP 工具作为带类型的 shell 命令提供 — 专为 AI 编码 Agent（Claude Code、Cline、OpenClaw、Codex）和偏好使用子进程调用而非 JSON-RPC 的自动化脚本打造：

brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>

pipeboard meta-ads get-campaigns   --account-id act_123
pipeboard google-ads execute-gaql-query   --customer-id 1234567890 --query "..."
pipeboard tiktok-ads get-campaigns --advertiser-id 7605685552884596737

启动时间不到 50 毫秒，每次调用无需 MCP 握手，一个二进制程序即可支持全部五个平台。完整文档见 pipeboard-cli repo。

为什么要构建一组服务，而不是每个仓库单独提供一个 MCP？

• 一个账户，覆盖所有平台 — 在 pipeboard.co 一次性完成身份验证；在同一个 Agent 会话中管理 Meta + Google + TikTok + Snap + Reddit
• 跨平台问题得到跨平台答案 — “上周哪个渠道的注册成本最低？”确实可以回答
• 各处采用相同的安全约定 — 写入操作都需明确确认；在平台支持的情况下，新广告系列会以暂停状态启动；五个服务的确认提示完全一致
• 一个令牌、一个速率限制上限、一个撤销位置 — 无需周旋于单独的 OAuth 流程或逐个供应商安装

只看单平台 MCP 基准测试，会错过重点。价值在于网络，而非单个节点。

Pipeboard 的对比

如果你正在选择通过 AI 助手投放 Meta Ads 的方式，以下是客观的现状：

	Pipeboard	Meta 官方 MCP	开源 / 可自托管服务
平台	Meta + Google + TikTok + Snap + Reddit，一个登录即可使用	仅 Meta	通常仅 Meta
设置	托管的远程 MCP — 无需开发者令牌，约 2 分钟即可完成	由 Meta 托管（仅 Meta）	自行托管，并管理自己的令牌和升级
可信度	带有 Meta Business Partner 徽章 + 经批准的 Meta 应用	第一方（Meta）	各不相同 — 需要自行审查代码
安全性	每次写入操作都需明确确认；新广告系列以暂停状态启动	由 Meta 定义	由你自行构建安全防护
价格	免费套餐，另有付费层级	免费（公开测试版）	免费，但基础设施由你运行

Meta 的官方连接器是最安全的单平台选项。Pipeboard 则是跨平台之选 — 通过一次身份验证和一套安全模型，即可在五个广告网络中使用相同的对话式控制，并提供免费套餐且获得 Meta Business Partner 支持。如果你愿意自行托管和维护，开源服务可以让你完全掌控。

开始使用远程 MCP（推荐）

最快、最可靠的入门方式是 🚀 开始使用我们的 Meta Ads 远程 MCP。我们的云服务使用可流式传输的 HTTP 传输方式，可靠、可扩展地访问你的 Meta Ads 账户。无需进行技术配置——只需连接，即可使用 AI 启动、更新和分析广告系列！

Claude Pro/Max 用户

1. 前往 claude.ai/settings/integrations（需要 Claude Pro 或 Max）
2. 点击“添加集成”并输入：
   • 名称：“Pipeboard Meta Ads”（或你喜欢的任何名称）
   • 集成 URL：https://meta-ads.mcp.pipeboard.co/
3. 点击集成旁边的“连接”，并按照提示操作：
   • 登录 Pipeboard
   • 连接你的 Facebook Ads 账户

完成！现在你可以让 Claude 分析 Meta 广告系列、获取效果洞察并管理广告。

高级：直接令牌身份验证（Claude）

若要使用基于令牌的直接身份验证，而不经过交互式流程，请在添加集成时使用以下 URL 格式：

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

在 pipeboard.co/api-tokens 获取令牌。

Cursor 用户

将以下内容添加到 ~/.cursor/mcp.json。启用远程 MCP 后，点击“需要登录”以完成登录流程。

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/"
    }
  }
}

高级：直接令牌身份验证（Cursor）

如果你希望不经过交互式登录流程进行身份验证，可以直接在 URL 中加入 Pipeboard API 令牌：

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN"
    }
  }
}

在 pipeboard.co/api-tokens 获取令牌。

其他 MCP 客户端

使用远程 MCP URL：https://meta-ads.mcp.pipeboard.co/

📖 在此获取 AI 客户端的详细设置说明

高级：直接令牌身份验证（OpenClaw 和其他客户端）

对于支持基于令牌进行身份验证的 MCP 客户端，你可以在 URL 中附加 Pipeboard API 令牌：

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

这样会跳过交互式登录流程并立即完成身份验证。在 pipeboard.co/api-tokens 获取令牌。

其他平台

Meta Ads 是系列中的五个远程 MCP 服务之一——请参阅 Pipeboard MCP 系列，了解 Google Ads、TikTok Ads、Snap Ads 和 Reddit Ads；它们的设置方式相同。

Pipeboard CLI（MCP 的替代方案）

如果你的 Agent 更喜欢使用 Shell 命令而不是 JSON-RPC，Pipeboard CLI 会将系列中的每个工具封装为带类型的子命令——快速安装请参阅上方的系列部分，完整文档请参阅 pipeboard-cli 仓库。

本地安装（仅限高级技术用户）

🚀 我们强烈建议改用 远程 MCP——它速度更快、更可靠，而且无需进行技术配置。

Meta Ads MCP 也支持本地可流式传输的 HTTP 传输方式，你可以将其作为独立的 HTTP API 运行，用于 Web 应用和自定义集成。完整说明请参阅 可流式传输的 HTTP 设置指南。

功能

• 广告系列管理：通过对话创建广告系列、广告组和广告，更新预算、暂停和恢复投放，以及调整定向设置；每次写入操作都会明确征求确认
• 创意素材操作：无需离开 AI 客户端，即可上传图片、制作创意素材，以及更新文案、标题、描述和行动号召
• 动态创意测试：通过一个 API 同时支持简单广告（单个标题和描述）与完整 A/B 测试（多个标题和描述）
• AI 驱动的广告系列分析：让你喜爱的大模型分析效果并提供可执行的洞察
• 策略建议：获取有数据支持的建议，以优化广告支出、定向和创意内容
• 预算优化：获取重新分配预算的建议，将预算投向效果更好的广告组
• 创意优化：获取有关广告文案、图片和行动号召的反馈
• 自动监控：让任何兼容 MCP 的大模型跟踪效果指标，并在出现重大变化时向你发出提醒
• 跨平台集成：支持 Facebook、Instagram 和所有 Meta 广告版位
• 通用大模型支持：兼容任何 MCP 客户端，包括 Claude Desktop、Cursor、Cherry Studio 等
• 合作伙伴支持，不只是开源：由 Pipeboard 构建。Pipeboard 是获得 Meta Business Partner 徽章且经 Meta 官方批准的应用，并提供免费计划和托管式远程 MCP（无需自托管）
• 增强搜索：通用搜索功能会在查询中提到“页面”或“页面（复数）”时搜索页面
• 简单的身份验证：通过安全的 OAuth 身份验证轻松完成设置
• 跨平台支持：支持 Windows、macOS 和 Linux

配置

远程 MCP（推荐）

✨ 在此开始使用远程 MCP — 无需技术设置！只需连接你的 Facebook Ads 账户，即可开始让 AI 分析广告系列。

本地安装（适合高级技术用户）

需要自行托管的高级用户可以从源代码安装软件包。本地安装需要创建自己的 Meta Developer App。我们建议使用 远程 MCP，体验更加简单。

可用的 MCP 工具

1. mcp_meta_ads_get_ad_accounts

   • 获取用户可访问的广告账户
   • 输入：
     • access_token（可选）：Meta API 访问令牌（如果未提供，将使用缓存的令牌）
     • user_id：Meta 用户 ID；若要使用当前用户，请填 "me"
     • limit：最多返回的账户数量（默认值：200）
   • 返回：可访问广告账户的列表及其详细信息

2. mcp_meta_ads_get_account_info

   • 获取指定广告账户的详细信息
   • 输入：
     • access_token（可选）：Meta API 访问令牌（如果未提供，将使用缓存的令牌）
     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
   • 返回：指定账户的详细信息

3. mcp_meta_ads_get_account_pages

   • 获取与 Meta Ads 账户关联的页面
   • 输入：
     • access_token（可选）：Meta API 访问令牌（如果未提供，将使用缓存的令牌）
     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）；若要获取当前用户的页面，请填 "me"
   • 返回：与账户关联的页面列表，可用于广告创建和管理

4. mcp_meta_ads_get_campaigns

   • 获取 Meta Ads 账户的广告系列，并可选择进行筛选
   • 输入：
     • access_token（可选）：Meta API 访问令牌（如果未提供，将使用缓存的令牌）
     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
     • limit：最多返回的广告系列数量（默认值：10）
     • status_filter：按状态筛选（留空表示全部，或填写 'ACTIVE'、'PAUSED' 等）
   • 返回：符合条件的广告系列列表

5. mcp_meta_ads_get_campaign_details

   • 获取指定广告系列的详细信息
   • 输入：
     • access_token（可选）：Meta API 访问令牌（若未提供，将使用缓存的令牌）
     • campaign_id：Meta Ads 广告系列 ID
   • 返回：指定广告系列的详细信息

6. mcp_meta_ads_create_campaign

   • 在 Meta Ads 账户中创建新的广告系列

   • 输入：

     • access_token（可选）：Meta API 访问令牌（若未提供，将使用缓存的令牌）

     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）

     • name：广告系列名称

     • objective：广告系列目标（ODAX，基于成效）。必须为以下值之一：

       • OUTCOME_AWARENESS
       • OUTCOME_TRAFFIC
       • OUTCOME_ENGAGEMENT
       • OUTCOME_LEADS
       • OUTCOME_SALES
       • OUTCOME_APP_PROMOTION

       注意：BRAND_AWARENESS、LINK_CLICKS、CONVERSIONS、APP_INSTALLS 等旧版目标不再适用于新广告系列，使用这些值会导致 400 错误。请使用上述基于成效的值。常见映射：

       • BRAND_AWARENESS → OUTCOME_AWARENESS
       • REACH → OUTCOME_AWARENESS
       • LINK_CLICKS、TRAFFIC → OUTCOME_TRAFFIC
       • POST_ENGAGEMENT、PAGE_LIKES、EVENT_RESPONSES、VIDEO_VIEWS → OUTCOME_ENGAGEMENT
       • LEAD_GENERATION → OUTCOME_LEADS
       • CONVERSIONS、CATALOG_SALES、MESSAGES（以销售为目标的流程）→ OUTCOME_SALES
       • APP_INSTALLS → OUTCOME_APP_PROMOTION

     • status：广告系列的初始状态（默认值：PAUSED）

     • special_ad_categories：适用时填写特殊广告类别列表

     • daily_budget：以账户货币计的每日预算（以分为单位）

     • lifetime_budget：以账户货币计的总预算（以分为单位）

     • bid_strategy：竞价策略。必须为以下值之一：LOWEST_COST_WITHOUT_CAP、LOWEST_COST_WITH_BID_CAP、COST_CAP、LOWEST_COST_WITH_MIN_ROAS。

   • 返回：包含新广告系列详情的确认信息

   • 示例：

     {
       "name": "2025 - Bedroom Furniture - Awareness",
       "account_id": "act_123456789012345",
       "objective": "OUTCOME_AWARENESS",
       "special_ad_categories": [],
       "status": "PAUSED",
       "buying_type": "AUCTION",
       "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
       "daily_budget": 10000
     }
     

7. mcp_meta_ads_get_adsets

   • 获取 Meta Ads 账户的广告组，并可按广告系列筛选
   • 输入：
     • access_token（可选）：Meta API 访问令牌（若未提供，将使用缓存的令牌）
     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
     • limit：返回的广告组最大数量（默认值：10）
     • campaign_id：用于筛选的可选广告系列 ID
   • 返回：符合条件的广告组列表

8. mcp_meta_ads_get_adset_details

   • 获取指定广告组的详细信息
   • 输入：
     • access_token（可选）：Meta API 访问令牌（若未提供，将使用缓存的令牌）
     • adset_id：Meta Ads 广告组 ID
   • 返回：指定广告组的详细信息

9. mcp_meta_ads_create_adset

   • 在 Meta Ads 账户中创建新的广告组
   • 输入：
     • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
     • campaign_id：此广告组所属的 Meta Ads 广告系列 ID
     • name：广告组名称
     • status：广告组的初始状态（默认：PAUSED）
     • daily_budget：以账户货币计价的每日预算（以分为单位），字符串格式
     • lifetime_budget：以账户货币计价的总预算（以分为单位），字符串格式
     • targeting：定向规格（例如，年龄、位置、兴趣）
     • optimization_goal：转化优化目标（例如，'LINK_CLICKS'）
     • billing_event：计费方式（例如，'IMPRESSIONS'）
     • bid_amount：出价金额，以分为单位。LOWEST_COST_WITH_BID_CAP、COST_CAP、TARGET_COST 必填。
     • bid_strategy：出价策略（例如，'LOWEST_COST_WITHOUT_CAP'、'LOWEST_COST_WITH_MIN_ROAS'）
     • bid_constraints：出价约束字典。LOWEST_COST_WITH_MIN_ROAS 必填（例如，{"roas_average_floor": 20000}）
     • start_time、end_time：可选的开始/结束时间（ISO 8601）
     • access_token（可选）：Meta API 访问令牌
   • 返回：包含新广告组详情的确认信息

10. mcp_meta_ads_get_ads

    • 获取 Meta Ads 账户中的广告，可选择筛选条件
    • 输入：
      • access_token（可选）：Meta API 访问令牌（如果未提供，则使用缓存的令牌）
      • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
      • limit：要返回的广告数量上限（默认：10）
      • campaign_id：可选的筛选广告系列 ID
      • adset_id：可选的筛选广告组 ID
    • 返回：符合条件的广告列表

11. mcp_meta_ads_create_ad

    • 使用现有创意素材创建新广告
    • 输入：
      • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
      • name：广告名称
      • adset_id：此广告将投放到的广告组 ID
      • creative_id：要使用的现有创意素材 ID
      • status：广告的初始状态（默认：PAUSED）
      • bid_amount：可选的出价金额（以分为单位）
      • tracking_specs：可选的跟踪规格
      • access_token（可选）：Meta API 访问令牌
    • 返回：包含新广告详情的确认信息

12. mcp_meta_ads_get_ad_details

    • 获取特定广告的详细信息
    • 输入：
      • access_token（可选）：Meta API 访问令牌（如果未提供，则使用缓存的令牌）
      • ad_id：Meta Ads 广告 ID
    • 返回：指定广告的详细信息

13. mcp_meta_ads_get_ad_creatives

    • 获取特定广告的创意素材详情
    • 输入：
      • access_token（可选）：Meta API 访问令牌（如果未提供，则使用缓存的令牌）
      • ad_id：Meta Ads 广告 ID
    • 返回：创意素材详情，包括文本、图片和 URL

14. mcp_meta_ads_create_ad_creative

    • 使用已上传图片的哈希值创建新的广告创意素材
    • 输入：
      • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
      • name：创意素材名称
      • image_hash：已上传图片的哈希值
      • page_id：广告对应的 Facebook 公共主页 ID
      • link_url：目标 URL
      • message：广告文案/文本
      • headline：简单广告的单个标题（不能与 headlines 同时使用）
      • headlines：用于动态创意测试的标题列表（不能与 headline 同时使用）
      • description：简单广告的单个描述（不能与 descriptions 同时使用）
      • descriptions：用于动态创意测试的描述列表（不能与 description 同时使用）
      • dynamic_creative_spec：动态创意优化设置
      • call_to_action_type：CTA 按钮类型（例如，'LEARN_MORE'）
      • instagram_actor_id：可选的 Instagram 账户 ID
      • access_token（可选）：Meta API 访问令牌
    • 返回：包含新创意素材详情的确认信息

15. mcp_meta_ads_update_ad_creative

    • 使用新内容或设置更新现有广告创意
    • 输入：
      • creative_id：要更新的 Meta Ads 创意 ID
      • name：新的创意名称
      • message：新的广告文案／文本
      • headline：适用于简单广告的单个标题（不能与 headlines 同时使用）
      • headlines：用于动态创意测试的新标题列表（不能与 headline 同时使用）
      • description：适用于简单广告的单个描述（不能与 descriptions 同时使用）
      • descriptions：用于动态创意测试的新描述列表（不能与 description 同时使用）
      • dynamic_creative_spec：新的动态创意优化设置
      • call_to_action_type：新的行动号召按钮类型
      • access_token（可选）：Meta API 访问令牌（若未提供，则使用缓存的令牌）
    • 返回：包含已更新创意详情的确认信息

16. mcp_meta_ads_upload_ad_image

    • 上传图片，以便在 Meta Ads 创意中使用
    • 输入：
      • account_id：Meta Ads 账户 ID（格式：act_XXXXXXXXX）
      • image_path：要上传的图片文件路径
      • name：图片的可选名称
      • access_token（可选）：Meta API 访问令牌
    • 返回：包含图片详情（包括哈希值）的 JSON 响应

17. mcp_meta_ads_get_ad_image

    • 一步获取、下载并可视化 Meta 广告图片
    • 输入：
      • access_token（可选）：Meta API 访问令牌（若未提供，则使用缓存的令牌）
      • ad_id：Meta Ads 广告 ID
    • 返回：可直接进行视觉分析的广告图片

18. mcp_meta_ads_update_ad

    • 使用新设置更新广告
    • 输入：
      • ad_id：Meta Ads 广告 ID
      • status：更新广告状态（ACTIVE、PAUSED 等）
      • bid_amount：账户货币单位的出价金额（美元以美分为单位）
      • access_token（可选）：Meta API 访问令牌（若未提供，则使用缓存的令牌）
    • 返回：包含已更新广告详情和确认链接的确认信息

19. mcp_meta_ads_update_adset

    • 使用新设置更新广告组，包括频次上限
    • 输入：
      • adset_id：Meta Ads 广告组 ID
      • frequency_control_specs：频次控制规格列表
      • bid_strategy：出价策略（例如，'LOWEST_COST_WITH_BID_CAP'、'LOWEST_COST_WITH_MIN_ROAS'）
      • bid_amount：以美分为单位的出价金额。LOWEST_COST_WITH_BID_CAP、COST_CAP、TARGET_COST 必填。
      • bid_constraints：出价约束字典。LOWEST_COST_WITH_MIN_ROAS 必填（例如，{"roas_average_floor": 20000}）
      • status：更新广告组状态（ACTIVE、PAUSED 等）
      • targeting：定位规格，包括 targeting_automation
      • access_token（可选）：Meta API 访问令牌（若未提供，则使用缓存的令牌）
    • 返回：包含已更新广告组详情和确认链接的确认信息

20. mcp_meta_ads_get_insights

    • 获取广告系列、广告组、广告或账户的效果洞察
    • 输入：
      • access_token（可选）：Meta API 访问令牌（若未提供，则使用缓存的令牌）
      • object_id：广告系列、广告组、广告或账户的 ID
      • time_range：洞察的时间范围（默认值：最大范围）
      • breakdown：可选的细分维度（例如，年龄、性别、国家／地区）
      • level：聚合级别（广告、广告组、广告系列、账户）
      • action_attribution_windows（可选）：转化数据的归因窗口列表（例如，["1d_click", "1d_view", "7d_click", "7d_view"]）。指定后，actions 和 cost_per_action_type 会为每个窗口包含额外字段。'value' 字段始终显示 7d_click 归因结果。
    • 返回：指定对象的效果指标

21. mcp_meta_ads_get_login_link

    • 获取可点击的 Meta Ads 身份验证登录链接
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
    • 返回：指向 Meta 身份验证的可点击资源链接

22. mcp_meta_ads_create_budget_schedule

    • 为 Meta Ads 广告系列创建预算计划
    • 输入：
      • campaign_id：Meta Ads 广告系列 ID
      • budget_value：预算增加金额
      • budget_value_type：预算值类型（"ABSOLUTE" 或 "MULTIPLIER"）
      • time_start：高需求时段开始时间的 Unix 时间戳
      • time_end：高需求时段结束时间的 Unix 时间戳
      • access_token（可选）：Meta API 访问令牌
    • 返回：包含已创建预算计划 ID 的 JSON 字符串，或错误消息

23. mcp_meta_ads_search_interests

    • 按关键词搜索兴趣定向选项
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • query：兴趣搜索词（例如，"baseball"、"cooking"、"travel"）
      • limit：要返回的结果数上限（默认值：25）
    • 返回：包含 id、name、audience_size 和 path 字段的兴趣数据

24. mcp_meta_ads_get_interest_suggestions

    • 根据现有兴趣获取兴趣建议
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • interest_list：要获取建议的兴趣名称列表（例如，["Basketball", "Soccer"]）
      • limit：要返回的建议数上限（默认值：25）
    • 返回：包含 id、name、audience_size 和 description 字段的建议兴趣

25. mcp_meta_ads_validate_interests

    • 验证用于定向的兴趣名称或 ID
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • interest_list：要验证的兴趣名称列表（例如，["Japan", "Basketball"]）
      • interest_fbid_list：要验证的兴趣 ID 列表（例如，["6003700426513"]）
    • 返回：验证结果，显示每项兴趣的有效状态和 audience_size

26. mcp_meta_ads_search_behaviors

    • 获取所有可用的行为定向选项
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • limit：要返回的结果数上限（默认值：50）
    • 返回：包含 id、name、audience_size 范围、path 和 description 的行为定向选项

27. mcp_meta_ads_search_demographics

    • 获取人口统计定向选项
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • demographic_class：人口统计类型（'demographics'、'life_events'、'industries'、'income'、'family_statuses'、'user_device'、'user_os'）
      • limit：要返回的结果数上限（默认值：50）
    • 返回：包含 id、name、audience_size 范围、path 和 description 的人口统计定向选项

28. mcp_meta_ads_search_geo_locations

    • 搜索地理位置定向选项
    • 输入：
      • access_token（可选）：Meta API 访问令牌（未提供时将使用缓存的令牌）
      • query：位置搜索词（例如，"New York"、"California"、"Japan"）
      • location_types：要搜索的位置类型（['country', 'region', 'city', 'zip', 'geo_market', 'electoral_district']）
      • limit：要返回的结果数上限（默认值：25）
    • 返回：包含 key、name、type 和地理层级信息的位置数据

许可证

Meta Ads MCP 根据 Business Source License 1.1 授权，这意味着：

• ✅ 可免费用于个人和商业用途
• ✅ 可按需修改和自定义
• ✅ 可重新分发给他人
• ✅ 将于 2029 年 1 月 1 日完全开源（Apache 2.0）

唯一的限制是，您不能将其作为竞争性的托管服务提供。如有商业授权方面的问题，请联系我们。

隐私与安全

Meta Ads MCP 遵循安全最佳实践，提供安全的令牌管理和自动身份验证处理。

• 远程 MCP：所有身份验证都在云端安全处理，无需在本地存储令牌
• 本地安装：令牌会安全地缓存在您的本地计算机上

测试

基本测试

使用任意 MCP 客户端测试您的 Meta Ads MCP 连接：

1. 验证账户访问权限：让您的大模型调用 mcp_meta_ads_get_ad_accounts
2. 检查账户详情：使用 mcp_meta_ads_get_account_info 和您的账户 ID
3. 列出广告系列：尝试使用 mcp_meta_ads_get_campaigns 查看您的广告系列

有关详细的本地安装测试，请参阅源代码仓库。

故障排除

💡 快速解决：跳过技术设置！

避免任何设置问题的最简单方法是**🎯 改用我们的远程 MCP**。无需下载，无需配置——只需连接您的广告账户，即可立即获取有关广告系列的 AI 洞察！

本地安装问题

有关本地安装问题，请参阅源代码仓库。为获得最简单的使用体验，我们建议改用远程 MCP。