AdSense MCP

Ein MCP-Server, der Ad-hoc-Daten aus der AdSense Management API v2 extrahiert. Er stellt eine uneingeschränkte Reportschnittstelle bereit: Alle unterstützten AdSense-Dimensionen, -Kennzahlen, -Filter, Zeiträume, Sortierreihenfolgen, Zeitzonen, Sprachen, Währungen und Limits können an accounts.reports.generate durchgereicht werden.

Der Server verwendet den schreibgeschützten OAuth-Bereich https://www.googleapis.com/auth/adsense.readonly. Er schreibt nicht in ein AdSense-Konto.

Installation

Sobald er veröffentlicht ist, führen Sie ihn von einem MCP-Client mit npx -y @sirmacke/adsense-mcp aus. Konfigurieren Sie entweder ADSENSE_ACCESS_TOKEN oder alle drei Werte ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET und ADSENSE_REFRESH_TOKEN.

Related MCP server: google-ads-mcp

Sicherheit

OAuth-Zugriffstokens, Aktualisierungstokens und Client-Geheimnisse sind Anmeldeinformationen. Bewahren Sie sie nicht in diesem Repository, in Issue-Trackern, in der Shell-Historie oder in der MCP-Konfiguration auf, die mit anderen geteilt wird. Falls eines offengelegt wird, widerrufen Sie es sofort in Google Cloud; siehe SECURITY.md.

Einrichtung

1. Aktivieren Sie in Google Cloud die AdSense Management API und erstellen Sie einen OAuth-Desktop-Client.

2. Besorgen Sie ein Aktualisierungstoken, dem der Bereich https://www.googleapis.com/auth/adsense.readonly gewährt wurde. Halten Sie es geheim.

3. Kopieren Sie .env.example in Ihre sichere Umgebungskonfiguration und füllen Sie entweder ADSENSE_ACCESS_TOKEN oder die OAuth-Client-ID, das Client-Geheimnis und das Aktualisierungstoken aus.

4. Installieren und bauen Sie:

npm install
npm run build

Einmalige OAuth-Autorisierung (ohne gcloud)

Laden Sie die JSON-Datei des OAuth-Desktop-Clients von Google Cloud herunter und führen Sie dann Folgendes aus:

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

Der Befehl öffnet den Google-Zustimmungsbildschirm über einen Localhost-Callback und speichert die Client-ID, das Client-Geheimnis und das Aktualisierungstoken nur in der privaten Tokendatei. Kopieren Sie diese Werte in die Felder ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET und ADSENSE_REFRESH_TOKEN der MCP-Konfiguration. Lassen Sie einen externen Zustimmungsbildschirm nicht im Modus „Testen“: Seine Aktualisierungstokens laufen nach sieben Tagen ab.

Claude Desktop

Aktuelle Claude-Desktop-Builds verwenden Erweiterungen. Führen Sie npm run package aus und installieren Sie dann build/adsense-mcp.mcpb über Einstellungen → Erweiterungen → Erweiterte Einstellungen → Erweiterung installieren. Es fragt die OAuth-Werte sicher ab. Fügen Sie bei Installationen, die die klassische Konfiguration unterstützen, stattdessen Folgendes hinzu:

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

Codex

Fügen Sie die entsprechende Serverdefinition zu Ihrer Codex-MCP-Konfiguration hinzu, und verwenden Sie dabei denselben Befehl, dieselben Argumente und dieselben Umgebungsvariablen. Der Server verwendet den standardmäßigen MCP-stdio-Transport und funktioniert in beiden Clients.

Werkzeuge

• adsense_list_accounts

• adsense_get_account

• adsense_generate_report

Beispiel-Reportanfrage: metrics: ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"], dimensions: ["DATE", "COUNTRY_NAME"], dateRange: "LAST_7_DAYS", orderBy: ["-ESTIMATED_EARNINGS"].

Verifizierung

npm test
npm run build

Die Live-Verifizierung erfordert außerdem die obigen OAuth-Werte und ein AdSense-Konto. Der Report-Endpunkt der API ist GET /v2/{account}/reports:generate; er erfordert den AdSense- oder den schreibgeschützten AdSense-OAuth-Bereich.

Lizenz

MIT