关键词

Facebook广告Meta广告平台广告分析广告创意LLM工具

使用说明

项目简介

'10xer' 是一个功能强大的MCP（Model Context Protocol）服务器，专门设计用于连接Meta广告平台。它通过标准化的JSON-RPC协议向LLM客户端（如Claude Desktop、OpenAI、Gemini等）提供Facebook广告账户、广告系列、广告洞察、创意资产和活动日志等信息。服务器支持多种传输协议，并提供安全的OAuth认证流程，使LLM能够以自然语言交互的方式访问和分析Facebook广告数据。

主要功能点

  • Facebook广告账户管理: 列出所有可访问的广告账户，获取账户详细信息、余额和状态。
  • 广告洞察分析: 获取广告系列、广告组或单条广告的性能指标和分析数据，支持多种时间范围、层级和维度细分。
  • 广告创意查询: 检索广告创意素材（如图片、视频缩略图、文案），并可与性能数据关联。
  • 账户活动日志: 获取指定广告账户的活动日志和变更历史。
  • 安全认证: 支持OAuth 2.0协议进行Facebook身份验证，并安全管理访问令牌。
  • 多平台支持: 除了MCP协议外，还提供兼容OpenAI Function Calling和Google Gemini Function Calling的API接口。

安装步骤

  1. 全局安装服务: 打开终端或命令行工具，运行以下命令安装 'facebook-ads-mcp-server' 包： 
    npm install -g facebook-ads-mcp-server
  2. 创建Facebook开发者应用:
    • 访问 Facebook Developers。
    • 创建一个新的应用或使用现有应用。
    • 添加 "Facebook Login" 产品。
    • 配置OAuth设置：
      • Client OAuth Login: 开启。
      • Web OAuth Login: 开启。
      • Valid OAuth Redirect URIs: 设置为 'http://localhost:3002/auth/callback'。
  3. 配置环境变量 (可选，推荐用于生产部署):
    • 在服务器运行环境中设置 'FACEBOOK_APP_ID' 和 'FACEBOOK_APP_SECRET' 为您的Facebook应用凭据。
    • 'FACEBOOK_REDIRECT_URI' 通常默认为 'http://localhost:3002/auth/callback'，但如果部署在其他URL，需要相应修改。

服务器配置 (MCP客户端使用)

MCP服务器部署后，MCP客户端（如Claude Desktop）需要配置其启动命令才能与其建立连接。以下是Claude Desktop的配置示例，您只需将JSON代码片段添加到您的Claude Desktop MCP设置文件中：

{
  "mcpServers": {
    "facebook-ads": {
      "command": "facebook-ads-mcp", // 启动MCP服务器的命令
      "env": {
        "FACEBOOK_APP_ID": "your_facebook_app_id", // 您的Facebook应用ID
        "FACEBOOK_APP_SECRET": "your_facebook_app_secret", // 您的Facebook应用密钥
        "FACEBOOK_REDIRECT_URI": "http://localhost:3002/auth/callback" // OAuth重定向URI
      }
    }
  }
}

提示:

  • 在生产环境中，'FACEBOOK_ACCESS_TOKEN' 不应硬编码在配置中，而应通过OAuth流程获取。
  • 若需要指定API版本，可添加 '"FACEBOOK_API_VERSION": "vXX.0"'。

基本使用方法

配置完成后，重启您的MCP客户端（如Claude Desktop），然后您可以直接通过自然语言向其提问，例如：

  • "登录到Facebook"（将打开浏览器进行OAuth认证）
  • "检查我的Facebook认证状态"
  • "显示我所有的Facebook广告账户"
  • "获取我的主广告账户最近30天的表现洞察"
  • "显示账户 'act_123456' 的最近活动"
  • "获取表现最好的广告创意缩略图"
  • "从Facebook登出"

信息

分类

商业系统

访问项目