Facebook Ads MCP Server

Facebook Ads MCP Server

site icon
2025.04.16 7
TypeScript广告管理AI辅助数据分析金融服务
MCP-Facebook是一个基于Model Context Protocol(MCP)的服务器,专门用于通过Claude AI等大型语言模型(LLM)与Facebook Marketing API进行交互,以创建、管理和优化Facebook广告活动。该服务器提供了一系列功能,包括广告活动的创建、管理、分析和优化,以及受众群体的创建和管理。
View on GitHub

Overview

基本能力

产品定位

MCP-Facebook是一个专为Facebook广告活动管理和优化设计的MCP服务器,利用AI技术提升广告效果。

核心功能

  • 广告活动管理:创建、获取、更新和删除广告活动。
  • 分析和报告:获取广告活动的性能数据、账户分析和受众群体分析。
  • 受众管理:创建自定义受众和相似受众,管理用户列表。
  • AI辅助:提供Claude AI的提示模板,分析广告性能并提供优化建议。

适用场景

  • 广告代理商需要自动化管理多个Facebook广告活动。
  • 营销团队需要AI辅助优化广告投放策略。
  • 数据分析师需要获取和分析广告活动的详细数据。

工具列表

  • 广告活动管理工具create_campaign, get_campaigns, get_campaign_details, update_campaign, delete_campaign
  • 分析和评估工具get_campaign_insights, get_account_insights, compare_campaigns, get_campaign_demographics
  • 受众管理工具create_custom_audience, get_custom_audiences, create_lookalike_audience, add_users_to_custom_audience

常见问题解答

  • 安全问题:确保Facebook访问令牌的安全存储和最小权限原则。
  • 生产部署建议:使用环境变量存储敏感信息,定期更新访问令牌,并实施额外的安全措施如防火墙和VPN。

使用教程

使用依赖

  • Node.js(版本18或更高)。
  • Facebook Business Manager账户。
  • 具有Marketing API访问权限的Facebook应用。
  • 具有Facebook Ads API权限的访问令牌。
  • 支持MCP的Claude AI或其他LLM。

安装教程

  1. 克隆仓库:
git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook
  1. 安装依赖:
npm install
  1. 创建.env文件并配置:
FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret
FACEBOOK_ACCESS_TOKEN=your_access_token
FACEBOOK_ACCOUNT_ID=your_ad_account_id
PORT=3000
  1. 编译TypeScript:
npm run build
  1. 启动服务器:
npm start

调试方式

  • 确保所有环境变量已正确设置。
  • 检查Node.js版本是否符合要求。
  • 确保Facebook访问令牌具有必要的权限。
  • 查看服务器日志以获取错误信息。

许可证

该项目遵循 MIT 开源许可条款。