Orbiads

OrbiAds — Google Ad Manager MCP Server

英語 · フランス語

_{AI エージェント向けのホスト型 MCP に加え、ターミナルおよび CI ワークフロー向けの Python CLI を提供します。}

OrbiAds は、AI アシスタント（Claude、ChatGPT、Gemini、Cursor、OpenAI Codex）に Google Ad Manager への直接的な自然言語アクセスを提供する、ホスト型の Google Ad Manager MCP サーバーです。 キャンペーン、オーダー、広告申込情報、クリエイティブ、広告枠、ターゲティング、レポートにわたる 270 以上の操作に対応し、**最新の GAM API（v202605）**を使用します。また、OAuth と、書き込み前に確認を求めるガードレールを備えています。

→ orbiads.com で無料で始める · ★ このリポジトリにスターを付ける

---

3 分で試す

ホスト型 MCP、ローカルへのインストール不要

1. orbiads.com で無料の OrbiAds アカウントを作成し、Google Ad Manager に接続します。
2. この MCP エンドポイントを Claude、ChatGPT、Gemini、Cursor、Codex、Warp に追加します。

   https://orbiads.com/mcp
   

3. エージェントに質問します。

   Connect to my GAM account and show me my active networks.
   

CLI のスモークテスト

pip install orbiads-cli
orbiads auth login
orbiads network info

詳しいセットアップ方法については、CLI ガイドまたはエージェントのインストールガイドをご覧ください。

---

信頼性を示す情報

項目	状態	リンク
公開リポジトリ	OrbiAds MCP の配布版を MIT ライセンスでミラーリング	LICENSE
PyPI CLI	ターミナルおよび CI ワークフロー向けに orbiads-cli として公開	pypi.org/project/orbiads-cli
ホスト型 MCP	OAuth 対応のリモート Streamable HTTP エンドポイント	https://orbiads.com/mcp
Glama	MCP レジストリに登録済みのページ	glama.ai
MCP.so	MCP ディレクトリに登録済みのページ	mcp.so
公式 MCP レジストリ	レジストリへの公開に対応した server.json マニフェスト	server.json
Smithery	ホスト型／外部 MCP の掲載申請先を準備済み	smithery.ai/new
安全モデル	書き込み操作では、計画 → 確認 → 実行の順に進みます	安全性に関するドキュメント

---

2 つの接続方法

OrbiAds は 2 つの統合方法を提供しています。ワークフローに合った方法を選択してください。

オプション A：MCP サーバー（AI エージェント）

ホスト型 MCP エンドポイント経由で、AI アシスタント（Claude、ChatGPT、Gemini）を GAM に接続します。会話形式で、案内付き、インストール不要です。

MCP endpoint: https://orbiads.com/mcp

オプション B：CLI（ターミナルとスクリプト）

開発者、CI/CD パイプライン、ヘッドレス自動化向けの軽量な Python CLI です。同じ API、同じクレジット、同じ安全対策を利用できます。

pip install orbiads-cli
orbiads auth login
orbiads network info

重要

Windows/macOS/Linux の PATH に関する警告：pip（特に --user を指定した場合）で CLI をインストールする場合は、Python のスクリプトディレクトリがユーザーの PATH に追加されていることを確認してください。追加されていないと、ターミナルやローカルの AI エージェント（Claude Code、Cursor、Gemini など）が orbiads コマンドを見つけられず、実行に失敗します。すぐに設定するコマンドについては、CLI ガイドのトラブルシューティングのセクションを参照してください。

比較

基準	MCP サーバー	CLI
インターフェース	AI エージェント（Claude、ChatGPT、Gemini）	ターミナル／コマンドライン
インストール	エージェントの設定に貼り付ける URL	pip install orbiads-cli
認証	ブラウザー経由の OAuth（自動）	OAuth デバイスフロー（コードを表示）
最適な用途	探索、会話、ガイド付きワークフロー	スクリプト、CI/CD、ヘッドレス自動化
出力形式	エージェント経由の自然言語	JSON または構造化テーブル
クレジット	同じ消費量の基準	同じ消費量の基準
オフライン	いいえ — インターネット接続が必要です	いいえ — インターネット接続が必要です
Python の要否	いいえ	はい（3.10 以降）

どちらの方法も、同じバックエンド、クレジット、安全対策を共有します。

