AdSense MCP

AdSense Management API v2 からアドホックなデータを抽出する MCP サーバーです。制限のないレポートインターフェースを公開しており、サポートされている AdSense のディメンション、指標、フィルタ、期間、並べ替え順、タイムゾーン、言語、通貨、制限をすべて accounts.reports.generate に渡すことができます。

このサーバーは、読み取り専用の https://www.googleapis.com/auth/adsense.readonly OAuth スコープを使用します。AdSense アカウントに書き込むことはありません。

インストール

公開されたら、MCP クライアントから npx -y @sirmacke/adsense-mcp で実行します。ADSENSE_ACCESS_TOKEN を設定するか、ADSENSE_CLIENT_ID、ADSENSE_CLIENT_SECRET、ADSENSE_REFRESH_TOKEN の3つすべてを設定します。

Related MCP server: google-ads-mcp

セキュリティ

OAuth アクセストークン、リフレッシュトークン、クライアントシークレットは資格情報です。これらをこのリポジトリ、課題トラッカー、シェル履歴、他のユーザーと共有される MCP 設定に置かないでください。漏えいした場合は、すぐに Google Cloud で失効させてください。SECURITY.md を参照してください。

セットアップ

1. Google Cloud で AdSense Management API を有効にし、OAuth デスクトップクライアントを作成します。

2. https://www.googleapis.com/auth/adsense.readonly スコープが付与されたリフレッシュトークンを取得します。これは秘密にしてください。

3. .env.example を安全な環境設定にコピーし、ADSENSE_ACCESS_TOKEN または OAuth クライアント ID、シークレット、リフレッシュトークンを入力します。

4. インストールしてビルドします:

npm install
npm run build

1回限りの OAuth 認可（gcloud を使用しない場合）

Google Cloud から OAuth デスクトップ クライアントの JSON をダウンロードし、次を実行します:

$env:ADSENSE_OAUTH_CLIENT_FILE = "C:\secure\adsense-client.json"
$env:ADSENSE_TOKEN_FILE = "C:\secure\adsense-oauth.json"
npm run authorize

このコマンドは、localhost コールバックで Google の同意画面を開き、クライアント ID、クライアントシークレット、リフレッシュトークンをプライベートなトークンファイルにのみ保存します。それらの値を MCP 設定の ADSENSE_CLIENT_ID、ADSENSE_CLIENT_SECRET、ADSENSE_REFRESH_TOKEN フィールドにコピーします。外部の同意画面を「テスト中」のままにしないでください。リフレッシュトークンは7日で期限切れになります。

Claude Desktop

現在の Claude Desktop ビルドは拡張機能を使用します。npm run package を実行し、設定 → 拡張機能 → 詳細設定 → 拡張機能をインストール から build/adsense-mcp.mcpb をインストールします。OAuth 値の入力を安全に求められます。従来の設定をサポートするインストールでは、代わりに次を追加します:

{
  "mcpServers": {
    "adsense": {
      "command": "node",
      "args": ["/absolute/path/to/adsense-mcp/dist/index.js"],
      "env": {
        "ADSENSE_CLIENT_ID": "...",
        "ADSENSE_CLIENT_SECRET": "...",
        "ADSENSE_REFRESH_TOKEN": "..."
      }
    }
  }
}

Codex

同等のサーバー定義を Codex MCP 設定に追加します。同じコマンド、引数、環境変数を使用します。このサーバーは標準の MCP stdio トランスポートを使用し、両方のクライアントで動作します。

ツール

• adsense_list_accounts

• adsense_get_account

• adsense_generate_report

レポートリクエストの例: metrics: ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"]、dimensions: ["DATE", "COUNTRY_NAME"]、dateRange: "LAST_7_DAYS"、orderBy: ["-ESTIMATED_EARNINGS"]。

検証

npm test
npm run build

ライブ検証には、上記の OAuth 値と AdSense アカウントも必要です。API のレポートエンドポイントは GET /v2/{account}/reports:generate で、AdSense または AdSense 読み取り専用の OAuth スコープが必要です。

ライセンス

MIT