irinabuht12-oss/google-ads-meta-ads-mcp

Google Ads MCP server + Meta Ads MCP (Facebook Ads MCP) + Google Analytics MCP (GA4) + Search Console in one hosted remote MCP for Claude, ChatGPT, Cursor & n8n: OAuth login, no API keys, approval-gated writes, 7-day free trial. By Ryze AI.

このリポジトリは何か?

google-ads-meta-ads-mcp は、リモート Model Context Protocol (MCP) サーバーのソースコードです。3 つの主要な広告・分析 API を「ツール」として公開し、Claude、ChatGPT、Cursor、n8n、Windsurf などの AI アシスタントが呼び出せるようにします。

  • Google Ads API(キャンペーン、キーワード、入札、レポートなど)
  • Meta (Facebook/Instagram) Marketing API(キャンペーン、広告セット、クリエイティブ、オーディエンス、レポートなど)
  • Google Analytics 4 Data API(標準、リアルタイム、オーディエンス、プロパティ設定など)

サーバーはオープンソースの Model Context Protocol を実装しており、LLM が自然言語プロンプトでこれらのツールを呼び出せます。Ryze AI はサーバーを https://connector.get-ryze.ai/mcp でホストしています。リポジトリにはコード、ドキュメント、250 以上の利用可能なツールのカタログが含まれています。


誰が使うのか?

役割 重要性
マーケター / 代理店 単一のチャットベースのインターフェースから Google Ads、Meta Ads、GA4 を管理。書き込みアクセスは承認ステップで制御されます。
LLM 駆動のワークフロービルダー MCP エンドポイントを Claude、ChatGPT、Cursor、n8n、Windsurf などに接続し、広告作成、予算調整、パフォーマンス監査、クロスプラットフォームレポートを自動化。
AI エージェント開発者 MCP 仕様を使用して、OAuth、API キー、個別 SDK を扱うことなく、カスタムエージェントに豊富な広告ツールボックスを追加。
プロダクトチーム API を自己ホストせずに AI 駆動のキャンペーン管理を求める顧客に、ホスト型の「広告 as a Service」機能を提供。

主な機能(README に記載)

Google Ads(約 150 ツール)

  • 検索、ディスプレイ、ショッピング、Performance Max、Demand Gen、動画、アプリのキャンペーン CRUD
  • Keyword Planner によるキーワード調査(ボリューム、CPC、競合)
  • 入札・予算ツール、ポートフォリオ戦略、入札調整
  • クリエイティブ作成(レスポンシブ検索/ディスプレイ広告、Demand Gen 広告、アプリ広告)
  • オーディエンスターゲティング(カスタム、リマーケティング、カスタマーマッチ、組み合わせ)
  • 完全なパフォーマンス分析(指標、ROAS、検索語句、否定キーワードの提案)
  • 拡張機能(サイトリンク、コールアウト、電話、画像、価格、プロモーション、リードフォーム)
  • 実験と A/B テスト
  • コンバージョン測定の設定とアップロード

Meta Ads(約 80 ツール)

  • Facebook と Instagram にわたるキャンペーン、広告セット、クリエイティブの CRUD
  • 予算、スケジュール、プレースメント、最適化の制御
  • オーディエンスツール(カスタム、類似、興味/行動/人口統計)
  • リード獲得フォームと商品カタログ管理
  • ページ管理(投稿、ブースト投稿、インサイト)
  • ビジネスアカウント管理(ユーザー、ページ、ピクセル)
  • 詳細なパフォーマンスインサイトと内訳

Google Analytics 4(約 20 ツール)

  • 標準、ピボット、リアルタイムレポート
  • オーディエンス、セグメント、チャネルグループの一覧
  • プロパティ設定(データストリーム、拡張計測、保持)
  • アトリビューションモデル設定
  • イベントとコンバージョン管理
  • 統合リンク(BigQuery、DV360、検索広告、Firebase)
  • プロパティレベルの注釈とメタデータクエリ

クロスプラットフォーム機能

  • Google と Meta のキャンペーン間の ROAS 比較
  • 広告支出と GA4 コンバージョンイベントの相関
  • 統一された予算配分の推奨

接続方法(クイックスタート)

  1. コネクタ URL を追加(https://connector.get-ryze.ai/mcp)AI アシスタントの Connectors UI で(Claude Desktop、Claude Code、ChatGPT、Cursor、Windsurf、n8n など)。
  2. サインイン Google Ads/GA4 プロパティを所有する Google アカウントまたは Meta 広告アカウントを所有する Facebook アカウントで。サーバーは OAuth 2.1 + PKCE を処理します。開発者トークンや API キーは不要です。
  3. 書き込みを承認 – キャンペーン、予算、クリエイティブを変更する操作はすべてステージングされ、基盤となる API に送信される前に Ryze UI で承認する必要があります。
  4. プロンプトを開始 – アシスタントにキャンペーンの一覧表示、新しい広告の作成、GA4 レポートの取得などを依頼します。アシスタントは自然言語リクエストを適切な MCP ツール呼び出しに変換します。

README には、アシスタントごとのセットアップガイド(docs/SETUP_*.md)と各プラットフォームのサンプルプロンプトが用意されています。


制限と考慮事項

  • ホスト型サービス – サーバーは Ryze のインフラストラクチャで実行されます。サブスクリプション(有料広告プラン $89/月、7 日間無料トライアル)を使用する必要があります。コードはオープンソースですが、ホスト型エンドポイントは有料製品です。
  • 書き込みゲート – すべての書き込み操作は、予算の誤変更を防ぐために承認ステップを通過します。これにより手動チェックポイントが追加されます。
  • OAuth スコープ – コネクタは、ログインユーザーが管理権限を持つアカウントのみ操作できます。
  • レート制限 – 基盤となる Google および Meta API は独自の割り当てを強制します。大量の自動化には追加の割り当てリクエストが必要になる場合があります。
  • 機能の同等性 – リストは広範囲ですが、一部のニッチな Google Ads または Meta Marketing API 機能はまだ MCP ツールとしてラップされていない場合があります。

TL;DR

google-ads-meta-ads-mcp は、Google Ads、Meta Ads、GA4 API を単一のリモート MCP サーバーにバンドルし、AI アシスタントが自然言語ツールとして呼び出せるようにします。個別の API キー、開発者トークン、自己ホストサーバーの必要性を排除し、マーケターと AI エージェント開発者に読み取り/書き込みアクセス(承認付き)を提供します。リポジトリには、サーバー実装、250 以上のツールのカタログ、人気の LLM インターフェース向けのステップバイステップの接続ガイドが含まれています。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト