Fullrun — Google Ads For Ai Agents

面向 AI Agent 的 Google Ads 管理命令行工具。
支持 OpenClaw、Claude，以及任何能够运行 shell 命令的 Agent。

---

Fullrun 是一款为你管理 Google Ads 的 AI Agent。它全天候监控你的广告系列、诊断问题、调整出价、补充缺失的广告附加信息、暂停浪费预算的关键词，并自主创建新的广告系列。

这个命令行工具将同一套引擎带到了你的终端中。你（或你的 AI Agent）可以通过简单的命令管理 Google Ads，而不必使用 Fullrun 控制面板。每条命令都会自动检测运行环境：在终端中显示彩色输出，通过管道传递给其他程序时则输出结构化 JSON。

npm install -g fullrun
fullrun login frun_YOUR_API_KEY
fullrun triage

Agent 可以做什么

1. 诊断 — 运行 fullrun triage，获取按优先级排序的健康报告（CRITICAL → HIGH → MEDIUM → LOW）
2. 检查 — 列出广告系列、关键词和效果指标
3. 优化 — 运行 fullrun run，让 AI Agent 修复优先级最高的问题
4. 复查 — 再次运行诊断，确认修复是否生效

所有复杂工作——Google Ads API 调用、出价计算、预算防护措施和 PPC 最佳实践——都在服务端完成。这个命令行工具只是一个轻量客户端。你的设备上不会存储任何凭据。

命令

命令	说明
fullrun login <key>	使用 API 密钥进行身份验证
fullrun triage	生成账户健康报告并列出按优先级排序的问题
fullrun campaigns:list	列出广告系列及其状态、预算和指标
fullrun performance	账户指标——点击次数、转化次数、CPA
fullrun keywords:list	列出关键词及其效果数据
fullrun run	触发一次完整的 AI 优化运行

选项

• --format json — 强制输出 JSON（通过管道传递时的默认格式）
• --format human — 强制输出彩色终端内容（TTY 中的默认格式）
• --days <n> — 效果数据的回溯时长（默认值为 7，最大值为 90）
• --campaign <id> — 按广告系列筛选关键词

Agent 集成

OpenClaw

全局安装命令行工具后，OpenClaw 会通过附带的 SKILL.md 自动发现它：

npm install -g fullrun

然后告诉你的 Agent：“检查我的 Google Ads，并修复所有效果不佳的项目。”

Claude Code

SKILL.md 可用作 Claude Code 技能。Agent 会读取它，并了解如何使用每条命令。

MCP（Claude Desktop / Cursor）

{
  "mcpServers": {
    "fullrun": {
      "command": "npx",
      "args": ["@fullrun/mcp"],
      "env": {
        "FULLRUN_API_KEY": "frun_..."
      }
    }
  }
}

任何 Agent

任何能够执行 shell 命令的 Agent 都可以使用 Fullrun。输出会自动检测：通过管道传递时输出 JSON，在终端中则输出易于阅读的内容。

获取 API 密钥

1. 在 fullrun.app 注册
2. 关联你的 Google Ads 账户
3. 前往 设置 > API 密钥
4. 创建并复制密钥

工作原理

CLI / MCP / Agent
      │
      ▼
  Fullrun API (api key auth)
      │
      ▼
  Triage engine → Google Ads API
  Guardrails, bid caps, PPC rules

这个命令行工具不会直接操作 Google Ads。它会调用 Fullrun API，而 Fullrun API 运行的正是为 Web 控制面板提供支持的同一套诊断和优化引擎。所有防护措施（操作次数限制、出价上限、预算安全措施）均在服务端执行。

开发

git clone https://github.com/tuckerschreiber/fullrun-cli
cd fullrun-cli
npm install
npx tsx src/bin/fullrun.ts --help

许可证

MIT