AI导哈

Google Ads对话管理工具

通过自然语言对话管理Google Ads账户的工具，支持账户切换、性能分析、广告创建和安全变更等功能。

  • by lkalajzic
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 lkalajzic/google-ads-mcp

使用说明

谷歌广告MCP

运行谷歌广告就像用牙刷清洁浴室地板。所以我建立了一个更好的方法：通过与克劳德的自然对话来管理谷歌广告。

特性

🔍 阅读和分析

  • 列出并在多个Google Ads帐户之间切换
  • 获取活动/关键字/广告绩效指标
  • 按设备、位置、人口统计、时间表进行分析
  • 运行自定义GAQL查询
  • 搜索词分析

✏️ 创建和管理

  • 从头开始构建完整的活动
  • 定位（地理、半径、排除）
  • 关键字和负面关键字管理
  • 带有固定功能的响应式搜索广告
  • 预算和投标调整

🛡️ 安全第一

  • 干运行模式 -执行前预览更改
  • 默认已暂停 -新活动/广告从不自动启动
  • 更改跟踪 -内置变更日志生成
  • 预算限额 -可配置的盖子

快速开始

先决条件

  • 带有经理帐户（MCC）的Google Ads帐户
  • 已安装Node.js
  • Claude桌面应用程序
  • 初始设置大约需要15分钟

步骤1:谷歌广告配置

创建经理帐户：

  1. 首选 ads.google.com/home/tools/manager帐户/
  2. 点击“创建经理帐户”
  3. 填写您的企业名称并选择如何使用该帐户
  4. 创建MCC帐户（API访问需要，即使只有一个广告帐户）

获取您的开发者令牌：

  1. 登录您的经理帐户 ads.google.com 或使用 这种形式
  2. 在左侧边栏中，单击：管理员→ API中心
  3. 点击“申请访问”并填写：
    • 联系邮箱：您的邮箱
    • 开发人员令牌名称：“MCP Integration”（或任何名称）
    • 用例：“管理我自己的帐户”
    • OAuth2客户端类型：桌面
  4. 提交并等待批准（通常为1-3个工作日）
  5. 一旦获得批准（您将收到一封电子邮件），请从API中心复制您的开发者令牌

第二步：谷歌云设置

  1. 访问console.cloud.google.com
  2. 创建新项目
  3. 启用Google Ads API
  4. 创建OAuth 2.0凭据：
    • 类型：桌面应用程序
    • 下载JSON凭据

步骤3：安装先决条件

安装Node.js：

  • 下载自 nodejs.org （使用LTS版本）
  • 运行安装程序-只需点击默认值即可

安装Bun（可选但更快-加快每个命令！）：

  • 在您的终端中，粘贴以下内容：
curl -fsSL https://bun.sh/install | bash

步骤4：生成刷新令牌

选项A：下载ZIP（对非开发人员来说更容易）

  1. 从下载ZIP https://lkalajzic/gogle-ads-mcp
  2. 将其解压缩到您会记住的文件夹中（例如，Desktop）
  3. 打开终端（Mac）或命令提示符（Windows）：
    • Mac：按Cmd+Space，键入“终端”
    • Windows：按Win+R，键入“cmd”
  4. 导航到文件夹-在终端中粘贴：
    cd ~/Desktop/google-ads-mcp  # Mac
cd C:\Users\YourName\Desktop\google-ads-mcp  # Windows

选项B:Git克隆（适用于开发人员）

  • 在您的终端中，粘贴：
git clone https://github.com/lkalajzic/google-ads-mcp
cd google-ads-mcp

然后，对于这两个选项：

  • 在您的终端中，粘贴：
# Install dependencies
bun install  # or: npm install

# Generate your refresh token
bun run generate-token  # or: npm run generate-token

按照浏览器提示进行授权。保存它生成的刷新令牌。

步骤5：配置环境

复制示例文件-在终端中粘贴：

cp .env.example .env  # Mac/Linux
copy .env.example .env  # Windows

编辑 .env 使用您的凭据：

GOOGLE_ADS_DEVELOPER_TOKEN=your-token-here
GOOGLE_ADS_CLIENT_ID=from-oauth-json
GOOGLE_ADS_CLIENT_SECRET=from-oauth-json
GOOGLE_ADS_REFRESH_TOKEN=from-the-script
GOOGLE_ADS_MCC_ID=your-manager-account-id

步骤6：构建项目

在您的终端中，粘贴：

bun run build  # or: npm run build

这将创建 build/index.js Claude将用于运行任何命令的文件。

第7步：联系克劳德

查找您的配置文件：

苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

或者转到克劳德->设置->开发人员->编辑配置

{
  "google-ads-mcp": {
    "command": "/Users/YOUR_USER_NAME_AND_PATH/.bun/bin/bun",
    "args": ["run", "/absolute-path-to-your-folder/google-ads-mcp/src/index.ts"]
  }
}

注： 使用 "command": "node" 而不是 "bun" 如果你没有安装Bun。

找到你的绝对路径：

  • 在您的终端中（在谷歌广告mcp文件夹中），粘贴： pwd （Mac/Linux）或 cd （Windows）
  • 复制该路径并添加 /build/index.js

重新启动Claude并使用以下命令进行测试：“Claude，列出我的Google Ads帐户”

上下文系统（你的秘密武器）

真正的力量来自于给克劳德提供你的业务背景。创建三个（理想情况下）markdown文件：

1.一般说明.md

有关MCP使用说明，请参阅存储库中包含的示例。

2.business-context.md

# Business Context

## What We Sell

SaaS product for project management

## Target Metrics

- CPA: <$50
- CTR: >2%

## What Works

- "project management software" - high converter
- Mobile traffic performs 40% better
- US tech hubs: SF, NYC, Austin, Seattle

3.changelog.md

# Change Log

[Claude will update this automatically with each change]

在每次聊天开始时，你可以说“从FOLDER_PATH初始化内存”，如果你启用了文件系统MCP服务器，Claude将读取所有三个文件。

要尝试的常见命令

"Make a report of the campaign performance in the last 30 days"
"Analyze my search terms and suggest keywords to add and exclude"
"Pause all poor performing ad groups"
"Create a brand search protection campaign"
"Add competitor brand names as negative keywords"
"Analyze campaign performance in-depth - per device, location, time of day"

故障排除

“克劳德看不到我的账户”

  • 检查您的MCC ID是否正确
  • 运行测试命令： bun run test-connection 或 npm run test-connection
  • 确保刷新令牌具有正确的作用域

“没有出现变化”

  • 查看Google Ads UI中的更改历史记录

“获取权限错误”

  • 您的开发人员令牌需要获得批准（查看电子邮件以获得批准）
  • 验证API访问级别：经理帐户→ 管理员（左侧边栏）→ API中心

贡献

看 贡献.md 用于开发设置和指南。

许可证

MIT许可证-请参阅 许可证

博客文章： lukakalajzic.com/google-ads-mcp

问题？问题？打开GitHub问题或在推特上联系： @卢卡奇

由Luka Kalajžić建造

记住：始终验证谷歌广告中的更改。这是测试版软件，请自由使用dry_run模式。

相关 MCP