Facebook Ads MCP Server

Facebook Ads MCP Server

🇨🇿 捷克语版本

可直接通过 Claude AI 管理 Facebook 广告的 MCP 服务。无需手动寻找令牌——只需登录一次 Facebook 即可。

功能

• 广告系列管理（创建、更新、删除）
• 广告组和单条广告
• 分析和洞察
• 自定义受众和类似受众
• 公共主页帖子
• 自动管理令牌（公共主页令牌永久有效）

安装

要求

• Node.js 18+
• Claude Desktop

1. 克隆代码仓库

git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook
npm install
npm run build

2. 添加到 Claude Desktop

打开 Claude Desktop 配置文件：

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加：

{
  "mcpServers": {
    "facebook-ads": {
      "command": "node",
      "args": ["/PATH/TO/MCP-Facebook/dist/index.js"]
    }
  }
}

3. 首次运行 — 5 分钟设置

首次启动时，向导会引导你创建自己的 Facebook App：

Steps:
  1. Click "Create App"
  2. Choose type: "Business"
  3. Enter any name (e.g. "My Ads")
  4. After creation, go to Settings → Basic
  5. Copy the App ID and App Secret
  6. Add the "Facebook Login" product and set:
     Valid OAuth Redirect URIs: http://localhost:3456/auth/callback
  7. In Basic settings, add "localhost" to App Domains

输入 App ID 和 Secret 后，浏览器会自动打开 → 登录 Facebook → 完成。

重新登录 / 添加公共主页

node dist/index.js login

在 Claude 中使用

"Show my active campaigns"
"Create a campaign for MyBrand with a $20 daily budget"
"How did my ads perform last month?"
"Post an update to page XY"

可用工具

工具	描述
connect_facebook_account / set_facebook_token	通过 OAuth 登录 / 存储从 Graph API Explorer 获取的令牌
list_connected_accounts / set_active_account	显示已连接的主页和账户 / 切换当前活动账户
facebook_setup_help	分步连接指南
get_campaigns	列出广告系列
create_campaign	创建新的广告系列
update_campaign	更新广告系列（包括 bidStrategy）——写入后读取
get_campaign_details	广告系列详情（预算、bid_strategy、今日支出）
delete_campaign	删除广告系列
get_campaign_insights	广告系列分析
get_adset_insights / get_ad_insights	广告组 / 广告级别分析
get_adsets	列出广告组
create_ad_set	创建广告组（包括潜在客户字段 promotedObject / destinationType）
update_adset	更新广告组（名称 / 状态）——实际写入并在写入后验证
get_ads	列出广告（通过 adSetId/campaignId edge 和状态筛选）
get_ad	广告详情，包括创意（链接、CTA、文案、视频/图片）
upload_ad_media	上传图片（image_hash）或视频（video_id）
create_adcreative	根据 object_story_spec 创建创意
create_ad	创建广告（默认状态为 PAUSED）
update_ad	更新广告（名称/状态/创意）——写入后读取
delete_ad	删除广告
create_lead_form	在主页上创建即时潜在客户表单
get_lead_forms	列出潜在客户表单（id、name、status、leads_count）
get_pixels	用于 promoted_object 的账户像素（id、name）
create_pixel / update_pixel / get_pixel	像素管理（详情包括 last_fired_time）
get_pixel_stats	像素事件统计（验证事件是否正常流入）
search_interests / get_interest_suggestions	用于定向的兴趣搜索和建议
search_behaviors	用于定向的行为类别
search_geo_locations	用于 targeting.geo_locations 的地理位置键（地区/城市/邮编）
estimate_audience_size	根据给定的定向规格估算受众规模
send_conversion_event / send_conversion_events_batch	Conversions API——服务端事件（自动进行 SHA-256 PII 哈希处理）
get_custom_conversions / get_custom_conversion	列出 / 查看自定义转化详情
create_custom_conversion / update_custom_conversion / delete_custom_conversion	自定义转化（用于潜在客户广告系列的 custom_conversion_id）
get_offline_conversion_sets / create_offline_conversion_set / upload_offline_conversions	从 CRM 导入离线转化
update_adcreative	更新创意（名称/状态——内容不可变）
get_audiences	自定义受众
create_custom_audience	创建受众
create_lookalike_audience	类似受众
create_post	主页帖子
create_video_post	视频主页帖子（可续传，默认不发布）

定向/转化工具集的范围受 Draivix/aidvertaiser（David Strejc，MIT）启发——感谢！

潜在客户广告系列（OUTCOME_LEADS）

潜在客户收集有两种方式；两种方式都需要在广告组中设置 promotedObject + destinationType：

• 网站转化 — optimizationGoal=OFFSITE_CONVERSIONS，destinationType=WEBSITE， promotedObject={ pixel_id, custom_event_type: "LEAD" }（通过 get_pixels 查找你的 Pixel ID）。
• 即时表单 — optimizationGoal=LEAD_GENERATION，destinationType=ON_AD， promotedObject={ page_id }，并使用包含 call_to_action.value.lead_gen_form_id 的创意 （通过 create_lead_form 创建表单）。

如果没有设置 promotedObject + destinationType，Meta 会返回 "Invalid parameter"。对于使用广告系列级预算（CBO）的账户，不要在广告组中设置预算——广告组会继承广告系列预算。如果广告系列使用上限竞价策略（LOWEST_COST_WITH_BID_CAP），广告组必须设置 bidAmount；否则，请将广告系列设置为 bidStrategy=LOWEST_COST_WITHOUT_CAP。

许可证

MIT