adops-mcp

Name: adops-mcp
Author: enzoemir1

ローカル

github.com/enzoemir1ビジネス・マーケティング07 週間前に更新

リポジトリ

adops-mcp について

AdOps MCPは、Google AdsとMeta Adsを利用する広告運用者向けに、エクスポートしたCSVをAIアシスタント内で横断分析します。API認証情報を使わず、予算提案、異常検知、テスト分析、予測を行えます。

主な機能

01Google AdsとMeta AdsのCSVをインポート
02複数プラットフォームの指標を統一
03予算提案と一括編集用エクスポート
04異常検知とA/Bテスト分析
05業界ベンチマークと支出予測
06ダッシュボード用リソース

活用シーン

01複数の広告プラットフォームでキャンペーンを分析
02クリック単価の急増やクリック率の低下を検知
03キャンペーン比較と予算配分の検討
04今後の支出とコンバージョンを予測

MCP 対応

MCPサーバーは広告分析ツールとダッシュボード用リソースをクライアントに提供します。CSVのインポートやキャンペーンデータの照会に加え、予算分析、異常検知、予測などを実行できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "enzoemir1-adops": {
      "command": "npx",
      "args": [
        "-y",
        "adops-mcp-server"
      ]
    }
  }
}

起動コマンドnpx -y adops-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmadops-mcp-server1.3.0stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

AdOps MCP

Google Ads と Meta Ads 向けの CSV 優先型分析・最適化を、Claude、Cursor、あらゆる MCP クライアントで実現します。

Google Ads または Meta Ads Manager から CSV をエクスポートして AdOps にインポートすれば、キャンペーンについてアシスタントに何でも質問できます。

OAuth も開発者トークンも不要です。API 承認待ちもありません。データはお使いのマシン上にとどまります。

CSV 優先型である理由

Google Ads API と Meta Marketing API は強力ですが、利用には制約があります。開発者トークンの承認には数日、Meta アプリの審査には数週間かかり、OAuth フローも不安定です。ほとんどの広告主にとって、こうした障壁を乗り越えるのは容易ではありません。

AdOps は異なるアプローチを採用しています。どの広告プラットフォームのダッシュボードにも、関心のある情報、つまりキャンペーンのパフォーマンス、日別の指標、費用、コンバージョン、ROAS を含む CSV を出力する ダウンロード／エクスポート ボタンがあります。AdOps はその CSV を読み取り、月額 200 ドルの最適化スイートで得られるのと同じ分析（異常検知、予算配分、A/B テストの有意性、予測、業界ベンチマーク）を、アシスタント内で直接実行します。

データの管理はご自身で行えます。第三者に認証情報を渡す必要はありません。審査に 3 週間も待つ必要はありません。

機能

17 個の MCP ツールで広告分析のライフサイクル全体をカバー
4 個の MCP リソースで概要ダッシュボードを表示
Google Ads Editor、Google Ads のウェブ UI、Meta Ads Manager から CSV をインポート — 形式を自動検出（米国式／欧州式の数値表記、CRLF と LF、BOM の処理）
統一されたクロスプラットフォームスキーマ — Google と Meta のキャンペーンを単一の UnifiedCampaign / UnifiedMetrics モデルに正規化
AI による推奨 — 予算の再配分、ROAS の高いキャンペーンの拡大、コンバージョンがゼロのキャンペーンの一時停止
一括編集用 CSV エクスポート — 推奨事項を、Google Ads Editor／Meta Ads Manager に貼り付けてダッシュボードでワンクリック一括更新できる CSV に変換
統計的な異常検知 — CPC の急上昇、CTR の低下、費用の急増を検出し、感度を設定可能
信頼度スコア付きの A/B テスト分析
9 業種（e コマース、SaaS、B2B など）の業界ベンチマークを標準搭載
費用とコンバージョンの予測（7 日／14 日／30 日）
デモモード — 現実的なポートフォリオを用意し、独自のデータをインポートする前にツールを試用可能
自動テスト 91 件 — TypeScript の strict モードを使用し、全体で Zod による検証を実施

クイックスタート

npm i adops-mcp-server

MCP クライアント（Claude Desktop の claude_desktop_config.json、Cursor、VS Code、Windsurf）に追加します。

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

クライアントを再起動します。その後、Claude 内で次を実行します。

> Seed demo data so I can explore AdOps

（ad_demo_seed を呼び出します）

または、実データをインポートします。

