mcpField
A
Adrex AI

Adrex AI

本地服务
adrex.ai商业与营销35 周前更新

关于 Adrex AI

Adrex AI 是连接 Google Ads 和 Meta Ads 账户的开源 MCP 服务,可通过 AI 助手查询报告并管理广告活动、关键词和定向。它面向广告运营者,创建的广告系列和广告均以暂停状态供审核。

主要功能

  1. 01管理 Google Ads 和 Meta Ads 活动
  2. 02查询广告表现与转化数据
  3. 03管理关键词、广告组和受众定向
  4. 04创建时默认暂停广告系列和广告
  5. 05支持远程 HTTP 或 npx 连接

适用场景

  1. 01查看广告系列近期表现与趋势
  2. 02暂停低回报的广告系列或关键词
  3. 03创建待审核的 Meta 广告活动
  4. 04比较 Google Ads 与 Meta Ads 账户表现

MCP 相关

该 MCP 服务向客户端公开 Google Ads、Meta Ads 及跨平台工具,涵盖账户、活动管理和报告。可通过远程 HTTP 浏览器授权连接,也可用带 API 密钥的 stdio 服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"adrex-ai": {
"command": "npx",
"args": [
"-y",
"adrex-ai"
],
"env": {
"ADREX_API_KEY": "<ADREX_API_KEY>",
"ADREX_API_URL": "<ADREX_API_URL>"
}
}
}
}
启动命令npx -y adrex-ai
需要配置的环境变量
ADREX_API_KEY密钥Your Adrex API key from https://adrex.ai/settings (after connecting your ad accounts).
ADREX_API_URLOptional override for the Adrex backend API URL. Defaults to the Adrex hosted API.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmadrex-ai1.0.12

工具

54

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

Adrex AI

适用于 Google Ads 和 Meta Ads 的开源 MCP 服务

使用 Claude Code、Cursor、Codex、Gemini 或任何 MCP 客户端,通过自然语言管理广告系列。

npm 版本 npm 下载量 MIT 许可证

快速开始 | 64 个工具 | 平台 | Discord


什么是 Adrex AI?

Adrex AI 是一款开源 MCP(Model Context Protocol)服务,可将 AI 助手连接到你的 Google Ads 和 Meta Ads 账户。无需在复杂的控制面板中操作,你可以通过自然语言管理广告系列、报告、关键词和定向,支持 Claude、Cursor、Codex 或任何 MCP 客户端。

**平台:**目前支持 Google Ads 和 Meta Ads(Facebook 和 Instagram)——即将支持 TikTok 和 LinkedIn。

You: "Show me my Google Ads performance for the last 7 days"
Claude: [calls google_ads_campaign_performance] → table with spend, clicks, CTR, ROAS

You: "Pause the campaign with the lowest ROAS"
Claude: [calls google_ads_pause_campaign] → campaign paused, no more spend

You: "Create a Meta campaign for our summer sale, $50/day budget"
Claude: [calls meta_ads_create_campaign] → campaign created PAUSED for your review

只需在 Adrex 控制面板中连接一次广告账户(通过安全 OAuth 授权——令牌保存在我们的服务器上,不会存储在 MCP 客户端中),之后即可通过 AI 助手管理所有内容。有两种连接方式(参见快速开始):通过浏览器登录的远程服务,无需 API 密钥;或使用 API 密钥的 npx 服务。

安全第一

这些工具会操作真实的广告账户,并花费真实资金:

  • 所有广告系列和广告创建时均为已暂停状态——只有你明确恢复投放后才会产生花费
  • 危险操作和会开始产生花费的操作都会返回明确警告
  • 读取操作(指标、列表)可自由执行,不会产生副作用

快速开始

首先,在 adrex.ai 注册,并在设置中连接你的 Google/Meta 广告账户。然后选择以下两种连接方式之一。

选项 A — 远程服务(推荐,无需 API 密钥)

通过 HTTP 连接并在浏览器中授权——无需复制或粘贴任何内容。客户端会保存自己的安全令牌。在 Adrex 控制面板中,Settings → Connect to your AI (MCP) 会显示一条命令,让你连接到服务。命令如下:

Claude Code:

claude mcp add --transport http adrex-ai https://<your-adrex-server>/mcp

Claude Desktop / Cursor / VS Code / 其他客户端(JSON)——也可以使用设置中的一键式 Add to Cursor / Add to VS Code 按钮:

