元数据广告MCP

Name: 元数据广告MCP
Author: pipeboard-co

作者：pipeboard-co361 星标更新：2025-11-04

安装使用来源：spider==github.com

项目介绍

Meta Ads MCP

一个用于与Meta Ads交互的模型上下文协议（MCP）服务器。通过AI界面分析、管理和优化Facebook、Instagram和其他Meta平台上的广告活动。使用大型语言模型（LLM）检索性能数据，可视化广告创意，并提供战略洞察。

免责声明： 这是一个非官方的第三方工具，与Meta没有关联、认可或隶属关系。该项目独立维护，并根据Meta的服务条款使用其公开API。Meta、Facebook、Instagram及其他Meta品牌名称均为各自所有者的商标。

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

社区和支持

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

开始使用远程MCP（推荐）

最快且最可靠的方式是**🚀 使用我们的Meta Ads远程MCP开始**。我们的云服务使用流式HTTP传输，以可靠、可扩展的方式访问Meta Ads数据。无需任何技术设置——只需连接并开始使用AI分析您的广告活动！

对于Claude Pro/Max用户

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

就这样！现在您可以要求Claude分析您的Meta广告活动，获取性能洞察，并管理您的广告。

高级：直接令牌认证（Claude）

如果您希望在不使用交互流程的情况下进行直接令牌认证，请使用以下URL格式添加集成：

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

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

对于Cursor用户

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

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

高级：直接令牌认证（Cursor）

如果您希望在不使用交互登录流程的情况下进行认证，可以直接在URL中包含您的Pipeboard API令牌：

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

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

对于其他MCP客户端

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

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

高级：直接令牌认证（其他客户端）

对于支持令牌认证的MCP客户端，可以在URL末尾追加您的Pipeboard API令牌：

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

这将绕过交互登录流程并立即进行认证。在pipeboard.co/api-tokens获取您的令牌。

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

🚀 我们强烈建议使用远程MCP——它更快、更可靠，且无需任何技术设置。

Meta Ads MCP还支持本地流式HTTP传输，允许您作为独立的HTTP API运行，适用于Web应用程序和自定义集成。请参阅**流式HTTP设置指南**获取完整说明。

功能

AI驱动的活动分析：让您的喜爱的LLM分析您的活动，并提供有关性能的操作性见解
策略建议：接收基于数据的建议，以优化广告支出、定位和创意内容
自动化监控：请求任何兼容MCP的LLM跟踪性能指标，并在出现重大变化时通知您
预算优化：获得重新分配预算至表现更好的广告集的建议
创意改进：收到关于广告文案、图像和行动号召的反馈
动态创意测试：简单广告（单个标题/描述）和高级A/B测试（多个标题/描述）的简易API
活动管理：请求更改活动、广告集和广告（所有更改均需明确确认）
跨平台集成：与Facebook、Instagram及所有Meta广告平台兼容
通用LLM支持：与任何MCP客户端兼容，包括Claude Desktop、Cursor、Cherry Studio等
增强搜索：通用搜索功能包括页面搜索，当查询提到“页面”或“页面”时
简单认证：通过安全的OAuth认证轻松设置
跨平台支持：适用于Windows、macOS和Linux

配置

远程MCP（推荐）

✨ 从这里开始使用远程MCP ——无需技术设置！只需连接您的Facebook Ads账户，即可开始请求AI分析您的活动。

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

对于需要自行托管的高级用户，可以从源代码安装该包。本地安装需要创建自己的Meta开发者应用。我们建议使用远程MCP以获得更简单的体验。

可用的MCP工具

mcp_meta_ads_get_ad_accounts
- 获取用户可访问的广告账户
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - user_id：Meta用户ID或当前用户的“me”
  - limit：返回的最大账户数（默认：200）