CLI クイックリファレンス

コマンド	説明
orbiads auth login	Google OAuth デバイスフローで認証します
orbiads auth status	認証状態を確認します
orbiads network info	現在の GAM ネットワークの詳細を表示します
orbiads network list	アクセス可能な GAM ネットワークを一覧表示します
orbiads orders list	ネットワーク内のオーダーを一覧表示します
orbiads line-items list --order ID	オーダーの広告申込情報を一覧表示します
orbiads creatives list	クリエイティブを一覧表示します
orbiads inventory ad-units	広告ユニットを一覧表示します
orbiads forecast check --ad-unit ID	広告枠の在庫状況を確認します
orbiads report run --template ID	配信レポートを実行します

コマンドの全リファレンス：orbiads.com/docs/cli/commands

---

インストールガイド

OrbiAds では、環境に応じて 3 つの連携方法を利用できます。

1. インストール不要の MCP サーバー（ChatGPT、Gemini、Claude Desktop）

Model Context Protocol を使用して、AI アシスタントを当社のホスト型サーバーに接続します。

• Claude Desktop：以下を claude_desktop_config.json に追加します。

  {
    "mcpServers": {
      "orbiads": {
        "type": "http",
        "url": "https://orbiads.com/mcp"
      }
    }
  }
  

• Gemini / AI Studio：Tools → MCP configuration → Add https://orbiads.com/mcp の順に移動します。
• ChatGPT：Settings → Connectors → Add connector → MCP URL: https://orbiads.com/mcp の順に移動します。
• GLAMA / MCP Registry：glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP から、ブラウザーでサーバーに直接アクセスしてテストし、接続できます。
• その他の環境（Cursor、Codex、Warp）：https://orbiads.com/mcp エンドポイントを設定に追加し、AGENTS.md をプロジェクトのルートにコピーします。

2. Claude Code プラグイン（スラッシュコマンド）

Claude Code の CLI ターミナルに /adops コマンドセットを直接追加します。

claude plugin install orbiads

3. エージェントスキル（構造化ワークフロー）

Markdown ベースのガイドラインを Claude Code のメモリに永続的にインストールします。

1. このリポジトリをローカルにクローンします。
2. スキルインストーラーを実行します。

   ./install.sh skills --copy
   

これにより、統合された 6 つのスキルファイルが ~/.claude/skills/ ディレクトリにコピーされます。Claude Code はこれらを自動的に活用し、ハルシネーションを防ぎ、変更前に計画を立てるワークフローを厳密に適用します。

→ インストールガイド：Claude · ChatGPT · Gemini · OpenAI Codex

---

OrbiAds とは？

OrbiAds は、AI アシスタントを Google Ad Manager（GAM）に直接接続するホスト型の MCP サーバー です。GAM のインターフェースを操作したり、API スクリプトを作成したりする代わりに、実行したい内容を自然な言葉で伝えるだけで、OrbiAds が API 呼び出し、ガードレール、監査記録を処理します。

You: "Check inventory availability on the homepage banner for a 300x250 in France next week"
OrbiAds: [runs forecast] → Available: 1.2M impressions. Pressure: low. Safe to traffic.

You: "Create the line item for Renault, €15 CPM, Monday to Friday"
OrbiAds: [applies guardrails] → Preview ready. Confirm to push?

スクリプトは不要です。API トークンを管理する必要もありません。タブを切り替える必要もありません。

---

対象ユーザー

• 広告運用マネージャー：毎日キャンペーンを運用し、ミスを避けながら作業を効率化したい方
• パブリッシャー：自社の GAM ネットワークを管理し、AI を活用したワークフローを実現したい方
• メディアエージェンシー：複数の GAM アカウントを運用し、一貫性のある監査可能なプロセスを求める方
• 開発者：Claude、ChatGPT、Gemini を基盤に、広告運用の自動化を構築する方

---

対応 AI プラットフォーム

プラットフォーム	セットアップガイド	モード
Claude（デスクトップ／claude.ai／Claude Code）	docs/install/claude.md	プラグイン + MCP リモート
ChatGPT（Pro コネクター）	docs/install/chatgpt.md	MCP リモート（HTTP）
Gemini	docs/install/gemini.md	MCP リモート
GLAMA（MCP レジストリ）	glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP	MCP レジストリ
Cursor / Codex / Warp / その他	AGENTS.md	AGENTS.md + MCP 接続

