AdOps MCP

Model Context Protocol向けのAI駆動型クロスプラットフォーム広告管理

License: MIT TypeScript MCP

Google AdsおよびMeta Adsのキャンペーン管理、クロスプラットフォームのパフォーマンス分析、予算最適化、異常検知を、Claude、Cursor、VS CodeなどのAIアシスタントを通じて実行できます。

機能

Google AdsとMeta Adsの統合キャンペーン管理
広告ライフサイクル全体をカバーする14個のMCPツール
ダッシュボードに素早くアクセスできる4個のMCPリソース
正規化された指標によるクロスプラットフォームのパフォーマンスレポート
実用的な推奨事項を提示するAI駆動の予算最適化
統計的な異常検知（CPCの急騰、CTRの低下、支出の急増など）
信頼スコア付きのA/Bテスト分析
業界ベンチマーク比較（9業種）
支出とコンバージョンの予測（7/14/30日間）
プラットフォーム固有のクリエイティブ仕様リファレンス
42個の自動テスト（ユニットテスト + E2Eユーザーワークフロー）、TypeScript厳格モード、Zodバリデーション

クイックスタート

npmからインストール

npm i adops-mcp-server

MCPクライアントに追加

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

ソースからビルド

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

ツール

ツール	説明
`platform_connect`	Google AdsまたはMeta Adsアカウント接続の登録
`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`	業界平均と自社の指標を比較
`forecast_spend`	次期間の支出、コンバージョン、ROASを予測

リソース

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

設定

すべての統合はオプションです。APIキーなしでも、ローカルストレージを使用してキャンペーン管理や分析を行うことができます。

変数	プラットフォーム	必須	説明
`GOOGLE_ADS_DEVELOPER_TOKEN`	Google	ライブ同期用	APIデベロッパー・トークン
`GOOGLE_ADS_CLIENT_ID`	Google	ライブ同期用	OAuth2クライアントID
`GOOGLE_ADS_CLIENT_SECRET`	Google	ライブ同期用	OAuth2クライアントシークレット
`GOOGLE_ADS_REFRESH_TOKEN`	Google	ライブ同期用	OAuth2リフレッシュ・トークン
`GOOGLE_ADS_CUSTOMER_ID`	Google	ライブ同期用	広告アカウントID（10桁）
`META_APP_ID`	Meta	ライブ同期用	FacebookアプリID
`META_APP_SECRET`	Meta	ライブ同期用	Facebookアプリシークレット
`META_ACCESS_TOKEN`	Meta	ライブ同期用	システムユーザーアクセストークン
`META_AD_ACCOUNT_ID`	Meta	ライブ同期用	広告アカウントID（act_XXX）

完全なテンプレートについては .env.example を参照してください。

統合指標

AdOpsはプラットフォーム間の指標を単一のスキーマに正規化します：

指標	計算式	説明
CTR	クリック数 / インプレッション数 x 100	クリック率 (%)
CPC	支出 / クリック数	クリック単価
CPM	支出 / インプレッション数 x 1000	1000インプレッションあたりのコスト
ROAS	収益 / 支出	広告費用対効果
CPA	支出 / コンバージョン数	獲得単価
コンバージョン率	コンバージョン数 / クリック数 x 100	コンバージョン率 (%)

プラットフォームのフィールドマッピング：

AdOpsフィールド	Google Ads	Meta Ads
`spend`	`cost_micros / 1,000,000`	`amount_spent`
`impressions`	`impressions`	`impressions`
`clicks`	`clicks`	`clicks`
`conversions`	`conversions`	`actions[type=purchase]`
キャンペーン > 広告グループ	Ad Group	Ad Set

料金

プラン	価格	機能
Free	$0	1プラットフォーム、読み取り専用レポート、クリエイティブ仕様、50回/日の呼び出し
Pro	$29/月	2プラットフォーム、フルCRUD、異常検知、予算最適化
Agency	$59/月	無制限、予測、ベンチマーク、優先サポート

MCPize で利用可能です。

開発

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

テスト

5つのテストスイートにわたる42個のテスト：

ストレージ: 接続CRUD、キャンペーン検索、指標集計、バッチ挿入
分析: 指標計算、パフォーマンスレポート、予測、ベンチマーク
オプティマイザー: 予算分析、再配分、スケーリング/一時停止の推奨
異常検知: CPC急騰検知、コンバージョン低下、感度レベル、重大度ソート
E2Eワークフロー: 14個の実際のユーザーシナリオ — プラットフォーム接続、キャンペーン作成、レポート生成、予算最適化、A/Bテスト実行、異常検知、支出予測、業界ベンチマーク比較

npm test

ライセンス

MITライセンス。詳細は LICENSE を参照してください。

Automatia BCN によって構築されました。

adops-mcp