- 返回：带有详细信息的可访问广告账户列表
mcp_meta_ads_get_account_info
- 获取特定广告账户的详细信息
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - account_id：Meta Ads账户ID（格式：act_XXXXXXXXX）
- 返回：指定账户的详细信息
mcp_meta_ads_get_account_pages
- 获取与Meta Ads账户关联的页面
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - account_id：Meta Ads账户ID（格式：act_XXXXXXXXX）或当前用户的“me”的页面
- 返回：与账户关联的页面列表，可用于广告创建和管理
mcp_meta_ads_get_campaigns
- 获取Meta Ads账户中的活动，可选过滤
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - account_id：Meta Ads账户ID（格式：act_XXXXXXXXX）
  - limit：返回的最大活动数（默认：10）
  - status_filter：按状态过滤（空表示全部，或'ACTIVE'、'PAUSED'等）
- 返回：符合标准的活动列表
mcp_meta_ads_get_campaign_details
- 获取特定活动的详细信息
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - campaign_id：Meta Ads活动ID
- 返回：指定活动的详细信息
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 - 卧室家具 - 意识",
  "account_id": "act_123456789012345",
  "objective": "OUTCOME_AWARENESS",
  "special_ad_categories": [],
  "status": "PAUSED",
  "buying_type": "AUCTION",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
  "daily_budget": 10000
}
```
mcp_meta_ads_get_adsets
- 获取Meta Ads账户中的广告组，可选按活动过滤
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - account_id：Meta Ads账户ID（格式：act_XXXXXXXXX）
  - limit：返回的最大广告组数（默认：10）
  - campaign_id：可选的活动ID用于过滤
- 返回：符合标准的广告组列表
mcp_meta_ads_get_adset_details
- 获取特定广告组的详细信息
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - adset_id：Meta Ads广告组ID
- 返回：指定广告组的详细信息
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：账户货币中的出价金额（以分为单位）
  - bid_strategy：出价策略（例如'LOWEST_COST'）
  - start_time、end_time：可选的开始/结束时间（ISO 8601）
  - access_token（可选）：Meta API访问令牌
- 返回：带有新广告组详细信息的确认
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用于过滤
- 返回：符合标准的广告列表
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访问令牌
- 返回：带有新广告详细信息的确认
mcp_meta_ads_get_ad_details
- 获取特定广告的详细信息
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - ad_id：Meta Ads广告ID
- 返回：指定广告的详细信息
mcp_meta_ads_get_ad_creatives
- 获取特定广告的创意详情
- 输入：
  - access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌）
  - ad_id：Meta Ads广告ID
- 返回：创意详情，包括文本、图像和URL
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：动态创意测试的标题列表（不能与标题一起使用）
  - description：简单广告的单一描述（不能与描述一起使用）
  - descriptions：动态创意测试的描述列表（不能与描述一起使用）
  - dynamic_creative_spec：动态创意优化设置
  - call_to_action_type：CTA按钮类型（例如'LEARN_MORE'）
  - instagram_actor_id：可选的Instagram账户ID
  - access_token（可选）：Meta API访问令牌
- 返回：带有新创意详细信息的确认
mcp_meta_ads_update_ad_creative - 更新现有广告创意的新内容或设置 - 输入：
- creative_id：要更新的Meta Ads创意ID
- name：新的创意名称
- message：新的广告文案/文本
- headline：简单广告的单一标题（不能与标题一起使用）
- headlines：动态创意测试的新标题列表（不能与标题一起使用）
- description：简单广告的单一描述（不能与描述一起使用）
- descriptions：动态创意测试的新描述列表（不能与描述一起使用）
- dynamic_creative_spec：新的动态创意优化设置
- call_to_action_type：新的CTA按钮类型
- access_token（可选）：Meta API访问令牌（如果未提供，则使用缓存的令牌） - 返回：带有更新创意详细信息的确认
mcp_meta_ads_upload_ad_image
- 上传要在Meta Ads创意中使用的图像
- 输入：
  - account_id：Meta Ads账户ID（格式：act_XXXXXXXXX）
  - image_path：要上传的图像文件路径
  - name：图像的可选名称
  - access_token（可选）：Meta API访问令牌
- 返回：带有图像详细信息的JSON响应，包括哈希
`