Fullrun — Google Ads For Ai Agents

AI エージェント向けの Google Ads 管理 CLI です。
OpenClaw、Claude、およびシェルコマンドを実行できるあらゆるエージェントで動作します。

---

Fullrun は、Google Ads を管理する AI エージェントです。キャンペーンを24時間体制で監視し、問題を診断して入札単価を調整し、不足している広告表示オプションを追加し、無駄なキーワードを一時停止して、新しいキャンペーンを作成します。これらすべてを自律的に行います。

この CLI を使えば、同じエンジンをターミナルから利用できます。Fullrun のダッシュボードを使う代わりに、あなたまたは AI エージェントがシンプルなコマンドで Google Ads を管理できます。各コマンドは環境を自動検出します。ターミナルでは色付きで出力し、別のプログラムにパイプで渡す場合は構造化された JSON を出力します。

npm install -g fullrun
fullrun login frun_YOUR_API_KEY
fullrun triage

エージェントでできること

1. 診断 — fullrun triage を実行して、優先度順の健全性レポート（CRITICAL → HIGH → MEDIUM → LOW）を取得します
2. 確認 — キャンペーン、キーワード、パフォーマンス指標を一覧表示します
3. 最適化 — fullrun run を実行して、AI エージェントに最優先の問題を修正させます
4. 再確認 — 再度トリアージを行い、修正が機能したことを確認します

難しい処理はすべてサーバー側で実行されます。Google Ads API の呼び出し、入札単価の計算、予算のガードレール、PPC のベストプラクティスなどが含まれます。CLI はシンクライアントです。マシンに認証情報が保存されることはありません。

コマンド

コマンド	説明
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> — キャンペーンでキーワードを絞り込みます

エージェントとの連携

OpenClaw

CLI をグローバルにインストールすると、OpenClaw は同梱の SKILL.md を通じて自動検出します。

npm install -g fullrun

次に、エージェントに「Google Ads を確認して、パフォーマンスの低いものがあれば修正して」と伝えます。

Claude Code

SKILL.md は Claude Code のスキルとして機能します。エージェントはこれを読み込み、すべてのコマンドの使い方を把握します。

MCP（Claude Desktop / Cursor）

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

あらゆるエージェント

シェルコマンドを実行できるエージェントであれば、どれでも Fullrun を利用できます。出力は自動検出され、パイプで渡す場合は JSON、ターミナルでは人が読みやすい形式になります。

API キーの取得方法

1. fullrun.app でサインアップします
2. Google Ads アカウントを接続します
3. Settings > API Keys に移動します
4. キーを作成してコピーします

仕組み

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

CLI が Google Ads に直接アクセスすることはありません。Fullrun API を呼び出し、Web ダッシュボードを支えるものと同じトリアージおよび最適化エンジンを実行します。すべてのガードレール（変更数の上限、入札単価の上限、予算の安全対策）はサーバー側で適用されます。

開発

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

ライセンス

MIT