用途
Facebook Ads Library MCP Server 是一个 MCP（Model Context Protocol）服务器，用于让 AI 代理查询 Facebook 公开广告库数据，并分析广告素材。它面向营销分析场景，支持获取品牌当前投放的广告，并借助 AI 对广告图片和视频进行解读。
主要能力
品牌搜索
通过 get_meta_platform_id 工具，将品牌名称转换为 Meta 平台 ID。支持单个品牌名或品牌名数组批量转换。
广告检索
get_meta_ads 工具根据一个或多个平台 ID 获取当前正在投放的广告，返回广告 ID、广告文案、快照链接以及图片和视频资源地址。
图片分析
analyze_ad_image 工具分析广告图片中的视觉元素，输出颜色、构图、文字、人物、情绪等维度的分析结果。
视频分析
analyze_ad_video 工具使用 Gemini AI 对单个视频广告进行综合分析，涵盖节奏、叙事、品牌信息传达、视觉手法和策略洞察。
批量视频分析
analyze_ad_videos_batch 工具在一次 API 调用中分析多个视频，文档称约节省 88% token，并附带对比洞察。
缓存管理
- get_cache_stats：返回缓存媒体的统计信息（总条数、图片数、视频数、总大小、最早缓存时间）。
- search_cached_media：按品牌、颜色、是否含人物、媒体类型等条件搜索已分析过的媒体。
- cleanup_media_cache：按天数清理旧缓存文件。
额度管理
自动检测 ScrapeCreators API 额度耗尽情况，额度恢复后服务器自动继续工作。
使用方式
安装
一键安装： git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git cd facebook-ads-library-mcp ./install.sh # macOS/Linux 或 install.bat # Windows
手动安装： git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git cd facebook-ads-library-mcp python3 -m venv venv ./venv/bin/pip install -r requirements.txt cp .env.template .env
编辑 .env 填入 SCRAPECREATORS_API_KEY 及可选的 GEMINI_API_KEY
MCP 配置
在 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 mcp.json 中配置： { "mcpServers": { "fb_ad_library": { "command": "/full/path/to/facebook-ads-library-mcp/venv/bin/python", "args": ["/full/path/to/facebook-ads-library-mcp/mcp_server.py"] } } }
API 密钥
- ScrapeCreators API（必需）：在 scrapecreators.com 注册获取。
- Google Gemini API（可选，用于视频分析）：在 Google AI Studio 获取。 密钥存储于 .env 文件中的 SCRAPECREATORS_API_KEY 和 GEMINI_API_KEY。
环境变量
除上述密钥外，还支持缓存配置（默认值）： CACHE_DIR=./cache MAX_CACHE_SIZE_MB=1000 CACHE_EXPIRY_DAYS=30
典型工作流
单品牌分析：先获取平台 ID，再获取广告，然后分析首条视频广告。 多品牌竞品分析：批量获取多个品牌的平台 ID 和广告，收集视频 URL 后批量分析，大幅节省 token。 筛选与搜索：按品牌、颜色、是否含人物等条件搜索已缓存的媒体分析结果。
适用场景
- 竞品广告监测与投放策略对比
- 多品牌广告素材批量分析
- 广告图片视觉元素筛选（如按主色调、是否含人物过滤）
- 视频广告创意与叙事策略研究
- 与 LangChain 或自定义 Python 脚本集成
限制
- 广告数据依赖 ScrapeCreators API，需注册并消耗额度，额度耗尽时服务中断。
- 视频分析依赖 Google Gemini API，未配置时该功能不可用。
- 存在 API 限流，建议间隔大批量请求或使用批量操作。
- 视频文件大小受 Gemini 限制，且视频 URL 需可访问。
- 缓存数据可能过期，需手动清理。
- 具体收费、价格信息暂未提供。