{
  "mcpServers": {
    "adrex-ai": { "type": "http", "url": "https://<your-adrex-server>/mcp" }
  }
}

添加后,客户端会打开一个浏览器标签页——登录并点击授权。授权页面会显示你将以哪个 Adrex 账户进行授权;如果该浏览器中已登录其他账户,请先点击不是你?切换,再批准授权。

你可以在设置 → Connect to your AI → Connected AI apps中查看并撤销所有已连接的应用。

**连接了错误的账户?**即使广告账户已关联,所有工具仍会报告“未连接”。请在设置中撤销该应用,然后重新授权。请注意,配置好服务后重新运行 claude mcp add 不会产生任何效果(会显示 already exists in local config)——请改为在 Claude Code 中运行 /mcp,选择 adrex-ai,然后清除身份验证。

选项 B — 使用 API 密钥的 npx 服务

更喜欢经典的 stdio 服务?在 Settings 中生成 API 密钥,然后添加到下方。Adrex 提供标准的 stdio MCP 服务,因此可与任何 MCP 客户端配合使用——每个配置都指向 npx -y adrex-ai,并使用你的 ADREX_API_KEY。

Claude Code:

claude mcp add -s user adrex-ai -e ADREX_API_KEY=your-api-key -- npx -y adrex-ai

Gemini CLI:

gemini mcp add adrex-ai -e ADREX_API_KEY=your-api-key -- npx -y adrex-ai

Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json)、Cursor(全局配置 ~/.cursor/mcp.json,或项目配置 .cursor/mcp.json)、Gemini CLI(~/.gemini/settings.json),或任何使用 JSON mcpServers 格式的客户端:

{
  "mcpServers": {
    "adrex-ai": {
      "command": "npx",
      "args": ["-y", "adrex-ai"],
      "env": {
        "ADREX_API_KEY": "your-api-key"
      }
    }
  }
}

Codex(~/.codex/config.toml)——请注意,Codex 使用 TOML,而非 JSON:

[mcp_servers.adrex-ai]
command = "npx"
args = ["-y", "adrex-ai"]
env = { ADREX_API_KEY = "your-api-key" }

其他任何 MCP 客户端(Cline、Windsurf、Zed、Continue,等等):将其指向命令 npx -y adrex-ai,并将环境变量 ADREX_API_KEY 设为你的密钥。

就这么简单——无需配置 SDK,无需开发者令牌,也无需折腾 OAuth。服务会将每个请求转发到 Adrex 后端,后端使用你在控制面板中连接的广告账户凭据。

在企业代理后面? v1.0.4+ 会自动通过 HTTP_PROXY / HTTPS_PROXY 路由。

工具

