Google AdSense

AdSense MCP

AdSense Management API v2（アカウント、支払い、アラート、ポリシーに関する問題、サイト、インベントリ、広告コード、保存済みレポートやアドホックレポート）への読み取り専用アクセスを提供する MCP サーバーです。

サーバーは読み取り専用の 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つすべてを設定してください。

セキュリティ

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 Desktop クライアントの 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 の各フィールドにコピーしてください。External 同意画面を Testing のままにしないでください。リフレッシュトークンは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_list_child_accounts
• adsense_list_payments
• adsense_list_alerts
• adsense_get_ad_blocking_recovery_tag
• adsense_list_policy_issues
• adsense_get_policy_issue
• adsense_list_sites
• adsense_get_site

インベントリ

• adsense_list_ad_clients
• adsense_get_ad_client
• adsense_get_ad_client_ad_code
• adsense_list_ad_units
• adsense_get_ad_unit
• adsense_get_ad_unit_ad_code
• adsense_list_linked_custom_channels
• adsense_list_url_channels
• adsense_get_url_channel
• adsense_list_custom_channels
• adsense_get_custom_channel
• adsense_list_linked_ad_units

レポート

• adsense_list_saved_reports
• adsense_get_saved_report
• adsense_generate_saved_report
• adsense_generate_report

アカウントレベルのツールでは、account を省略すると、設定済みまたは最初にアクセス可能なアカウントが検出されます。ページネーションに対応するリストツールは pageSize と pageToken を受け付けます。続きから取得するには、返された nextPageToken を渡してください。リソース固有のツールには、対応するリストツールから返される正式な名前を渡してください。

adsense_list_payments は、支払い済みと未払いの収益を返します。これには書式設定済みの金額と、支払い済みの収益については入金日が含まれます。AdSense API では銀行口座や支払い方法の詳細は取得できません。

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

サーバーは構造化 JSON を返します。API にある CSV レポート用の重複メソッドは意図的に省略しています。CSV が必要な場合、エージェントが構造化されたレスポンスを変換できます。

検証

npm test
npm run build

ライブ検証にも、上記の OAuth 値と AdSense アカウントが必要です。公開されているすべてのエンドポイントは、AdSense の読み取り専用 OAuth スコープを受け付けます。

リリース

リリースは npm と公式 MCP Registry の両方に公開されます。Registry には server.json の検出用メタデータが保存され、インストール可能なサーバー自体は npm を通じて配布されます。

1. package.json、package-lock.json、server.json（npm パッケージのエントリを含む）、mcpb/manifest.json、および src/index.ts 内の MCP サーバーのバージョンを一貫して更新します。
2. npm test と npm pack --dry-run を実行して、ビルドと公開パッケージの内容を検証します。
3. リリースを GitHub にコミットしてプッシュします。
4. 公開スコープ付きパッケージを npm publish --access public で公開します。
5. 必要に応じて mcp-publisher login github で認証し、次に mcp-publisher publish を実行して、対応するバージョンの server.json を公開します。

Registry の検証では、参照先の公開パッケージバージョンが存在している必要があるため、MCP Registry より先に npm に公開してください。公開済みのバージョンは変更できないため、修正するには新しいバージョンが必要です。

ライセンス

MIT