burnr8 (Harrison Hesslink)

燃烧器8

     ](https://hub.docker.com/r/harrisonhesslink/burnr8) 

停止在谷歌广告上烧钱。从你的终端管理一切。

想要零设置？ 托管版本位于 burnrate.sh 为您处理凭据——通过OAuth连接Google Ads，获取MCP端点，完成。 加入候补名单→

目录

• 你能做什么
• 安装
• 终端仪表板
• 自定义代理
• 斜杠命令
• MCP资源和提示
• 项目结构
• 贡献
• 常见问题解答
• 许可证

burnr8是一个MCP服务器，它提供 克劳德代码 完全控制Google Ads。14个类别的66个工具，用于管理活动、关键字、预算、广告、扩展、转化跟踪、出价调整、广告调度、转化目标、竞争洞察和报告——所有这些都可以通过CLI实现。包括2个自定义代理、9个斜线命令、7个提示模板和MCP资源。

这是一个非官方工具，与谷歌无关或不受谷歌认可。

你能做什么

You:    "Audit my Google Ads account"
Claude: *pulls performance data, keywords, search terms, extensions, conversion actions*
        *identifies $200/month in wasted spend on free-intent keywords*
        *recommends negative keywords, pausing underperformers, fixing conversion tracking*

You:    "Add 'free' as a phrase match negative keyword"
Claude: Done. Estimated savings: ~$55/month.

14个类别中的66个工具

自定义代理

• ads-optimizer --查找并修复浪费的广告支出，推荐负面关键词，暂停表现不佳者
• ads-auditor --使用健康评分和优先行动项进行全面的账户审计

斜杠命令

MCP资源和提示

资源 --Claude的自动加载上下文：

• burnr8://usage -当前API使用情况统计
• burnr8://accounts --可访问帐户列表
• burnr8://accounts/{id}/performance --30天活动表现
• burnr8://accounts/{id}/keywords --关键字健康摘要
• burnr8://accounts/{id}/structure --账户结构概述

提示 --指导工作流程：

• audit --运行完整的帐户审核
• optimize --发现并解决浪费的开支
• new_campaign --计划并启动新的搜索活动
• competitors --竞争定位分析
• budget_reallocation --优化预算分配
• ad_copy --生成新的RSA广告变体
• trends --检测每周绩效变化

内置安全功能

• 破坏性操作需要 confirm=true --无意外活动启用或关键字删除
• 新的活动总是开始的 已暂停
• run_gaql_query 是任何Google Ads数据的只读逃逸窗口
• 所有输入均已验证（ID必须是数字，状态已分配，日期范围已检查）
• 跟踪API使用情况，了解15000次操作/天费率限制
• CSV报告与配方奶粉注射消毒一起保存 0o600 权限
• 线程安全：ContextVars隔离每个请求的会话状态，防止并发环境中的租户泄漏
• 金融断路器：在突变点实施可配置的硬上限（预算、投标、修改、ROAS/CPA目标）

CSV报告导出

所有报告工具都将完整结果保存到 ~/.burnr8/reports/ 作为CSV文件，并将简洁的摘要返回到Claude的上下文中，而不是转储数千行。克劳德可以 Read CSV，以便在需要时进行更深入的分析。

• 文件在7天后自动修剪
• 配方奶粉注射消毒（Excel/LibreOffice安全）
• 存储统计数据可通过以下方式查看 get_api_usage 和 burnr8 仪表盘

______________________________________________________________________

安装

先决条件

• Python 3.11+
• Google Ads帐户
• A. Google Ads API开发者代币 （基本访问）
• 来自的OAuth2凭据（客户端ID+机密） 谷歌云控制台

选项A:Claude代码插件（推荐）

添加到您的 ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "burnr8": {
      "source": {"source": "github", "repo": "HarrisonHesslink/burnr8"},
      "autoUpdate": true
    }
  }
}

然后运行 /plugin 在克劳德代码中启用 燃烧器8。这会自动配置MCP服务器、代理、命令和审计技能。你仍然需要 pip install burnr8 并设置凭据（见下文）。

选项B:pip/uv安装

uv pip install burnr8
# or: pip install burnr8

选项C:Docker（不需要Python）

docker pull harrisonhesslink/burnr8          # Docker Hub
# or
docker pull ghcr.io/harrisonhesslink/burnr8  # GitHub Container Registry

添加 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "burnr8": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GOOGLE_ADS_DEVELOPER_TOKEN",
        "-e", "GOOGLE_ADS_CLIENT_ID",
        "-e", "GOOGLE_ADS_CLIENT_SECRET",
        "-e", "GOOGLE_ADS_REFRESH_TOKEN",
        "-e", "GOOGLE_ADS_LOGIN_CUSTOMER_ID",
        "ghcr.io/harrisonhesslink/burnr8"
      ]
    }
  }
}

将凭据设置为shell中的环境变量，或使用 --env-file .env 而不是个人 -e 旗帜。

选项C：克隆并安装

git clone https://github.com/HarrisonHesslink/burnr8.git
cd burnr8
uv venv .venv
source .venv/bin/activate
uv pip install -e .

2.设置凭据

cp .env.example .env

编辑 .env 使用您的凭据：

GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token
GOOGLE_ADS_CLIENT_ID=your-oauth-client-id
GOOGLE_ADS_CLIENT_SECRET=your-oauth-client-secret
GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your-mcc-id (optional, for manager accounts)

