AI导哈

Meta广告管理服务

一个连接Claude Desktop与Meta Marketing API的MCP服务器，用于通过自然对话管理Facebook和Instagram广告活动、读取性能分析、创建活动并获取自动化报告。

  • by kibbar
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kibbar/meta-mcp-server

使用说明

元广告MCP服务器

将Claude Desktop连接到Meta Marketing API的MCP（模型上下文协议）服务器。通过与Claude的自然对话，管理您的Facebook和Instagram广告活动、阅读绩效分析、创建活动并获取自动报告。

你能做什么

  • 阅读分析：活动、广告集和广告级别性能指标
  • 创建活动：完整活动→ 广告集→ 广告创建工作流程
  • 管理活动：暂停/激活活动，更新预算
  • 受众洞察：按年龄、性别、国家、平台分列的业绩
  • 自动报告：每周绩效报告及建议
  • 广告文案：生成广告创意并将其直接推送到Meta

先决条件

1.元开发者帐户和应用程序

  1. 首选 面向开发人员的Meta
  2. 创建新应用程序→ 选择 “其他” → “商业” 类型
  3. 添加 API营销 将产品添加到您的应用程序
  4. 首选 应用设置→ Basic 并记下您的应用ID和应用密码

2.访问令牌

开发/测试：

  1. 首选 图形API资源管理器
  2. 选择您的应用程序
  3. 点击 “生成访问令牌”
  4. 添加权限： ads_management, ads_read, pages_read_engagement
  5. 复制令牌

对于生产（长期代币）：

  1. 将短期令牌替换为长期令牌：
curl -X GET "https://graph.facebook.com/v21.0/oauth/access_token?grant_type=fb_exchange_token&client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&fb_exchange_token=YOUR_SHORT_TOKEN"

3.广告账号ID

查找您的广告帐户ID:

  • 首选 广告管理器
  • 请查看URL： act_XXXXXXXXXX 是您的帐户ID
  • 或转到“业务设置”→ 广告账户

4.在应用程序中添加广告帐户

重要步骤 （经常错过）：

  1. 在Meta应用程序设置中，转到 高级设置
  2. 在...之下 广告账户，添加您的广告帐户ID
  3. 确保您的开发人员帐户上的电子邮件已添加到Business Manager中

安装

使用紫外线（推荐）

# Clone/download the project
cd meta-ads-mcp

# Create virtual environment and install
uv venv
source .venv/bin/activate   # macOS/Linux
# .venv\Scripts\activate    # Windows

uv pip install -e .

使用pip

cd meta-ads-mcp
pip install -e .

配置

1.设置环境变量

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

META_APP_ID=123456789
META_APP_SECRET=abc123def456
META_ACCESS_TOKEN=EAAxxxxxxx...
META_AD_ACCOUNT_ID=act_123456789

2.配置克劳德桌面

编辑您的Claude Desktop配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "meta-ads": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/meta-ads-mcp",
        "run",
        "meta-ads-mcp"
      ],
      "env": {
        "META_APP_ID": "your_app_id",
        "META_APP_SECRET": "your_app_secret",
        "META_ACCESS_TOKEN": "your_access_token",
        "META_AD_ACCOUNT_ID": "act_your_account_id"
      }
    }
  }
}

替代 （如果使用pip安装）：

{
  "mcpServers": {
    "meta-ads": {
      "command": "meta-ads-mcp",
      "env": {
        "META_APP_ID": "your_app_id",
        "META_APP_SECRET": "your_app_secret",
        "META_ACCESS_TOKEN": "your_access_token",
        "META_AD_ACCOUNT_ID": "act_your_account_id"
      }
    }
  }
}
  1. 重新启动克劳德桌面

使用示例

检查活动绩效

“显示我的Meta广告系列上周的表现” “在过去的30天里，哪场竞选的ROAS最好？” “按年龄段细分我的顶级竞选活动”

创建活动

“为Kibbar针对美国和印度的开发人员创建新的流量活动，预算为每天20美元” “使用此副本设置广告：[您的副本]指向kibbar.com”

管理活动

“暂停名为“夏季促销”的活动” “将我表现最佳的广告集的每日预算增加到50美元”

获取报告

“生成包含受众细分的每周绩效报告” “比较本周与上周的表现”

优化

“分析我的广告系列，告诉我在哪里浪费钱” “我应该根据CPA增加哪些广告集的预算？”

可用工具

工具 说明
get_campaign_performance 具有灵活日期范围的活动级别指标
get_adset_performance 广告系列中的广告集细分
get_ad_performance 个人广告级别性能数据
list_campaigns 列出所有具有状态筛选的活动
create_campaign 创建新活动
create_adset 创建具有定位功能的广告集
create_ad 用创意内容创建广告
update_status 暂停/激活/存档任何广告对象
update_budget 调整活动或广告集的预算
generate_performance_report 每日细分的综合报告
get_audience_breakdown 按人口统计/平台划分的受众洞察
upload_ad_image 上传广告创意图片

可用提示

提示 描述
analyze_campaign_performance 深入分析并提出优化建议
create_campaign_workflow 逐步指导活动创建
weekly_report 全面的每周绩效报告

安全说明

  • 永远不要承诺你的 .env 文件或访问令牌
  • 使用长期代币进行生产，但定期轮换
  • 默认情况下，服务器在PAUSED状态下创建活动（花钱前可以安全查看）
  • 所有写操作都需要显式参数——Claude不会意外修改内容

故障排除

“缺少Meta API凭据” → 检查是否在Claude Desktop配置中设置了所有4个环境变量

“OAuth访问令牌无效” → 您的令牌已过期。从Graph API资源管理器生成一个新的

“找不到广告帐户” → 确保您的帐户ID以开头 act_ 并在“高级设置”中添加到您的应用程序中

“权限被拒绝” → 检查您的令牌是否具有 ads_management 和 ads_read 权限

许可证

麻省理工学院

相关 MCP