AI导哈

Facebook广告管理服务器

一个通过Claude AI直接管理Facebook广告的服务器，无需手动管理令牌，一次登录即可完成所有操作。

  • by Tisik79
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 Tisik79/MCP-Facebook

使用说明

Facebook广告MCP服务器

🇨🇿 中文版本

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

特性

  • 活动管理（创建、更新、删除）
  • 广告集和个人广告
  • 分析和见解
  • 定制和相似的受众
  • 页面帖子
  • 自动令牌管理（页面令牌是永久性的）

安装

需求

  • Node.js 18+
  • 克劳德桌面版

1.克隆存储库

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

2.添加到克劳德桌面

打开Claude Desktop配置文件：

  • 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加：

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

3.第一轮——5分钟设置

首次启动时，向导会引导您创建自己的Facebook应用程序：

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

输入应用程序ID和密码后，浏览器会自动打开→ 使用Facebook登录→ done.

重新登录/添加页面

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资源管理器存储令牌
list_connected_accounts / set_active_account 显示已连接的页面和帐户/切换活动页面和帐户
facebook_setup_help 分步连接指南
get_campaigns 列出活动
create_campaign 创建新活动
update_campaign 更新活动（包括。 bidStrategy)--写后读
get_campaign_details 活动详情（预算、投标策略、今日支出）
delete_campaign 删除活动
get_campaign_insights 活动分析
get_adset_insights / get_ad_insights 广告集/广告级别分析
get_adsets 列出广告集
create_ad_set 创建广告集（包括潜在客户字段 promotedObject / destinationType)
update_adset 更新广告集（名称/状态）——真实写+写后读验证
get_ads 列出广告（通过adSetId/compaignId edge+状态过滤）
get_ad 广告细节，包括创意（链接、CTA、文案、视频/图像）
upload_ad_media 上传图片(image_hash)或视频(video_id)
create_adcreative 创造创意 object_story_spec
create_ad 创建广告（默认为“暂停”）
update_ad 更新广告（姓名/状态/创意）——写后读
delete_ad 删除广告
create_lead_form 在页面上创建即时潜在客户表单
get_lead_forms 列出潜在客户表格(id, name, status, leads_count)
get_pixels 帐户像素(id, name)for promoted_object
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 转换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" } （通过以下方式查找您的Pixel ID get_pixels).
  • 即时表单 — optimizationGoal=LEAD_GENERATION, destinationType=ON_AD, promotedObject={ page_id }，创意与 call_to_action.value.lead_gen_form_id （通过创建表单 create_lead_form).

没有 promotedObject + destinationType，Meta返回“无效参数”。对于帐户 使用活动级预算（CBO）， 不要在广告集上设定预算 --它继承自 运动。如果该活动使用上限出价策略(LOWEST_COST_WITH_BID_CAP)，广告集 需要 bidAmount；否则将活动设置为 bidStrategy=LOWEST_COST_WITHOUT_CAP.

许可证

麻省理工学院

相关 MCP