mcp-meta-ad-library-monitor

Meta 广告资料库监控 MCP 服务

一个通过 Meta Ad Library API 查找公司正在投放的 Facebook 和 Instagram 广告的 MCP 服务。它封装了 Apify 上的 Mamba Labs Meta Ad Library Monitor actor，并向任何 MCP 客户端返回可直接用于 Clay 的扁平 JSON 行。

内容

• 功能说明
• 快速开始
• 先决条件
• 提示词示例
• 输入
• 输出
• 输出示例
• 功能
• 定价
• 完整 actor 文档
• Mamba Labs GTM 套件
• 许可证

功能说明

提供公司名称或域名以及你自己的 Meta 访问令牌，它就会搜索 Meta Ad Library，并为每条广告返回一行扁平数据：创意文案、标题、投放日期、广告投放过的 Meta 平台，以及 Meta 上该广告渲染版本的永久快照 URL。

请先了解覆盖范围，因为这决定了这个工具是否适合你。它读取 Meta 的 Ad Library Graph API，这是 Meta 认可的唯一途径。该 API 发布两类广告：向欧盟受众投放的所有广告（无论广告内容是什么），以及全球范围内有关社会议题、选举和政治的广告。因此，欧盟地区占比较高的名单可以很好地覆盖普通商业广告，而美国或英国的普通产品广告名单大多会返回 not_found。这是 Meta 数据集本身的限制，并非查询出错；每一行都会附带覆盖范围说明，指出搜索可能查到的内容。展示量和花费数据仅适用于政治广告，并以区间形式提供，因此 null 并不表示花费为零。

所有搜索都通过 Apify 执行。此软件包只是一个轻量客户端，用于调用 actor 并原样返回结果。

快速开始

你需要 Node.js 18 或更高版本，以及一个拥有 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "mamba-meta-ad-library-monitor": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-meta-ad-library-monitor"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

在 https://console.apify.com/account/integrations 获取你的令牌，将其粘贴进去，然后重启 Claude Desktop。届时即可使用 find_meta_ads 工具。

你还需要自己的 Meta 应用访问令牌，可在 developers.facebook.com 免费创建。将其设为同一 env 块中的 META_ACCESS_TOKEN，以免令牌出现在聊天记录中；也可以在每次调用时将其作为 metaAccessToken 工具参数传入。如果两者都没有，工具会在启动任何 Apify 运行之前返回错误，因此缺少令牌不会产生费用。

前提条件

• Node.js 18 或更高版本
• 一个拥有 API 令牌的 Apify 账户
• 你自己的 Meta 应用访问令牌，可在 developers.facebook.com 免费创建。Ad Library API 不开放，因此必须提供令牌。
• 如果你想获取政治和议题广告数据，Meta 账户必须通过身份验证。这是 Meta 的要求，并非我们的要求。

示例提示词

• “gymshark.com 目前在欧盟投放 Facebook 广告吗？这是我的 Meta 令牌。”
• “显示这家公司面向欧盟受众投放的最近 25 条活跃广告。”
• “仅查找这家广告主的公开视频广告，包括活跃和非活跃广告。”
• “在英国的 Meta Ad Library 中搜索这个品牌，并告诉我覆盖范围说明写了什么。”

输入

• company_domain（可选）：不带其他内容的公司域名，例如 gymshark.com。未提供公司名称时，用于推导广告主搜索词；身份验证也会用它检查匹配的广告主页是否确实属于该公司。
• company_name（可选，但强烈建议提供）：Meta 广告主搜索是基于主页名称进行的模糊文本搜索，因此身份验证会将匹配的主页与公司名称进行比对。如果未提供，验证会改用域名主体，准确性较低。
• metaAccessToken（必填，除非已在服务环境中设置 META_ACCESS_TOKEN）：你自己的 Meta 应用访问令牌，可在 developers.facebook.com 免费创建。Ad Library API 不开放，因此未提供令牌时调用会返回错误，且不会启动运行。
• ad_reached_countries（可选）：要搜索哪些国家/地区的受众。可选值为 EU、GB、US、DE、FR、NL、ES、IT、IE 或 ALL_EU_PLUS_UK。Meta 要求提供此参数，未提供时请求会直接失败。欧盟地区的 Ad Library 覆盖所有广告，而不只是政治广告，因此默认使用该值。
• ad_active_status（可选）：ACTIVE、ALL 或 INACTIVE。默认值为 ACTIVE，因为当前正在投放的广告是购买意向的信号。若要查看创意历史或进行竞争分析，则应使用 ALL。
• ad_type（可选）：ALL 会返回 Ad Library 中这些国家/地区的所有广告。POLITICAL_AND_ISSUE_ADS 会将范围缩小到政治广告档案；该档案是唯一包含展示次数和支出数据的档案，且要求 Meta 账户通过身份验证。
• media_type（可选）：ALL、IMAGE、VIDEO、MEME 或 NONE。如果进行创意分析且只关注视频，此参数会很有用。
• maxAds（可选）：每家公司返回的广告行数。可选值为 10、25、50 或 100。这只是费用调节项，不会改变答案：无论是否达到上限，行中始终会报告匹配的广告数量。
• skipCache（可选）：设为 false（默认值）时，成功的查询会缓存 7 天并重复使用。设为 true 可强制重新获取数据。
• max_charge_usd（可选）：此次调用的支出上限，单位为美元。如果费用会使运行支出超过此金额，Actor 会在产生该费用前停止，并保留所有已付费获取的行。

