meta-ads-mcp 是一个 MCP 服务器，用于连接 Meta Marketing API，帮助用户管理 Facebook 和 Instagram 广告。根据资料，该项目当前对应 Meta Marketing API v26.0，提供 134 个工具（标题中亦提及 v25.0 与 135 个工具）。
用途
该 MCP 适用于以下典型任务：
- 创建 Facebook 广告系列：使用 create_campaign、create_adset、create_ad、create_creative 构建完整漏斗。
- 查看广告表现：使用 get_account_insights 或 get_campaign_insights，并指定日期范围（如今天）。
- 暂停表现不佳的广告系列：通过 list_campaigns 与 get_campaign_insights 找出 ROAS 低于 2 的广告系列，再用 update_campaign 暂停。
- 设置 A/B 测试：使用 create_experiment 在广告组之间进行受控测试。
- 创建类似受众：使用 create_custom_audience、add_users_to_audience，然后 create_lookalike_audience。
- 上传广告图片并创建轮播广告：对每张图片使用 upload_image，再用 create_creative 以轮播格式创建。
- 获取详细表现报告：对大日期范围使用 create_async_report，再用 get_async_report 获取结果。
- 搜索 Facebook 广告库中的竞争对手广告：使用 search_ad_library 查找公开广告数据。
- 设置自动化规则：使用 create_rule 设定条件（如 CPA > 阈值）来暂停表现不佳的广告。
- 管理商品目录用于动态广告：使用 create_catalog、create_feed、upload_feed 设置动态商品广告。
主要能力
资料中列出的工具类别与数量如下（部分类别未列出具体工具名）：
- 广告系列管理（25 个工具）
- 媒体资产（12 个工具）
- 受众与定位（16 个工具）
- 洞察与报告（6 个工具）
- 目录与商务（17 个工具）
- 自动化与规则（5 个工具）
- 实验（5 个工具）
- 转化（4 个工具）
- 预算与规划（8 个工具）
- 品牌安全（5 个工具）
- 账户与业务（15 个工具）
- 认证与令牌（3 个工具）
使用方式
- 通过环境变量进行配置（具体变量名未在资料中提供）。
- 需要 Meta 访问令牌，并授予对应工具所需的权限（具体权限列表未在资料中完整提供）。
- 日期预设值使用小写 Graph API 标识符，例如 today、yesterday、last_7d、last_30d。
- create_async_report 始终创建异步任务；get_async_report 立即返回状态，并在状态变为 Job Completed 后默认获取分页结果边缘。
版本更新要点（v1.5.0）
- 转化工具会验证现有的事件 JSON 输入，并将其作为必需的数据数组发送。可使用 test_event_code 在 Events Manager 中验证接收情况；线下事件使用数据集 ID，门店事件使用 action_source=physical_store。
- 创意创建接受顶层 destination_spec、wamo_whatsapp_identity_spec 和 degrees_of_freedom_spec JSON 对象。动态创意还接受用于主页身份的 object_story_spec。若要退出 v26 的 Shops 目标默认设置，可将 destination_spec 设置为 {"destination_type":"WEBSITE_AND_SHOP_OPT_OUT"}。
- 自 v1.4.1 起包含完整的异步报告结果获取、令牌扩展以及预算计划修复。
- 部分详细洞察细分需要 Ads Manager 选择加入；空响应不一定表示零表现。
限制
- 部分详细洞察细分需要 Ads Manager 选择加入，空响应不一定表示零表现。
- 资料未提供具体环境变量名称、完整权限列表、安装命令、定价或平台限制等信息。
