kLOsk/adloop

Google 広告と GA4 を AI アシスタントから直接操作できる MCP サーバー。安全性を備えた読み書きアクセスで、広告管理とトラッキング監査を自動化します。

インストール型ツール自由に使える · MITマーケティング・グロースPython難易度
2730 保存
63フォーク10Issue
デモ・公式サイトをひらくgetadloop.com

中辛 の解説

Python ベースで Cursor や Claude Code、Claude Desktop など MCP 対応の IDE から使える API ラッパーです。Google 広告 API v24、GA4 Data API、Google Tag Manager API、Search Console API に加えて、PageSpeed Insights と Merchant Center にも対応しています。セットアップは 5 分で、pip install adloop && adloop init で自分の Google Cloud プロジェクトと連携。AI に読み取り・書き込み権限を与えますが、新しいキャンペーンや広告はデフォルトで一時停止状態で作られ、すべての変更は確認・承認フローを通すので暴走リスクはありません。ダッシュボード要らずに会話から実行できるのが利点。

こんなリポジトリです

こんなときに便利です

  • コンバージョン数が減った原因を GDPR 同意拒否・トラッキング破損・ランディングページ問題から自動判定して特定したいとき。
  • 検索キーワード報告書からムダな検索用語を抽出し、会話だけでネガティブキーワードを追加して広告費を削減したいとき。
  • コードに埋め込んだイベント名と GTM タグ設定と GA4 実発火を 3 点照らし合わせて、トラッキングの完全性監査をしたいとき。

主な機能

複数 API の自動結合診断(Ads クリック ↔ GA4 セッション ↔ GTM タグ ↔ 実発火)草案 → プレビュー → 確認実行の 3 段階変更フローGDPR 同意拒否を自動考慮した精密なコンバージョン分析

ほかとの違い

GA4・Ads・GTM・Search Console の複数 API を内部で結合し、単一 API ラッパーでは見抜けない根本原因(GDPR 同意ギャップ、タグ一時停止、ページスコープ制限)を 1 回の呼び出しで診断できます。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Python 3.11 以上
  • Google Ads アカウント(MCC 管理画面所有者)
  • Google Ads 開発者トークン(API Center から取得)
  • Google Cloud プロジェクト(無料、`adloop init` が自動作成をガイド)

すぐに始める

  1. Python 3.11 以上と pip をインストール済みであることを確認。
python --version
  1. pip から AdLoop をインストール。
pip install adloop
  1. init ウィザードを実行し、Google Cloud プロジェクトと Google Ads 開発者トークンを設定。
adloop init
  1. ウィザードの指示に従い、Google Cloud での OAuth クライアント作成、Google Ads MCC から開発者トークン取得、MCC アカウント ID 入力、ブラウザでの Google サインインを完了。
  2. ウィザード完了後、Cursor や Claude Code に MCP 設定スニペットを貼り付けて接続。
  3. AI アシスタントと会話を開始し、「キャンペーン一覧を取得」「最近のコンバージョン率を確認」などのコマンドを実行。

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try kLOsk/adloop

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

これを仕事に活かす

味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。

レシピ — AI にこのまま頼んでみてください

レシピを読み込んでいます…

スター推移 · 7日

2737日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 52/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「マーケティング・グロース」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/kLOsk/adloop.svg)](https://www.gitbap.com/r/kLOsk/adloop)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る