# Optional: Financial Circuit Breakers
BURNR8_MAX_DAILY_BUDGET_DOLLARS=10000
BURNR8_MAX_CPC_BID_DOLLARS=100
BURNR8_MAX_BID_MODIFIER=5.0
BURNR8_MAX_TARGET_CPA_DOLLARS=500
BURNR8_MIN_TARGET_ROAS=0.5

没有刷新令牌？ 运行附带的OAuth帮助程序：

python setup_oauth.py

它将打开一个谷歌登录浏览器，并打印您的刷新令牌。

3.用克劳德代码注册

将burnr8添加为全局MCP服务器，使其在所有Claude Code会话中都可用：

claude mcp add --scope user --transport stdio burnr8 \
  --env PYTHONPATH=$(pwd)/src \
  -- $(pwd)/.venv/bin/python -m burnr8.server

或手动创建/编辑 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "burnr8": {
      "type": "stdio",
      "command": "/path/to/burnr8/.venv/bin/python",
      "args": ["-m", "burnr8.server"],
      "cwd": "/path/to/burnr8",
      "env": {
        "PYTHONPATH": "/path/to/burnr8/src"
      }
    }
  }
}

4.重新启动克劳德代码

claude

你应该看看 burnr8 工具可用。测试：

list_accessible_accounts

______________________________________________________________________

终端仪表板

检查您的API使用情况、最近的工具调用和活动支出：

burnr8

  burnr8 Dashboard
  2026-04-04 03:26 UTC
  --------------------------------------------------

  API Ops Today:    142 / 15,000  [##------------------]  0.9%
  Errors (24h):     2
  Last Tool Call:   get_campaign_performance (3m ago)

  Campaign Spend:
    My Campaign:
      Today:  $48.21 / $150.00 budget  |  74 clicks  |  12 conv
      MTD:    $1,612.00

______________________________________________________________________

Google Ads API访问的工作原理

1. 创建Google Ads管理员帐户 （如果你没有） ads.google.com
2. 获取开发人员令牌 从经理帐户中的API中心（工具>API中心）
3. 创建OAuth2凭据 在 谷歌云控制台 --选择“桌面应用程序”
4. 启用Google Ads API 在您的GCP项目中
5. 申请基本访问权限 --允许在真实账户上每天进行15000次操作

您的开发人员令牌以测试帐户访问权限开头。申请基本访问权限以管理真实账户。

______________________________________________________________________

项目结构

burnr8/
├── src/burnr8/
│   ├── server.py          # FastMCP entry point (resources, prompts)
│   ├── client.py          # Google Ads client (lazy singleton)
│   ├── helpers.py         # GAQL runner, validators, converters
│   ├── errors.py          # Error handling + logging decorator
│   ├── logging.py         # Structured logging + rate limit tracking
│   ├── reports.py         # CSV export + sanitization + storage stats
│   ├── dashboard.py       # Terminal dashboard
│   └── tools/             # 65 MCP tools across 14 modules
│       ├── accounts.py
│       ├── campaigns.py
│       ├── ad_groups.py
│       ├── ads.py
│       ├── keywords.py
│       ├── negative_keywords.py
│       ├── budgets.py
│       ├── reporting.py
│       ├── extensions.py
│       ├── conversions.py
│       ├── compound.py
│       ├── adjustments.py
│       ├── goals.py
│       └── competitive.py
├── .claude/
│   ├── agents/            # 2 custom agents (ads-optimizer, ads-auditor)
│   └── commands/          # 9 slash commands
├── setup_oauth.py         # OAuth refresh token generator
├── .env.example           # Credential template
└── pyproject.toml

______________________________________________________________________

贡献

PR欢迎。一些值得扩展的领域：

• 展示活动 --创建/管理展示广告
• 最大性能 --资产组、受众信号、搜索主题
• YouTube广告 --视频活动管理
• 受众定位 --再营销列表、客户匹配
• 地点投标调整 --地理投标修改器
• 测试 --逻辑/助手的单元测试，具有活动测试帐户的集成测试（测试帐户无关）

______________________________________________________________________

常见问题解答

我需要一个谷歌广告管理器（MCC）帐户吗？ 不可以。burnr8既适用于个人谷歌广告账户，也适用于经理账户。集 GOOGLE_ADS_LOGIN_CUSTOMER_ID 只有当你使用经理账户时。

我需要什么样的Google Ads API访问级别？ 基本访问（15000次操作/天）。这对于大多数用例来说已经足够了。通过您的Google Ads帐户中的API中心申请。

这适用于Claude Desktop还是Claude Code？ burnr8是一个使用stdio传输的MCP服务器。它适用于Claude Code和任何支持stdio服务器的MCP客户端。

我可以在为客户管理的账户中使用这个吗？ 对。使用您的经理帐户 LOGIN_CUSTOMER_ID 并传递客户的 customer_id 每次工具调用。

这会不小心花掉我的钱吗？ 否。所有写入操作都需要用户批准（通过Claude Code权限规则）。活动创建总是暂停开始。破坏性操作需要 confirm=true.

如果我达到API利率限制会发生什么？ burnr8通过以下方式跟踪使用情况 get_api_usage。使用基本访问时，每天15000次操作，大多数用户不会达到限制。仪表板显示当前使用情况。

______________________________________________________________________

支持

如果burnr8为你在谷歌广告上省钱，可以考虑给我买杯咖啡。

许可证

麻省理工学院