关键词

Meta广告APIFacebook广告Instagram广告AI营销LLM工具

使用说明

项目简介

Meta Ads MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使大型语言模型 (LLM) 能够通过标准化的接口访问和管理 Meta (Facebook, Instagram) 广告平台。它允许LLM检索广告数据、分析广告效果、并根据数据洞察提供优化建议，甚至进行广告活动管理。

主要功能点

  • AI驱动的广告活动分析: 让LLM分析您的Meta广告活动，并提供可执行的性能洞察。
  • 智能优化建议: 基于数据为广告支出、目标受众和创意内容提供优化建议。
  • 自动化监控: 使用LLM跟踪关键性能指标，并在指标发生重大变化时发出警报。
  • 预算优化: 获得预算重新分配的建议，以提高广告系列效果。
  • 创意改进: 接收关于广告文案、图像和行动号召的反馈。
  • 广告活动管理: 请求更改广告活动、广告组和广告 (所有更改都需要显式确认)。
  • 跨平台支持: 兼容Facebook、Instagram和所有Meta广告平台。
  • 通用LLM支持: 兼容任何MCP客户端，包括Claude Desktop, Cursor, Cherry Studio等。

安装步骤

您可以使用 'uv' (推荐) 或 'pip' 来安装 Meta Ads MCP Server。

使用 uv (推荐)

uv pip install meta-ads-mcp

使用 pip

pip install meta-ads-mcp

安装完成后，您可以使用以下命令运行服务器：

python -m meta_ads_mcp

您也可以使用 'uvx' 直接运行，无需事先安装：

uvx meta-ads-mcp

服务器配置

要将 Meta Ads MCP Server 与 MCP 客户端（例如 Cursor 中的 Claude）集成，您需要在客户端的配置文件中添加服务器信息。以下是一个 'claude_desktop_config.json' 示例，用于在 Cursor 中配置 Meta Ads MCP Server：

"mcpServers": {
  "meta-ads": {
    "command": "uvx",
    "args": ["meta-ads-mcp"]
  }
}
  • 'server name': 'meta-ads' (您可以自定义服务器名称)
  • 'command': 'uvx' (或 'python -m meta_ads_mcp'，取决于您的安装方式)
  • 'args': '["meta-ads-mcp"]' (运行服务器的命令参数，此处无需额外参数)

注意: 您需要确保已经配置了 Meta App ID 才能正常使用 Meta Ads MCP Server。Meta App ID 可以通过环境变量 'META_APP_ID' 或启动参数 '--app-id' 提供给服务器。例如，使用 'uvx' 运行时可以添加 '--app-id YOUR_META_ADS_APP_ID' 参数:

uvx meta-ads-mcp --app-id YOUR_META_ADS_APP_ID

基本使用方法

  1. 启动 Meta Ads MCP Server。

  2. 在您的 MCP 客户端（例如 Cursor 中的 Claude）中配置并连接到 Meta Ads MCP Server。

  3. 使用自然语言向 MCP 客户端提问或发出指令，以访问和管理您的 Meta 广告数据。例如，您可以询问：

    • "获取我的广告账户列表" (对应工具: 'mcp_meta_ads_get_ad_accounts')
    • "分析 Campaign ID 为 'YOUR_CAMPAIGN_ID' 的广告系列效果" (对应工具: 'mcp_meta_ads_get_insights')
    • "获取 Ad ID 为 'YOUR_AD_ID' 的广告创意图片" (对应工具: 'mcp_meta_ads_get_ad_image')

    LLM 将会调用相应的 MCP 工具并返回结果。

可用的 MCP 工具

Meta Ads MCP Server 提供了以下工具，您可以在 MCP 客户端中使用它们来与 Meta Ads API 交互：

  • 'mcp_meta_ads_get_ad_accounts'：获取广告账户列表
  • 'mcp_meta_ads_get_account_info'：获取广告账户详细信息
  • 'mcp_meta_ads_get_campaigns'：获取广告系列列表
  • 'mcp_meta_ads_get_campaign_details'：获取广告系列详细信息
  • 'mcp_meta_ads_create_campaign'：创建新的广告系列
  • 'mcp_meta_ads_get_adsets'：获取广告组列表
  • 'mcp_meta_ads_get_adset_details'：获取广告组详细信息
  • 'mcp_meta_ads_update_adset'：更新广告组设置
  • 'mcp_meta_ads_get_ads'：获取广告列表
  • 'mcp_meta_ads_get_ad_details'：获取广告详细信息
  • 'mcp_meta_ads_get_ad_creatives'：获取广告创意详细信息
  • 'mcp_meta_ads_get_ad_image'：获取广告图片
  • 'mcp_meta_ads_update_ad'：更新广告设置
  • 'mcp_meta_ads_get_insights'：获取广告效果数据
  • 'mcp_meta_ads_debug_image_download'：调试图片下载问题
  • 'mcp_meta_ads_get_login_link'：获取Meta Ads 登录链接

请参考仓库 README.md 文件获取每个工具的详细输入参数和返回值说明。

信息

分类

商业系统

访问项目