Facebook Ads Library Mcp

Facebook Ads Library MCP 服务

Proxy（useproxy.dev）是免费的托管式广告库 MCP 服务。 只需建立一个连接，ChatGPT、Claude、Cursor 和任何 MCP 客户端即可获取 Meta、Google、LinkedIn 和 TikTok（欧盟）广告库中的实时广告，无需 API 密钥，每天可免费使用 20 个额度。本仓库是开源、可自托管的 Facebook Ads Library 服务。2 分钟内使用托管版本 →

这是一个用于 Facebook Ads Library 的 Model Context Protocol（MCP）服务。

借助它，你可以搜索 Facebook 的公开广告库，查找任何公司或品牌，查看他们当前投放的广告并分析其广告策略。你可以分析广告图片和文本、深入分析视频广告、比较不同公司的策略，并了解哪些广告系列效果显著。

以下是在 Claude 中连接后可以实现的操作示例。

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

---

托管版本（推荐）

使用 Facebook Ads Library MCP 最简单的方式是采用 Proxy（useproxy.dev） 提供的托管版本。 无需 API 密钥、无需 Gemini 密钥、无需 Python，也无需运行服务——只需连接即可开始查询。

• ⚡ 零配置 — 无需安装、配置或维护
• 🔑 无需 API 密钥 — 完全跳过 ScrapeCreators 和 Gemini 密钥
• 🔌 随处可用 — 支持 ChatGPT、Claude、Cursor、Manus 以及任何支持 MCP 的平台
• 🚀 始终保持最新 — 新工具和修复会自动发布

👉 在 useproxy.dev 免费开始使用 →

更希望自行运行？下文提供了完整的可自托管设置说明。

托管版与自托管版

	托管版 — Proxy（useproxy.dev）	自托管版
设置时间	无 — 连接即可使用	Python 环境 + 配置
是否需要 API 密钥	无	ScrapeCreators + Gemini
基础设施	完全托管	由你运行和维护
更新	自动	手动执行 git pull
支持 ChatGPT、Claude、Cursor、Manus	✅	✅
适用对象	只想获取数据的大多数用户	希望自定义代码的开发者

对于大多数人来说，托管版本是最快捷的选择。如果你确实想自行修改或扩展服务，请选择自托管版。

---

示例提示词

单个品牌分析

How many ads is 'AnthropicAI' running? What's their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.

批量分析（新功能！）

Compare the current advertising strategies across Nike, Adidas, and Under Armour. Show me their ad volumes, messaging themes, and creative approaches.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

Analyze the holiday campaign strategies for Coca-Cola, Pepsi, Dr Pepper, and Sprite. What themes are they using?

Get the current ads for all major streaming services: Netflix, Disney+, Hulu, HBO Max, Amazon Prime Video, and Apple TV+. Compare their positioning strategies.

---

安装

先决条件

• Python 3.12+
• Anthropic Claude 桌面应用（或 Cursor）
• Pip（Python 包管理器），使用 python -m pip install 安装
• 广告数据提供商的 API 密钥，设置为 SCRAPECREATORS_API_KEY（请参阅下文的配置说明）
• Google Gemini API 密钥，用于视频分析（可选，仅分析视频广告时需要）

不想处理 API 密钥？请参阅上文的托管版本，即可完全跳过设置。

快速安装（推荐）

1. 克隆并运行安装脚本

 git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
 cd facebook-ads-library-mcp

 # For macOS/Linux:
 ./install.sh

 # For Windows:
 install.bat

安装脚本将：

• 创建虚拟环境，以隔离依赖项
• 安装所有必需的依赖项
• 设置配置文件

2. 配置 API 密钥 编辑创建的 .env 文件并添加 API 密钥：

• 将广告数据 API 密钥设置为 SCRAPECREATORS_API_KEY
• 在 Google AI Studio 获取 Gemini API 密钥（可选，用于视频分析）

3. 按照显示的 MCP 配置进行操作 安装脚本将显示要添加到 Claude Desktop 或 Cursor 的确切配置。

手动安装

如果你更喜欢手动安装：

1. 克隆此代码库

 git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
 cd facebook-ads-library-mcp

2. 创建虚拟环境并安装依赖项

 python3 -m venv venv
 ./venv/bin/pip install -r requirements.txt

3. 配置 API 密钥 复制模板并配置 API 密钥： 获取 API 密钥：

• 在 .env 文件中将广告数据 API 密钥设置为 SCRAPECREATORS_API_KEY
• 在此处获取 Google Gemini API 密钥（可选，用于视频分析）

4. 连接到 MCP 服务 将 MCP 服务配置添加到 Claude Desktop 或 Cursor 配置中： 将 {{PATH_TO_PROJECT}} 替换为克隆此代码库所在位置的完整路径。 **注意：**该配置使用虚拟环境中的 Python 解释器（venv/bin/python），以获得更好的依赖项隔离和可靠性。 **注意：**API 密钥现在会自动从 .env 文件加载，因此无需将其作为命令行参数传入。 对于 Claude Desktop： 将其保存为 claude_desktop_config.json，放在 Claude Desktop 配置目录中： 对于 Cursor： 将其保存为 mcp.json，放在 Cursor 配置目录中：
5. 重启 Claude Desktop / Cursor 打开 Claude Desktop，现在应该能看到 Facebook Ads Library，作为可用的集成。 或者重启 Cursor。