> Import ~/Downloads/google-ads-report.csv as a Google Ads CSV

（platform=google、csv_path=... を指定して ad_csv_import を呼び出します）

広告ダッシュボードから CSV をエクスポートする

Google Ads

ads.google.com を開き、キャンペーンビューに移動します
（任意）ツールバーの セグメント → 日 をクリックして、日別の指標を表示します
ダウンロード（⬇）アイコンをクリックし、.csv 形式を選択します
ディスクに保存し、ad_csv_import に絶対パスを指定します

Meta Ads Manager

business.facebook.com を開き、Ads Manager に移動します
キャンペーンタブに切り替えます（広告セットや広告ではなく、キャンペーン単位の集計を使用します）
（任意）内訳 → 時間 → 日 を選択して、日別の指標を表示します
レポート → エクスポート → キャンペーンのパフォーマンス（.csv） をクリックします
ディスクに保存し、ad_csv_import に絶対パスを指定します

どちらのエクスポートも、日別のセグメント化の有無にかかわらず、そのまま利用できます。「日」列がない場合は、キャンペーンごとに集計された指標が 1 行ずつ出力されます。「日」でセグメント化した場合は日別の時系列データが得られ、これにより予測と異常検知が適切に機能します。

ツール

ツール	説明
`ad_demo_seed`	リアルなクロスプラットフォームのデモ用ポートフォリオ（8 件のキャンペーン、30 日分の指標）を用意し、実データをインポートする前に AdOps を試せます
`ad_csv_import`	Google Ads または Meta Ads の CSV エクスポートをインポートします — ほかのすべてのツールはこのデータを使用します
`ads_export_recommendations`	budget_analyze の推奨事項を Google Ads Editor CSV、Meta Ads Manager CSV、JSON、または Markdown としてエクスポートします — 一括貼り付けするだけで、広告ダッシュボードに AI のプランが反映されます
`platform_connect`	データソースへの接続を手動で登録します（CSV インポートの代替手段で、スクリプト化されたワークフローに便利です）
`campaign_list`	インポート済みのすべてのプラットフォームにわたってキャンペーンを一覧表示し、絞り込みます
`campaign_create`	キャンペーンを手動で追加します（仮定のプランニングに便利です）
`campaign_update`	ローカルストレージのキャンペーン設定（予算、ステータス、入札、スケジュール）を更新します
`campaign_pause_resume`	最大 50 件のキャンペーンを一括で一時停止または再開します
`ads_report`	クロスプラットフォームの統合パフォーマンスレポートを生成します
`budget_analyze`	予算配分を分析し、予算の拡大・一時停止に関する推奨事項を作成します
`budget_reallocate`	プラットフォームをまたいでキャンペーン間の予算を移動します
`audience_insights`	人口統計／地域／デバイス別の内訳を表示します
`creative_specs`	プラットフォーム固有の画像、動画、テキストの要件を参照します
`anomaly_detect`	感度を設定してパフォーマンスの異常を検出します
`ab_test_analyze`	統計的有意性の検定を行い、2 つのキャンペーンを比較します
`competitor_benchmark`	業界平均（9 業種）と自社の指標を比較します
`forecast_spend`	今後 7／14／30 日間の費用、コンバージョン、ROAS を予測します

リソース

リソース	説明
`ads://overview`	クロスプラットフォームのダッシュボード概要
`ads://campaigns`	主な指標を含む、すべての有効なキャンペーン
`ads://budget`	プラットフォーム間の予算配分
`ads://alerts`	最近のパフォーマンス異常と警告

統合指標スキーマ

AdOps はプラットフォーム間で指標を正規化します。

指標	計算式	備考
CTR	clicks / impressions × 100	クリック率（％）
CPC	spend / clicks	クリック単価
CPM	spend / impressions × 1000	インプレッション 1,000 回あたりの費用
ROAS	conversion_value / spend	広告費用対効果
CPA	spend / conversions	顧客獲得単価
コンバージョン率	conversions / clicks × 100	％

CSV 列のマッピング：

AdOps フィールド	Google Ads CSV	Meta Ads CSV
`spend`	`Cost`（マイクロ単位の場合、USD 相当額に自動変換）	`Amount spent (USD/EUR/...)`
`impressions`	`Impressions`	`Impressions`
`clicks`	`Clicks`	`Link clicks`
`conversions`	`Conversions`	`Results`（購入／リードなど）
`conversion_value`	`Conv. value`	`Purchases conversion value`
`reach`	—	`Reach`（Meta 専用）
`quality_score`	`Quality Score`（存在する場合）	—（Google 専用）

