SuperAPI AI 工具集

meta-ads-mcp

meta-ads-mcp 是一个面向 Meta 广告(Facebook/Instagram)的 Model Context Protocol(MCP)服务器,让 Claude、ChatGPT、Perplexity、Cursor 等 AI 助手通过自然对话端到端管理 Meta 广告:创建广告系列、上传创意素材、更新预算、分析投放表现。它由 Pipeboard 提供托管远程 MCP 服务,无需开发者令牌、无需自行部署,提供免费方案,并标注为 Meta Business Partner。该仓库是 Pipeboard 五平台 MCP 家族(Meta、Google、TikTok、Snap、Reddit)中的 Meta 节点,共 230+ 工具,共享同一套 OAuth、安全模型与 API 令牌。

访问官网

工具介绍

用途

meta-ads-mcp 是一个 Model Context Protocol(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+ 工具,共享同一套认证、同一套安全模型。

主要能力

  • 广告系列管理:通过对话创建广告系列、广告组和广告,更新预算,暂停与恢复,应用定向变更;每次写入操作都有明确确认。
  • 创意操作:上传图片、构建创意、更新文案、标题、描述和 CTA,无需离开 AI 客户端。
  • 动态创意测试:同一 API 同时支持简单广告(单一标题/描述)和完整 A/B 测试(多个标题/描述)。
  • AI 驱动的广告系列分析:让 LLM 分析投放表现并给出可执行洞察。
  • 策略建议:基于数据给出优化广告支出、定向和创意内容的建议。
  • 预算优化:给出将预算重新分配到表现更好的广告组的建议。
  • 创意改进:针对广告文案、图片和 CTA 提供反馈。
  • 自动化监控:让任意兼容 MCP 的 LLM 跟踪表现指标并在出现显著变化时提醒。
  • 跨平台集成:支持 Facebook、Instagram 及所有 Meta 广告位。
  • 通用 LLM 支持:兼容任何 MCP 客户端,包括 Claude Desktop、Cursor、Cherry Studio 等。
  • 增强搜索:通用搜索功能在查询提及“page”或“pages”时包含页面搜索。
  • 简单认证:通过安全 OAuth 轻松设置。
  • 跨平台支持:可在 Windows、macOS 和 Linux 上运行。

使用方式

远程 MCP(推荐)

官方推荐使用远程 MCP,无需技术设置,连接 Facebook Ads 账户后即可让 AI 分析广告系列。

Claude Pro/Max 用户:

  1. 前往 claude.ai/settings/integrations(需要 Claude Pro 或 Max)。
  2. 点击“Add Integration”,输入:
    • Name:“Pipeboard Meta Ads”(或任意名称)
    • Integration URL:https://meta-ads.mcp.pipeboard.co/
  3. 点击集成旁的“Connect”,按提示登录 Pipeboard 并连接 Facebook Ads 账户。

如需基于令牌的直接认证(跳过交互流程),在添加集成时使用带令牌的 URL 格式。令牌可在 pipeboard.co/api-tokens 获取。

Cursor 用户: 在 ~/.cursor/mcp.json 中添加配置。启用远程 MCP 后,点击“Needs login”完成登录。若不想走交互登录,可将 Pipeboard API 令牌直接包含在 URL 中。

其他 MCP 客户端: 使用远程 MCP URL:https://meta-ads.mcp.pipeboard.co/。支持基于令牌认证的客户端可将 Pipeboard API 令牌附加到 URL 后,从而跳过交互登录流程并立即认证。令牌在 pipeboard.co/api-tokens 获取。

Pipeboard CLI(MCP 的替代方案)

Pipeboard CLI 是一个单一 Go 二进制文件,将上述所有 MCP 工具暴露为类型化 shell 命令,面向偏好子进程调用而非 JSON-RPC 的 AI 编码代理(Claude Code、Cline、OpenClaw、Codex)和自动化脚本。特点:启动低于 50ms、每次调用无需 MCP 握手、五个平台集成在一个二进制文件中。完整文档见 pipeboard-cli 仓库。

本地安装(仅限高级技术用户)

官方强烈建议使用远程 MCP,因为更快、更可靠且无需技术设置。Meta Ads MCP 也支持本地 streamable HTTP 传输,可作为独立 HTTP API 运行,用于 Web 应用和自定义集成,详见 Streamable HTTP Setup Guide。本地安装需要自行创建 Meta Developer App。

可用 MCP 工具(部分)

  • mcp_meta_ads_get_ad_accounts:获取用户可访问的广告账户。输入:access_token(可选)、user_id(Meta 用户 ID 或“me”)、limit(默认 200)。
  • mcp_meta_ads_get_account_info:获取指定广告账户的详细信息。输入:access_token(可选)、account_id(格式 act_XXXXXXXXX)。
  • mcp_meta_ads_get_account_pages:获取与 Meta 广告账户关联的页面。输入:access_token(可选)、account_id(格式 act_XXXXXXXXX 或“me”)。
  • mcp_meta_ads_get_campaigns:获取广告系列并支持可选过滤。输入:access_token(可选)、account_id、limit(默认 10)、status_filter(空为全部,或 'ACTIVE'、'PAUSED' 等)。
  • mcp_meta_ads_get_campaign_details:获取指定广告系列的详细信息。输入:access_token(可选)、campaign_id。
  • mcp_meta_ads_create_campaign:在广告账户中创建新广告系列。输入包括 access_token(可选)、account_id、name、objective(基于结果的 ODAX 目标,必须为 OUTCOME_AWARENESS、OUTCOME_TRAFFIC、OUTCOME_ENGAGEMENT、OUTCOME_LEADS、OUTCOME_SALES、OUTCOME_APP_PROMOTION 之一;旧目标如 BRAND_AWARENESS、LINK_CLICKS、CONVERSIONS、APP_INSTALLS 等对新广告系列已无效,会导致 400 错误)、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 之一)。

适用场景

  • 营销人员通过对话快速创建、调整和优化 Meta 广告系列。
  • 需要跨 Meta、Google、TikTok、Snap、Reddit 多平台统一管理的团队。
  • 使用 AI 编码代理或自动化脚本进行广告操作的技术用户。
  • 希望让 LLM 自动监控广告表现并给出优化建议的场景。

限制与说明

  • 这是一个独立开源项目,使用 Meta 的公开 API。其背后的托管服务 Pipeboard 是标注的 Meta Business Partner,也是官方批准的 Meta 应用,可从一个登录管理 Meta、Google、TikTok、Snap 和 Reddit Ads(含免费方案)。
  • Meta、Facebook、Instagram 等 Meta 品牌名称是其各自所有者的商标。
  • 本地安装需要自行创建 Meta Developer App,官方推荐使用远程 MCP。
  • 关于具体收费、价格、平台覆盖细节等,资料中仅提及“免费方案”,其余暂未提供。