Google Ads(35 个工具)
广告系列
工具描述
google_ads_list_accounts列出所有可访问的 Google Ads 账户
google_ads_list_campaigns列出广告系列及其效果指标
google_ads_get_campaign获取广告系列的详细信息和指标
google_ads_create_search_campaign创建搜索广告系列(创建后为已暂停状态)
google_ads_update_campaign更新名称、预算或出价策略
google_ads_pause_campaign暂停广告系列
google_ads_resume_campaign恢复已暂停的广告系列
google_ads_delete_campaign永久移除广告系列
广告组
工具描述
google_ads_list_ad_groups列出广告组及其指标
google_ads_create_ad_group创建采用 CPC 出价的广告组
google_ads_update_ad_group更新名称、出价或状态
google_ads_pause_ad_group暂停广告组
google_ads_delete_ad_group移除广告组
广告
工具描述
google_ads_list_ads列出广告及其标题、URL 和指标
google_ads_create_responsive_search_ad创建包含标题和描述的 RSA
google_ads_pause_ad暂停广告
google_ads_enable_ad启用已暂停的广告
google_ads_delete_ad移除广告
关键词
工具描述
google_ads_list_keywords列出关键词及其质量得分和指标
google_ads_add_keywords添加关键词(BROAD、PHRASE、EXACT)
google_ads_add_negative_keywords将否定关键词添加到广告系列
google_ads_pause_keyword暂停关键词
google_ads_remove_keyword移除关键词
报告
工具描述
google_ads_campaign_performance所有广告系列的效果摘要
google_ads_time_series指定日期范围内的每日指标
google_ads_breakdowns按设备或网络细分
google_ads_auction_insights竞争性拍卖指标
google_ads_get_budget广告系列预算详情
分析
工具描述
google_ads_keyword_performance按回报对关键词排序——哪些关键词带来了最多收入
google_ads_keyword_insights一次调用完成全面的关键词审查:屏蔽性否定关键词、浪费支出的主题、缺失的关键词、质量得分溢价、预算与广告排名上限、重复项
google_ads_ad_performance按回报对广告排序——哪些广告文案真正带来了转化
google_ads_search_terms人们实际搜索了什么、花费了多少,以及哪些搜索词花了钱却没有成效
google_ads_conversion_health在信任任何 CPA 或 ROAS 数据之前,检查转化跟踪是否正常
google_ads_conversion_funnel哪些关键词或广告系列带来了业务真正按其付费的事件,而不只是表单填写——导入离线转化时必不可少
google_ads_recent_changes最近谁更改了什么——大多数突变都是人为操作所致
Meta Ads(26 个工具)
广告系列
工具描述
meta_ads_list_accounts列出所有 Meta 广告账户
meta_ads_list_campaigns列出广告系列及其指标
meta_ads_get_campaign获取广告系列详细信息
meta_ads_create_campaign创建广告系列(创建后为暂停状态)
meta_ads_update_campaign更新名称、预算或状态
meta_ads_pause_campaign暂停广告系列
meta_ads_resume_campaign启用已暂停的广告系列
meta_ads_delete_campaign删除广告系列
广告组
工具描述
meta_ads_list_ad_sets列出广告组及其定向设置和指标
meta_ads_create_ad_set创建广告组并设置定向选项
meta_ads_update_ad_set更新名称、预算或状态
meta_ads_pause_ad_set暂停广告组
meta_ads_delete_ad_set删除广告组
广告
工具描述
meta_ads_list_ads列出广告及其创意详情和指标
meta_ads_create_ad创建广告并设置文案、图片和 CTA
meta_ads_pause_ad暂停广告
meta_ads_enable_ad启用已暂停的广告
meta_ads_delete_ad删除广告
定向与受众
工具描述
meta_ads_search_interests搜索定向兴趣和行为
meta_ads_list_audiences列出自定义受众
meta_ads_list_pages列出你的 Facebook 公共主页
meta_ads_update_targeting更新广告组的定向设置
报告
工具描述
meta_ads_campaign_performance跨广告系列的效果摘要
meta_ads_time_series每日效果时间序列
meta_ads_breakdowns按设备、平台、年龄、性别细分
meta_ads_creative_performance按回报对广告排序——哪些创意带来了收入,哪些只花了钱却毫无成效
跨平台(3 个工具)
工具描述
account_review一次调用即可回答“我们的表现如何”。首先汇总 Google 和 Meta 每月面临风险的金额,然后进一步拆分:没有带来任何成效的支出、远高于账户自身 CPA 的支出,以及错失的增长机会
campaign_diagnosis分析效果变化原因:将当前时间段与之前的时间段进行比较,并归因变化
list_connected_platforms查看已连接且可用的广告平台

使用场景

效果审查

“我这个月的 Google Ads 广告系列表现如何?列出 ROAS 低于 2x 的广告系列。”

广告系列管理

“创建一个名为‘Summer Sale 2026’的 Meta 流量广告系列,预算为每天 $75,定向美国 25-45 岁人群。”

关键词优化

“列出我‘Brand Terms’广告组中的关键词。暂停所有质量得分低于 5 的关键词。”

预算控制

“将表现最佳的广告系列预算提高 20%,并暂停正在亏钱的广告系列。”

了解更多?

此 MCP 服务让你可以通过聊天全面管理广告系列。Adrex AI Platform 还提供:

  • AI 广告系列 Agent — 在防护措施和回滚机制下自主优化
  • 创意工作室 — AI 生成的广告文案和图片
  • A/B 测试 — 原生平台实验
  • 竞争对手情报 — 跟踪 Google 和 Meta 上的竞争对手广告
  • 预算规则引擎 — 支持自然语言解析的自动化规则
  • 可视化仪表板 — 交互式图表、细分数据和时间序列

链接

许可证

MIT 许可证 — 详情请参阅 LICENSE。


由 Adrex AI 背后的团队打造

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。