すべてのプラットフォームは、同じホスト型 MCP エンドポイント https://orbiads.com/mcp に接続します。

---

7 つのスラッシュコマンド

プラグインをインストールすると、これらの /adops コマンドを Claude Code から直接利用できます。

コマンド	機能
/adops campaign	ライブ状態の確認、配信計画の作成、ドライラン（ExecutionPlan）、配信、停止、ロールバックを実行します。必須の計画→確認→実行ゲートを備えています
/adops audit	配信、広告枠、セキュリティ、クリエイティブ、請求に関する多角的なアカウント監査を行います
/adops report	カスタムレポート、配信クエリ、CSV エクスポート、請求サマリー、予測を提供します
/adops deal	PMP 取引、プライベートオークション、Marketplace PG/PD の提案を扱います
/adops creative	クリエイティブのアップロード、QA 準拠確認、SSL 検証、プレビュー URL、広告申込情報との関連付けを行います
/adops inventory	広告ユニットの閲覧、プレースメントとターゲティング分類の管理、ブループリントの実行を行います
/adops admin	チーム、サイト、ラベル、カスタムフィールド、ネットワーク設定を管理します（MCP サーフェスのみ）

含まれる内容（MCP ツールとスキル）

OrbiAds のインターフェースは、Google Ad Manager API を親ツールと数百のアクションにマッピングし、オーケストレーターに加えて、6 つの主要なドメイン別エージェントスキルに整理することで、コンテキストの使用を効率化します。生成されたツールとアクションの最新件数については、docs/tool-matrix/README.md をご覧ください。

以下のドメインをクリックすると、含まれるツールと機能を確認できます。

1. キャンペーンとクリエイティブの QA（orbiads-campaigns）

• campaign — キャンペーンの最新の状態を読み取り、デプロイを計画し、ドライラン、デプロイ、一時停止、ロールバックを行います。
• orders — 注文、連絡先、ロールを作成して一覧表示します。
• line_items — ラインアイテムの配信ルール、CPM、ターゲティングロジックを定義します。
• creatives — クリエイティブ（画像、HTML5、動画／音声）をアップロードし、ネイティブスタイルを設定します。
• creative_assets — 関連する画像やファイルのアセットを管理します。
• creative_qa — クリックトラッカーを監査し、コンプライアンススキャンを実行して、SSL 証明書を検証します。
• creative_wrapper_skill — サードパーティのラッパーと配信プリセットを管理します。
• formats — 広告クリエイティブ形式を確認して設定します。
• jobs と gam_jobs — 非同期のキャンペーンコンパイルとデプロイのワークフローを監視します。

2. インベントリとターゲティング（orbiads-inventory）

• inventory — 広告ユニットのツリーやサイズを取得し、ads.json マニフェストを生成します。
• placements — 広告プレースメントグループを作成、更新、一覧表示します。
• targeting — カスタムターゲティングキー／値、国、カテゴリを管理します。
• audiences — ファーストパーティのオーディエンスセグメントを取得して変更します。
• blueprint — 構造化されたネットワークインベントリのブループリントを生成してプッシュします。

3. レポートと予測（orbiads-reporting）

• reporting — テンプレートからカスタムレポートを実行し、ラインアイテムの配信状況を確認して、GA4 と連携します。
• preview — インベントリのカバー範囲を検証し、プレビュー URL をエクスポートします。
• pql — 生の PQL データベースクエリを実行します。

4. プログラマティックディール（orbiads-deals）

• deals — PMP ディール、プライベートオークション、マーケットプレイスのバイヤーを管理します。
• companies — 代理店および広告主の企業プロフィールを管理します。

5. ネットワーク管理（orbiads-admin）

• gam_admin — 高度なフィールド、ネットワークラベル、チーム、サイトのレコードにアクセスします。
• gam_features — 有効な Google Ad Manager のベータ機能とシステム機能を照会します。
• network — アクセス可能なネットワークを一覧表示し、アクティブなネットワークのコンテキストを切り替えます。
• settings — デフォルトの CPM、ペーシング、ブランド名のテンプレートを設定します。
• tenant_catalog — テナント固有のカタログにアクセスします。