ヨーロッパ形式の数値（125,50 = 125.50）とセミコロン区切りの CSV は自動検出されます。

設定

AdOps はネットワークから見てステートレスです — API キーも OAuth も必要ありません。設定項目は、インポートしたデータの保存先のみです。

変数	説明	デフォルト
`ADOPS_DATA_DIR`	JSON 永続化用のディレクトリ	`./data`

その他の動作はすべてツールの引数で制御します。

料金

プラン	価格	機能
無料	$0	1 日あたり CSV 1 件のインポート、デモモード、読み取り専用の全 17 ツール
Pro	€24（買い切り）	インポート無制限、完全な CRUD、すべての分析ツール
Agency	$59/mo	マルチアカウント、ホワイトラベルレポート、優先サポート

GitHub（セルフホスト可能、無料）または MCPize マーケットプレイス（マネージド）から利用できます。

開発

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci
npm run build
npm test           # 91 tests across 10 suites
npm run inspect    # Open MCP Inspector

テスト

91 件のテストで、以下を網羅しています。

CSV パーサー（11 件のテスト）：RFC 4180 の引用符処理、BOM、欧州／米国の数値形式、区切り文字の検出
Google Ads CSV インポート（7 件のテスト）：キャンペーンレポート、日別セグメント、目標のマッピング、欧州ロケール
Meta Ads CSV インポート（5 件のテスト）：Meta 固有の列、ヘッダーからの通貨検出、目標のマッピング、リーチ／フリークエンシーの取得
推奨事項のエクスポート（8 件のテスト）：Google Ads Editor の CSV 形式、Meta Ads Manager の CSV 形式、JSON ラッパー、Markdown レンダリング、min_delta_pct フィルター、上限、by_type の集計
ストレージ：接続の CRUD、キャンペーン検索、指標の集計、一括挿入
分析：指標の計算、パフォーマンスレポート、予測、ベンチマーク
オプティマイザー：予算分析、再配分、予算の拡大／一時停止の推奨事項
異常検出：CPC の急上昇検出、コンバージョンの減少、感度、深刻度による並べ替え
E2E ワークフロー：実際のユーザーシナリオ 14 件

ロードマップ

v1.3 — Google Ads Editor の .csv.gz と Excel の .xlsx に対応
v1.4 — オプションのエンタープライズ機能として Google Ads／Meta Ads API とライブ連携（BYOK — 開発者トークンの持ち込みとアプリ審査が必要）
v2.0 — チームでのデプロイ向けに、JWT 認証を備えたマルチユーザーサーバーモードを追加

Pro ライセンス

AdOps は無料モードで提供されます。ad_demo_seed、ad_csv_import、platform_connect、campaign_list、campaign_create、campaign_update、campaign_pause_resume、ads_report、budget_reallocate、audience_insights、creative_specs はオープンです。以下のツールにはPro ライセンスが必要です。

ads_export_recommendations — Google Ads Editor／Meta Ads Manager 向けの一括編集用 CSV エクスポート
budget_analyze — アクションの推奨事項を含む、AI による予算配分分析
anomaly_detect — 統計的な異常検出
ab_test_analyze — 有意性とリフトを判定する A/B テストの Z 検定
forecast_spend — 7／14／30 日間の支出と ROAS の予測
competitor_benchmark — 業界ベンチマークとの比較

Pro ライセンスを購入する（24 ユーロ、買い切り、3 台）： https://automatiabcn.lemonsqueezy.com/buy/1525c929-832c-4472-a88a-58edbfa4e87b

または、Indie MCP Stack Bundle（69 ユーロ、全 4 サーバー）を入手してください。

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

または、MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "adops-mcp": {
      "command": "npx",
      "args": ["-y", "adops-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

検証結果はローカルに 24 時間キャッシュされるため、初回実行後は完全にオフラインで利用できます。

ライセンス

MIT ライセンスです。詳細は LICENSE をご覧ください。

Automatia BCN が開発しました。

Markdown 対応

ログインしてコメント

基本情報

作者: enzoemir1
言語: node
バージョン: 1.3.0
トランスポート: stdio
掲載日: 2026年4月22日
最終更新: 7 週間前
公式 Registry: io.github.enzoemir1/adops-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。