GSC MCP für Google Search Console.
mcp-gsc verbindet Google Search Console mit Claude, ChatGPT, Cursor oder einem anderen MCP-Client. Analysiere Suchanfragen und Seiten, prüfe URLs, verwalte Sitemaps und nutze Google OAuth.
- Empfohlener Modus
- Read-only
- Authentifizierung
- Google OAuth
- Betriebsarten
- npm / Worker
- Lizenz
- MIT
npm · Google Search Console MCP
GSC MCP lokal mit npm installieren
npm startet einen lokalen Streamable-HTTP-Server. Google OAuth und Zugangsdaten müssen zuvor eingerichtet sein; es ist keine Ein-Klick-Verbindung.
1. Google-Zugriff vorbereiten
Node.js ^22.18.0 / >=24.11.0+npm- Ein Google-Konto mit Zugriff auf die gewünschte Search-Console-Property verwenden.
- Einen OAuth-Client in Google Cloud erstellen, die erforderlichen APIs aktivieren und die exakte lokale Weiterleitungs-URI hinterlegen.
- Diese drei Umgebungsvariablen gemäß der versionsgleichen Anleitung setzen. TOKEN_ENCRYPTION_KEY muss genau 32 zufällige Bytes als gültiges Base64 enthalten.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Die exakte Redirect-URI in Google Cloud registrieren. Host, Port und Pfad müssen übereinstimmen; localhost ist nicht dasselbe wie 127.0.0.1.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Lokalen Server starten
Nach dem Einrichten der Zugangsdaten im Terminal den npm-Launcher starten. Für reine Analysen den passenden schreibgeschützten Modus wählen.
Standardmäßig nutzt der Launcher readwrite. Für Analysen readonly vor der Google-Autorisierung wählen; Schreibwerkzeuge bleiben dann deaktiviert.
Bash / zsh (Shell)
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscLokaler Endpunkt · Streamable HTTP
http://127.0.0.1:8080/mcp 3. MCP-Client verbinden
Den Launcher geöffnet lassen und den lokalen Streamable-HTTP-Endpunkt auf demselben Rechner eintragen. Dies ist kein stdio-Server.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpCodex CLI / IDE verbinden
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
In Cursor einen Streamable-HTTP-MCP-Server namens gsc mit dieser URL hinzufügen (nur lokales Cursor).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT und Claude in der Cloud können 127.0.0.1 auf deinem PC nicht erreichen. Nutze einen eigenen HTTPS-Worker oder einen verfügbaren sicheren MCP-Tunnel, sofern dein Konto dies erlaubt.
Remote-Zugriff gewünscht?Remote-Zugriff gewünscht?
Cloudflare Workers bleibt als eigene HTTPS-Bereitstellung verfügbar. Cloudflare und Google OAuth müssen eingerichtet werden. Das Beispiel unten verwendet Bash; die vollständigen Schritte stehen in SETUP.md.
Über das Produkt
Was ist mcp-gsc?
mcp-gsc ist ein selbst hostbarer Model-Context-Protocol-Server, der deinen KI-Client direkt mit der offiziellen Google-Search-Console-API verbindet.
Das npm-Paket läuft lokal über Loopback-HTTP; alternativ lässt sich ein eigener Cloudflare Worker als HTTPS-Endpunkt bereitstellen. Beide Wege verwenden Google OAuth.
Der lokale Launcher speichert verschlüsselte Sitzungsdaten standardmäßig unter ~/.mcp-gsc/state; Worker nutzen Speicher in deinem Cloudflare-Konto. DigestSEO hostet hier keinen verwalteten Connector.
Importiere deinen Leistungsbericht für Web: multimodal. Die Auswertung zeigt Seiten, Klicks, Impressionen und Klickrate, erkennt aber keine Bilder. Google Lens und multimodale Suche analysieren.
Vergleiche die Sichtbarkeit deiner Social-Media-Konten in den Google-Suchergebnissen anhand autorisierter Exporte. Keine Likes oder In-App-Aufrufe. Google-Suchzugriffe auf Social Media vergleichen.
Tools
Server-Funktionen
Fokussierte Tools decken Statistiken, URL-Prüfung, Sitemaps, Indexierung, SEO-Diagnosen und die wöchentliche Zusammenfassung ab.
Die Werkzeugliste enthält optionale Schreibfunktionen. GSC_ACCESS_MODE=readonly stellt nur nicht verändernde Werkzeuge bereit; die Google Indexing API ist auf bestimmte Inhaltstypen begrenzt.
get_capabilitiesListet die verfügbaren Funktionen und den Authentifizierungsstatus auf.
list_sitesListet die Search-Console-Properties auf, auf die das verbundene Konto zugreifen kann.
query_search_analyticsFragt Klicks, Impressionen, CTR und Positionen für einen benutzerdefinierten Zeitraum ab.
inspect_urlRuft den Live-URL-Prüfbericht und Indexierungsdetails ab.
list_sitemapsListet eingereichte Sitemaps mit Crawl-Status und Warnungen auf.
add_siteFügt dem verbundenen Konto eine Search-Console-Property hinzu.
delete_siteEntfernt eine Search-Console-Property aus dem Konto.
submit_sitemapReicht eine Sitemap für eine Search-Console-Property ein.
delete_sitemapEntfernt eine eingereichte Sitemap aus einer Property.
get_sitemapRuft den detaillierten Status einer eingereichten Sitemap ab.
identify_quick_winsFindet Suchanfragen mit vielen Impressionen auf den Positionen 8–20.
detect_cannibalizationFindet Suchanfragen, um die mehrere Seiten konkurrieren.
detect_content_decayErkennt Seiten mit dem größten Rückgang an Suchklicks.
request_indexingFordert die Indexierung über Googles Indexing API an. Diese API ist derzeit auf Seiten mit JobPosting-strukturierten Daten oder Livestream-Seiten mit BroadcastEvent innerhalb von VideoObject beschränkt und ist nicht für die allgemeine Übermittlung von Webseiten verfügbar.
list_indexed_pagesListet Seiten auf, die in der Search Console Impressionen erhalten haben.
compare_performanceVergleicht Klicks, Impressionen, CTR und Positionen zwischen zwei Zeiträumen.
weekly_digestErstellt einen wöchentlichen SEO-Bericht in verständlicher Sprache.
Bereitstellung
Remote-Zugriff gewünscht?
Cloudflare Workers bleibt als eigene HTTPS-Bereitstellung verfügbar. Cloudflare und Google OAuth müssen eingerichtet werden. Das Beispiel unten verwendet Bash; die vollständigen Schritte stehen in SETUP.md.
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deployGib dem Repo einen Stern und nutze die Search Console in Claude.
Open Source zur eigenen Bereitstellung. Google OAuth nach Anleitung einrichten oder eigenen Cloudflare Worker verwenden.