关键词

Meta Ads API广告管理营销数据广告效果图片分析

使用说明

项目简介

Meta Ads MCP 是一个 MCP 服务器插件，旨在为大型语言模型（LLM）提供访问 Meta 广告 API 的能力。通过此服务器，LLM 客户端可以安全、便捷地检索和分析 Meta 广告平台的数据，例如广告账户、广告系列、广告以及广告效果数据，并进行广告管理操作。

主要功能点

  • Meta 广告数据访问: 提供多种工具，允许 LLM 客户端获取广告账户、广告系列、广告组和广告的详细信息。
  • 广告效果分析: 支持检索广告系列、广告组、广告或账户的性能指标，例如展示次数、点击次数、花费等。
  • 广告图片处理: 能够下载和分析 Meta 广告的图片素材，方便 LLM 进行视觉内容分析。
  • OAuth 2.0 认证: 采用 OAuth 2.0 协议进行身份验证，安全管理 Meta Ads API 的访问权限，并支持 Token 缓存，避免重复登录。
  • 易于集成: 设计为 MCP 服务器插件，可以方便地与支持 MCP 协议的 LLM 客户端集成，例如 Cursor 编辑器中的 Claude。

安装步骤

本 MCP 服务器插件支持使用 'uv' 或 'pip' 进行安装。推荐使用 'uv'，安装和运行更加便捷。

使用 uv (推荐):

  1. 直接运行 (无需安装): 打开终端，输入以下命令即可直接运行 Meta Ads MCP 服务器： 
    uvx meta-ads-mcp
  2. 安装软件包: 如果需要安装软件包，可以使用以下命令： 
    uv pip install meta-ads-mcp

使用 pip:

  1. 安装软件包: 如果您的环境中使用 'pip'，可以使用以下命令安装： 
    pip install meta-ads-mcp
  2. 运行服务器: 安装完成后，通过以下命令启动 Meta Ads MCP 服务器： 
    python -m meta_ads_mcp

服务器配置

为了让 MCP 客户端（例如 Claude in Cursor）连接到 Meta Ads MCP 服务器，您需要在客户端的配置文件中添加服务器信息。以下是配置示例，通常在客户端的 'claude_desktop_config.json' 文件中进行配置：

"mcpServers": {
  "meta-ads": {
    "command": "uvx",
    "args": ["meta-ads-mcp"]
  }
}

配置参数说明:

  • 'server name': 'meta-ads' (服务器名称，可以自定义，用于在客户端中标识该服务器)
  • 'command': 'uvx' (或 'python -m meta_ads_mcp'，取决于您的安装方式) (启动 MCP 服务器的命令)
  • 'args': '["meta-ads-mcp"]' (或 '[]'，如果使用 'python -m meta_ads_mcp' 则参数为空) (传递给启动命令的参数，这里指定了要运行的 MCP 服务器插件)

基本使用方法

  1. 启动 MCP 服务器: 根据您的安装方式，在终端中运行 'uvx meta-ads-mcp' 或 'python -m meta_ads_mcp' 命令启动服务器。

  2. 配置 MCP 客户端: 在您的 MCP 客户端（例如 Claude in Cursor）中，根据上述 “服务器配置” 部分的信息，配置 Meta Ads MCP 服务器连接。

  3. 身份验证: 首次使用需要进行 Meta Ads API 身份验证。您可以使用工具 'mcp_meta_ads_get_login_link' 获取登录链接。点击链接在浏览器中完成授权流程。

  4. 使用工具: 通过 LLM 客户端调用 Meta Ads MCP 服务器提供的工具，例如：

    • 'mcp_meta_ads_get_ad_accounts': 获取广告账户列表。
    • 'mcp_meta_ads_get_campaigns': 获取广告系列列表。
    • 'mcp_meta_ads_get_ad_image': 获取广告图片。
    • 'mcp_meta_ads_get_insights': 获取广告效果数据。

    您可以参考仓库 README.md 文件中 “Available MCP Tools” 章节，查看所有可用的工具及其使用方法。

完成以上步骤后，您就可以在 LLM 客户端中使用 Meta Ads MCP 服务器提供的功能，与 Meta 广告 API 进行交互，实现广告数据检索和分析等操作。

信息

分类

商业系统

访问项目