---

技术详情

1. Claude 向 Python MCP 服务发送请求
2. MCP 服务会智能地批量处理并优化对广告数据 API 的查询
3. 智能缓存可减少重复的 API 调用并提升性能
4. 信用额度监控通过主动错误处理避免工作流中断
5. 数据会沿着链路返回给 Claude，并附带增强的批次信息

可用的 MCP 工具（增强版）

此 MCP 服务提供了用于与 Facebook Ads 库对象交互的工具：

工具名称	描述	批处理支持
get_meta_platform_id	根据一个或多个品牌名称返回平台 ID	✅ 多个品牌
get_meta_ads	获取特定主页（平台 ID）的广告	✅ 多个平台 ID
analyze_ad_image	分析广告图片中的视觉元素、文本、颜色和构图	⚡ 增强缓存
analyze_ad_video	使用 Gemini AI 分析单个广告视频，提供全面的见解	⚡ 增强缓存
analyze_ad_videos_batch	全新 - 在单次 API 调用中分析多个视频，以提高令牌使用效率	🎬 约节省 88% 的令牌
get_cache_stats	获取已缓存媒体（图片和视频）的统计信息及存储用量	-
search_cached_media	按品牌、颜色、人物或媒体类型搜索之前分析过的媒体	-
cleanup_media_cache	清理旧的缓存媒体文件以释放磁盘空间	-

---

故障排除

常见问题

🆕 API 额度已用尽：

• 如果看到“API 额度已用尽”的消息，需要为账户充值
• 错误消息中包含指向服务提供商控制面板的直接链接
• 你可以在那里查看当前额度余额并购买更多额度
• 额度可用后，服务将自动恢复运行

🆕 超出速率限制：

• 如果触发速率限制，服务会告知需要等待多久
• 批量操作有助于降低触发速率限制的概率
• 如果经常触发限制，请考虑错开大型批量请求的时间

找不到 API 密钥错误：

• 确保 .env 文件位于项目根目录
• 如果没有 .env 文件，请从模板复制：cp .env.template .env
• 检查 API 密钥的格式是否正确，且没有引号
• 确认 .env 文件中包含 SCRAPECREATORS_API_KEY=your_key_here
• 对于视频分析，还要确保添加了 GEMINI_API_KEY=your_key_here

视频分析无法运行：

• 确认 .env 文件中包含有效的 Google Gemini API 密钥
• 视频分析需要 GEMINI_API_KEY 环境变量

MCP 服务连接问题：

• 确认 MCP 配置中的路径指向正确位置
• 确保已创建虚拟环境，并使用 python3 -m venv venv && ./venv/bin/pip install -r requirements.txt 安装依赖项
• 确保 MCP 配置使用虚拟环境中的 Python 路径（以 /venv/bin/python 结尾）
• 更改配置后，重启 Claude Desktop/Cursor

如需进一步排查 Claude Desktop 集成问题，请参阅 MCP 文档。文档中提供了查看日志和解决常见问题的实用建议。

---

常见问题解答

使用 Facebook Ads Library MCP 最简单的方法是什么？ 最简单的方法是使用 Proxy (useproxy.dev) 提供的托管版本。它无需 API 密钥、无需安装，也无需服务端——连接到 ChatGPT、Claude、Cursor 或任何 MCP 客户端后，即可立即开始查询。你可以免费开始使用。

使用此 MCP 需要 API 密钥吗？ 只有自托管时才需要。useproxy.dev 上的托管版本会为你处理所有数据访问，因此不需要 ScrapeCreators 或 Gemini 密钥。自托管需要 SCRAPECREATORS_API_KEY（视频分析还需要 Gemini 密钥）。

它支持哪些 MCP 客户端？ 托管版和自托管版都支持 ChatGPT、Claude（桌面版和网页版）、Cursor、Manus，以及任何其他支持 Model Context Protocol 的客户端。

有免费版本吗？ 有——Proxy 提供的托管版本提供免费套餐，你无需进行任何设置即可开始分析广告。

应该自托管还是使用托管版本？ 如果你只想快速、可靠地访问 Facebook Ads Library 数据，且无需维护，请使用托管版本——这适合大多数用户。只有在你想自行修改或扩展服务代码时，才选择自托管。

---

反馈

非常欢迎你提供反馈。请告诉我们你希望接下来看到列表中的哪些功能，或提出全新的功能需求。

---

相关项目

• Proxy 托管版 MCP：在一个托管服务中整合四大广告资料库，支持 OAuth，无需密钥
• Google Ads Library MCP（自托管）
• LinkedIn Ads Library MCP（自托管）
• TikTok Ads Library MCP（自托管）
• 适用于所有客户端的安装指南

---

许可证

本项目采用 MIT 许可证。

---

由 Proxy 团队倾心打造。