Google Search Console MCP Server — Suchanalysen, URL-Indexierung und Sitemap-Verwaltung für KI-Assistenten (SEO / LLMO)

mcp-server-gsc ist ein MCP-Server (Model Context Protocol) für die Google Search Console, der Ihre Suchleistungsdaten mit Claude oder einem beliebigen MCP-Client verbindet. Er ermöglicht KI-Assistenten, Suchanalysen abzufragen (Klicks, Impressionen, CTR, Position), die Indexierung und den Crawl-Status von URLs zu überprüfen sowie Sitemaps zu verwalten – so können Sie die SEO und LLMO Ihrer Website direkt aus einem Gespräch analysieren und optimieren.

Werkzeuge

Related MCP server: Google Search Console MCP Server

Einrichtung

1. Erstellen

npm install
npm run build

2. Google Cloud-Anmeldedaten

Sie benötigen ein Google Cloud-Projekt mit aktivierter Search Console API (console.cloud.google.com → APIs & Dienste → Bibliothek → „Google Search Console API“ → Aktivieren).

Wählen Sie dann eine der beiden Authentifizierungsmethoden:

Option A – OAuth (empfohlen: Anmeldung mit Ihrem eigenen Google-Konto)

1. APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID → Anwendungstyp Desktop-App.

2. Wenn Sie dazu aufgefordert werden, konfigurieren Sie zuerst den OAuth-Zustimmungsbildschirm (Extern ist in Ordnung; fügen Sie Ihr eigenes Google-Konto als Testbenutzer hinzu).

3. Laden Sie das Client-JSON herunter oder kopieren Sie Client-ID und -Geheimnis.

Konfiguration über Umgebungsvariablen – entweder:

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

oder zeigen Sie auf das heruntergeladene JSON:

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

Beim ersten Tool-Aufruf (oder über das Tool reauthenticate) öffnet sich ein Browserfenster für die Google-Anmeldung. Tokens werden in ~/.config/mcp-server-gsc/tokens.json gespeichert und automatisch aktualisiert.

Option B – Dienstkonto (headless, ohne Browser)

1. APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → Dienstkonto und erstellen Sie dann einen JSON-Schlüssel.

2. In der Search Console → Einstellungen → Benutzer und Berechtigungen fügen Sie die Dienstkonto-E-Mail-Adresse als Benutzer für jede Property hinzu.

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

Wenn GOOGLE_APPLICATION_CREDENTIALS gesetzt ist, hat dies Vorrang und es wird keine Browseranmeldung verwendet.

3. Bei Ihrem MCP-Client registrieren

Claude Code:

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

Empfohlene Begleitwerkzeuge für SEO / LLMO

Dieser Server eignet sich am besten für SEO / LLMO in Kombination mit:

• KeywordGraph MCP-Server – ermöglicht es, Ihre Search Console-Daten mit Echtzeit-Suchintent-Daten zu vergleichen, Topical-Cluster-Analysen durchzuführen und Wissensgraphen Ihrer Anfragen und Inhalte zu erstellen. Verbinden Sie sich direkt über https://mcp.keywordgraph.com, z. B.:

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO-Fähigkeit – fügt erweiterte SEO-/LLMO-Analyse-Workflows auf beiden Servern hinzu.

Zusammen ermöglichen sie die vollständige Schleife: Rufen Sie Ihre tatsächlichen Leistungsdaten von diesem Server ab, vergleichen Sie sie mit dem, wonach Menschen gerade suchen, finden Sie thematische Lücken und optimieren Sie Ihre Inhalte entsprechend – für beste Ergebnisse verwenden Sie alle drei zusammen.

Hinweise zur Verwendung

• Das Format der Website-URL ist wichtig: Domain-Properties sind sc-domain:example.com; URL-Präfix-Properties sind https://example.com/ (genau wie in der Search Console angezeigt). Verwenden Sie list_properties, um Ihre zu sehen.

• Datenverzögerung: Die Analysedaten der Search Console haben eine Verzögerung von etwa 2 Tagen. Wenn Sie die Kurzform days anstelle expliziter Daten verwenden, endet der Zeitraum automatisch vor 2 Tagen.

• Zeiträume: Analysewerkzeuge akzeptieren entweder explizite startDate/endDate (JJJJ-MM-TT) oder eine nachgestellte Anzahl von days (Standard: 28).

• Konten wechseln: Rufen Sie das Tool reauthenticate auf – es verwirft gespeicherte Tokens und öffnet erneut die Browseranmeldung.

• Der Speicherort für Tokens kann mit GSC_CONFIG_DIR überschrieben werden.

Entwicklung

npm run watch   # recompile on change

Quellstruktur:

• src/index.ts – MCP-Server und Tool-Definitionen

• src/auth.ts – OAuth-Loopback-Flow, Token-Persistenz, Dienstkonto-Unterstützung

• src/gsc.ts – Search Console API-Helfer (Abfragen, Summen, URL-Inspektionsdiagnose)