MCPによるAIを活用した広告管理。8つのプラットフォーム間で232ツール — Google Ads、Meta Ads、GA4、検索コンソール、タグマネージャ、Matomo、Bing Webmaster、およびPageSpeed Insights。

オープンソース 1つのサーバー。 Claude、Cursor、Windsurf、およびMCPクライアントで動作します。

プラットフォーム

| プラットフォーム | プレフィックス | ツール | Auth | お問い合わせ | Google Ads | [[T0] | 81 | OAuth(ブラウザ) | | メタ広告 | meta_ | 40 | OAuth(ブラウザ) | | Google Analytics(GA4) | [[T2] | 31 | OAuth(ブラウザ) | | Google Search Console | [gsc_ | 18 | OAuth(ブラウザ) | | Googleタグマネージャ | [[T4] | 14 | OAuth(ブラウザ) | | マトモ・アナリティクス | matomo_ | 24 | APIトークン | | ビーイングウェブマスターツール | [bing_ | 21 | APIキー | | PageSpeed Insights | [[T7] | 3 | API キー(オプション) |

インストール

クイックスタート

MCP クライアント config に追加 (例 ~/.claude/mcp_servers.json])):

または直接実行して下さい:

設定

[[~/.unified-ads-mcp/] に存在する全ての設定ファイル。 このディレクトリを最初に作成します。

OAuth トークンは、最初のブラウザベースの認証後に自動的にキャッシュされます。

##Google広告

[~/.unified-ads-mcp/google-ads.yaml を作成します

Aidvertaiser

AI-powered advertising management via MCP. 232 tools across 8 platforms — Google Ads, Meta Ads, GA4, Search Console, Tag Manager, Matomo, Bing Webmaster, and PageSpeed Insights.

Open source. One server. Works with Claude, Cursor, Windsurf, and any MCP client.

Platforms

Installation

# From source
git clone https://github.com/Draivix/aidvertaiser.git
cd aidvertaiser
uv sync

Quick Start

Add to your MCP client config (e.g. ~/.claude/mcp_servers.json):

{
  "aidvertaiser": {
    "command": "uv",
    "args": ["run", "--directory", "/path/to/aidvertaiser", "unified-ads-mcp"]
  }
}

Or run directly:

uv run unified-ads-mcp

Configuration

All config files live in ~/.unified-ads-mcp/. Create this directory first:

mkdir -p ~/.unified-ads-mcp

OAuth tokens are cached here automatically after first browser-based authentication.

Google Ads

Create ~/.unified-ads-mcp/google-ads.yaml:

developer_token: YOUR_DEVELOPER_TOKEN
client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
login_customer_id: YOUR_MCC_ID          # Optional, for MCC access
default_customer_id: YOUR_CUSTOMER_ID   # Optional, skip account listing

Env var override: GOOGLE_ADS_CREDENTIALS=/path/to/google-ads.yaml

Tip: Set ONLY_DEFAULT_ACCOUNT=1 to disable google_list_accounts and force using the default customer ID everywhere. Useful when you only manage one account.

Meta Ads

Create ~/.unified-ads-mcp/meta-ads.yaml:

app_id: YOUR_APP_ID
app_secret: YOUR_APP_SECRET
access_token: YOUR_TOKEN              # Optional, bypasses browser OAuth
default_account_id: act_XXXXXXXXXX    # Optional

Or set environment variables: META_APP_ID, META_APP_SECRET, META_ACCESS_TOKEN.

Env var override: META_ADS_CREDENTIALS=/path/to/meta-ads.yaml

Google Analytics (GA4)

Create ~/.unified-ads-mcp/google-analytics.yaml:

client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
default_property_id: YOUR_PROPERTY_ID   # Optional

Falls back to google-ads.yaml for client_id/client_secret (same Google Cloud project).

Env var override: GOOGLE_ANALYTICS_CREDENTIALS=/path/to/google-analytics.yaml

Google Search Console

Uses google-ads.yaml for client credentials (same Google Cloud project). No separate config needed.