输出

该工具会返回 Actor 的扁平 JSON 行，每条广告对应一行，采用 snake_case，不含嵌套对象。advertiser_match 会说明广告主页的匹配方式，advertisers_rejected 会统计被身份验证拒绝的主页数量。coverage_note 会说明搜索可能找到的内容，因此即使结果为空也易于理解。impressions 和 spend 仅适用于政治和议题广告。完整的输出架构请参阅 Apify Store 页面。

示例输出

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "gymshark.com",
  "company_name": "Gymshark",
  "page_id": "102590181603009",
  "page_name": "Gymshark Women",
  "advertiser_match": "name_match",
  "advertisers_rejected": 9,
  "ad_id": "2824771397896004",
  "ad_creative_body": "Hol dir die soften, leichten Gymsets fürs Training (und den chaotischen Alltag) ✨",
  "ad_creative_link_title": "Everyday Seamless ab 30 € 💸",
  "ad_creation_time": "2026-08-21",
  "ad_delivery_start_time": "2026-08-21",
  "ad_delivery_stop_time": null,
  "ad_snapshot_url": "https://www.facebook.com/ads/library/?id=2824771397896004",
  "publisher_platforms": "facebook, instagram, audience_network, messenger, threads",
  "languages": "de",
  "impressions": null,
  "spend": null,
  "currency": null,
  "ads_matched": 10,
  "coverage_note": "Searched EU audiences, where the Ad Library covers all ads, plus non EU audiences where it covers only political and issue ads. A commercial advertiser outside the EU is legitimately absent.",
  "coverage": 1,
  "fetch_status": "ok",
  "run_date": "2026-08-23T05:50:09.867Z"
}

功能

• 每条广告对应一行，包含创意文案、标题和投放日期
• 每条已展示广告对应一个 Meta 自有的永久快照 URL
• 广告投放过的 Meta 平台，记录在 publisher_platforms 中
• 读取 Meta 官方认可的 Ad Library Graph API，不使用其他途径
• 每行都附有覆盖范围说明，便于理解空结果
• 广告主身份验证关卡，并统计被拒绝的候选项

定价

你按 Apify 上的事件付费，费用计入你自己的 Apify 账户。以下价格来自实时定价记录，读取日期为 2026-10-16：

事件	每个事件的价格（USD）	触发时机
apify-actor-start	$0.00005	Actor 开始运行时收费。收费事件数量取决于 Actor 的内存（每 GB 一个事件，至少一个事件）。
advertiser-checked	Free 计划为 $0.004，较高的 Apify 计划低至 $0.0028	每家公司收费一次，前提是已搜索其 Ad Library 并生成了非降级结果，无论是否找到广告。没有广告的广告主仅触发此事件，不触发其他事件，因为搜索后没有找到内容也是一个有效答案，而且这正是你要求完成的工作。若某行已降级，即未执行搜索，则不会触发任何事件。
ad-returned	Free 计划为 $0.002，较高的 Apify 计划低至 $0.0014	身份验证关卡通过后，每实际返回一条广告收费一次。未通过验证关卡的页面所投放的广告不会返回，也不会收费：虽然已完成这项工作，但如实的结论是这些广告并不属于该公司。

该 Actor 的 Apify 页面列出了当前价格。运行此服务会消耗 Apify 额度。

Actor 完整文档

此服务是一个轻量客户端，不包含搜索逻辑。完整的输入和输出参考、定价及运行历史，请参阅 Apify Store 页面：

https://apify.com/mambalabs/meta-ad-library-monitor

---

Mamba Labs GTM Suite

此服务是 Mamba Labs GTM Suite MCP 服务之一。该套件中的每个 Actor 都接收一个域名或公司，并返回一行数据，因此可以直接放入同一个 Clay 表格，无需进行任何数据重整。此服务背后的 Actor 是 Meta Ad Library Monitor，其 Apify Actor ID J1GWlSXfSGU3u8Wng 不可更改。

由 Mamba Labs 构建 | npm | Apify Store

许可证

MIT

由 Mamba Labs 构建。https://apify.com/mambalabs