Meta Ads MCP

产品定位

Meta Ads MCP 是一个用于与 Meta Ads API 交互的工具，旨在通过标准化接口帮助 AI 模型访问、分析和优化 Meta 平台的广告活动。

核心功能

• AI 驱动的广告分析：让 LLM 分析广告活动并提供可操作的性能洞察
• 战略建议：提供基于数据的广告支出、定位和创意内容优化建议
• 自动化监控：跟踪性能指标并在显著变化时发出警报
• 预算优化：重新分配预算到表现更好的广告组
• 创意改进：提供广告文案、图像和行动号召的反馈
• 广告活动管理：请求更改广告活动、广告组和广告（所有更改需要明确确认）
• 跨平台集成：支持 Facebook、Instagram 和所有 Meta 广告平台
• 通用 LLM 支持：兼容任何 MCP 客户端
• 简单认证：通过 OAuth 认证简化设置
• 跨平台支持：支持 Windows、macOS 和 Linux

适用场景

• 广告性能分析与优化
• 广告预算管理与分配
• 广告创意评估与改进
• 跨平台广告活动管理

工具列表

1. mcp_meta_ads_get_ad_accounts：获取用户可访问的广告账户
2. mcp_meta_ads_get_account_info：获取特定广告账户的详细信息
3. mcp_meta_ads_get_campaigns：获取广告账户的广告活动
4. mcp_meta_ads_get_campaign_details：获取特定广告活动的详细信息
5. mcp_meta_ads_create_campaign：创建新的广告活动
6. mcp_meta_ads_get_adsets：获取广告账户的广告组
7. mcp_meta_ads_get_adset_details：获取特定广告组的详细信息
8. mcp_meta_ads_get_ads：获取广告账户的广告
9. mcp_meta_ads_get_ad_details：获取特定广告的详细信息
10. mcp_meta_ads_get_ad_creatives：获取广告的创意详情
11. mcp_meta_ads_get_ad_image：获取、下载和可视化广告图像
12. mcp_meta_ads_update_ad：更新广告设置
13. mcp_meta_ads_update_adset：更新广告组设置
14. mcp_meta_ads_get_insights：获取广告活动、广告组或广告的性能洞察
15. mcp_meta_ads_debug_image_download：调试图像下载问题
16. mcp_meta_ads_get_login_link：获取 Meta Ads 认证的登录链接

常见问题解答

认证问题

• 推荐使用 Pipeboard 认证：设置 PIPEBOARD_API_TOKEN 环境变量并重试
• App ID 问题：确保正确设置了 Meta 开发者应用，并验证传递的 App ID

API 错误

• 验证应用是否添加了 Marketing API 产品
• 确保用户对广告账户有适当的权限
• 检查应用是否有速率限制或其他限制

使用教程

使用依赖

无特定安装依赖，推荐使用 uv 工具直接运行。

安装教程

使用 uv（推荐）

# 使用 Pipeboard 认证
export PIPEBOARD_API_TOKEN=your_pipeboard_token
uvx meta-ads-mcp

# 使用直接 Meta 认证
uvx meta-ads-mcp --app-id YOUR_META_ADS_APP_ID

# 安装包
uv pip install meta-ads-mcp

使用 pip

pip install meta-ads-mcp

# 运行
# 使用 Pipeboard 认证
export PIPEBOARD_API_TOKEN=your_pipeboard_token
python -m meta_ads_mcp

# 使用直接 Meta 认证
python -m meta_ads_mcp --app-id YOUR_META_ADS_APP_ID

调试方式

# 检查日志文件位置
# macOS: ~/Library/Application Support/meta-ads-mcp/meta_ads_debug.log
# Windows: %APPDATA%\meta-ads-mcp\meta_ads_debug.log
# Linux: ~/.config/meta-ads-mcp/meta_ads_debug.log

# 调试图像下载问题
mcp_meta_ads_debug_image_download(ad_id="your_ad_id")

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。