6. 監査と請求（orbiads-audit）

• audit_skill — セキュリティ、衛生状態、ラッパーのカバー範囲を自動監査します。
• billing — クレジット残高と取引履歴を取得します。
• audit — ネットワーク監査ログを検索します。

270 件を超えるすべてのアクションについて、正確なコスト、書き込み操作、パラメーターを詳しく示した完全なパリティマトリックスは、docs/tool-matrix/README.md をご覧ください。

---

設計による安全性

すべての書き込みアクションでは、明示的な ExecutionPlan のプレビューと確認トークンが必要です。キャンペーンが誤って公開されることはありません。

• 変更前に計画 — キャンペーン、ディール、プロダクトへの書き込みでは、プッシュする前に署名済みの ExecutionPlan をプレビューします
• ドライランモード — すべてのデプロイアクションで利用でき、confirmationToken の有効期間は 300 秒です
• 予測ゲート — インベントリを確定する前に、利用可能状況を事前に検証します
• 監査証跡 — すべてのアクションについて、実行者、内容、日時、結果を記録します
• クレジットガード — 読み取り操作は常に無料で、書き込みではクレジットが透明性をもって差し引かれます

---

クイックスタート（3 ステップ）

1. 無料アカウントを作成する

orbiads.com にアクセスして登録します。5 クレジットを無料で利用できます。クレジットカードは不要です。

2. Google Ad Manager に接続する

OrbiAds ダッシュボードで Connect GAM をクリックし、Google アカウントで認証します。OrbiAds は OAuth を使用するため、GAM の認証情報が Google のインフラストラクチャ外に出ることはありません。

3. AI アシスタントを設定する

プラットフォームを選択し、ガイドに従ってください。

• Claude の設定 →
• ChatGPT の設定 →
• Gemini の設定 →
• その他のツール（Cursor、Codex、Warp）→

次のように始めましょう。

「GAM アカウントに接続して、アクティブなネットワークを表示してください」

---

MCP サーバーの詳細

プロパティ	値
エンドポイント	https://orbiads.com/mcp
トランスポート	streamable-http（デフォルト）・sse
認証	OAuth 2.0 — OrbiAds 経由の Google アカウント
GAM API バージョン	v202605
MCP プロトコル	2025-03-26

---

リポジトリ構成

skills/           ← orchestrator skill + 6 consolidated dual-surface domain skills (generated)
                     Each domain skill has SKILL.md (thin) + references/actions.md (full catalogue)
commands/         ← 7 /adops slash commands for Claude Code
agents/           ← Parallel audit subagents (audit-delivery, audit-inventory, …)
hooks/            ← Claude Code hooks (hooks.json)
cli/              ← OrbiAds CLI package (pip install orbiads-cli)
docs/             ← Installation guides, tool matrix, custom-skill authoring guide
_docs/            ← Internal: legacy tool mapping, anti-collision rules
.claude-plugin/   ← Claude plugin manifest (plugin.json, marketplace.json)
AGENTS.md         ← Cross-LLM contract for Cursor, Codex, Gemini, Warp, etc.
CLAUDE.md         ← Claude Code project guidance

スキルとツールマトリックスは、バックエンドのカタログから自動生成されます。手動で編集しないでください。自動生成ファイルと手動作成ファイルの内訳については、CLAUDE.md を参照してください。

---

料金

プラン	価格	クレジット
トライアル	無料	5 クレジット（カード不要）
スターター	€39/月	50 クレジット/月
早期アクセス	€29/月 ← 永久に固定	50 クレジット/月
パック S	€29（買い切り）	+50 クレジット
パック L	€45（買い切り）	+100 クレジット

読み取りは常に無料です。クレジットは書き込みとデプロイの操作でのみ消費されます。

無料で始める →

---

ライセンス

このリポジトリの内容（配布用スキャフォールド、スキル、エージェント、ワークフロー、JSON スキーマ、CLI クライアント、プラットフォーム統合マニフェスト、ドキュメント、サンプル）は、MIT ライセンスに基づいて公開されています。

ホストされたエンドポイント https://orbiads.com/mcp が接続する OrbiAds MCP サーバーのバックエンドおよび Cloud Run サービスは、このリポジトリには含まれておらず、別途定められた独自の利用条件が適用されます。orbiads.com の利用条件を参照してください。