README
🚀 脸书广告库MCP服务器
这是一个用于脸书广告库的模型上下文协议(MCP)服务器。借助它,你可以在脸书的公共广告库中搜索任何公司或品牌,了解它们当前正在投放的广告,并对其广告进行分析。你可以分析广告图片或文本、获取视频链接、比较不同公司的广告策略,还能深入了解它们的广告活动中哪些策略行之有效。
以下是该服务器与Claude连接后的使用示例:
若想获取此项目及其他相关项目的更新信息,请在此输入你的邮箱
🚀 快速开始
示例提示
'AnthropicAI'正在投放多少条广告?这些广告在视频和图片形式上的分布情况如何?
'AnthropicAI'目前在广告中使用了哪些宣传话术?
对'AnthropicAI'、'Perplexity AI'和'OpenAI'的广告宣传话术进行深入比较,并给出一个便于转发的总结。
不想处理代码?试试我们的无代码版本
📦 安装指南
前提条件
- Python 3.12 及以上版本
- Anthropic Claude桌面应用程序(或Cursor)
- Pip(Python包管理器),可使用
python -m pip install进行安装 - Scrape Creators 的访问令牌
安装步骤
- 克隆此仓库
git clone https://github.com/trypeggy/facebook-ads-library-mcp.git cd facebook-ads-library-mcp - 从Scrape Creators获取API令牌 在此注册
- 连接到MCP服务器
复制以下JSON文件,并填入适当的
{{PATH}}值和{{API KEY}}:对于Claude桌面应用程序: 将此文件保存为{ "mcpServers": { "fb_ad_library": { "command": "python", "args": [ "{{PATH_TO_SRC}}/fb_ad_library_mcp/src/mcp_server.py", "--scrapecreators-api-key", "{{YOUR_SCRAPECREATORS_API_KEY}}" ] } } }claude_desktop_config.json,并放置在Claude桌面应用程序的配置目录中:
对于Cursor: 将此文件保存为~/Library/Application Support/Claude/claude_desktop_config.jsonmcp.json,并放置在Cursor的配置目录中:~/.cursor/mcp.json - 重启Claude桌面应用程序 / Cursor 打开Claude桌面应用程序,你应该能看到脸书广告库已作为可用的集成选项。或者重启Cursor。
🔧 技术细节
- Claude向Python MCP服务器发送请求。
- MCP服务器通过工具查询ScrapeCreator API。
- 数据通过链路返回给Claude。
可用的MCP工具
此MCP服务器提供了与脸书广告库对象进行交互的工具:
| 工具名称 | 描述 |
| ---------------------- | -------------------------------------------------- |
| get_meta_platform_id | 根据一个或多个品牌名称返回平台ID |
| get_meta_ads | 检索特定页面(平台ID)的广告 |
❓ 故障排除
如需对Claude桌面应用程序的集成进行额外的故障排除,请参阅 MCP文档。该文档包含了检查日志和解决常见问题的有用提示。
💬 反馈
我们非常感谢你的反馈。请告诉我们你希望接下来看到列表中的哪些功能,或者提出全新的功能需求。
📄 许可证
本项目采用MIT许可证。
微信扫一扫