mcp-gsc

Teil der DigestSEO-Suite von Open-Source-SEO-Tools.

• Produkt: digestseo.com/gsc-mcp

• Support: digestseo.com/support

• Datenschutz: digestseo.com/privacy

Der Self-Hosting-Launcher ist als @digestseo/mcp-gsc verfügbar:

npx -y @digestseo/mcp-gsc

Für die Google-OAuth- und Cloudflare-Bereitstellungskonfiguration folgen Sie SETUP.md.

In 30 Sekunden verbinden

Jede bereitgestellte Instanz stellt denselben Endpunkt bereit:

https://<your-worker>.workers.dev/mcp

Die von DigestSEO gehostete Instanz ist verfügbar unter:

https://mcp-gsc.digestseo.com/mcp

Claude Code

claude mcp add --transport http gsc https://<your-worker>.workers.dev/mcp

Cursor

ChatGPT – fügen Sie es als benutzerdefinierten Connector hinzu; siehe In Ihrem KI-Client verbinden unten.

Ein selbst hostbarer Model Context Protocol (MCP)-Server für Google Search Console. Verbinden Sie ihn mit Claude.ai, Cursor, ChatGPT oder einem beliebigen MCP-kompatiblen Client und fragen Sie Ihren KI-Assistenten nach der organischen Suchleistung Ihrer Website – Impressionen, Klicks, Top-Anfragen, Indexstatus und Sitemap-Gesundheit – direkt aus Ihrem eigenen Google-Konto.

Es läuft auf Cloudflare Workers und wird mit einem One-Click-Google-OAuth-Onboarding geliefert: Verbinden Sie den Server in Ihrem Client, melden Sie sich einmalig mit Google an, erteilen Sie die angeforderten Google-Search-Console-Berechtigungen und fertig. Keine API-Schlüssel zum Kopieren und keine Service-Account-JSON-Datei zu verwalten.

Bevorzugen Sie null Einrichtung? Die gehostete Version – mit automatischen wöchentlichen E-Mail-Digests, die in Ihren Posteingang geliefert werden – finden Sie unter digestseo.com. Dieses Repository ist der Open-Source-Kern, den Sie selbst ausführen können.

Tools

Standardmäßig (GSC_ACCESS_MODE=readwrite) stellt dieser Server 17 Tools bereit. Schreibgeschützte Analyse- und Berichtstools sind mit MCPs readOnlyHint gekennzeichnet; die unten aufgeführten Schreib-Tools können Search-Console-Properties, Sitemaps oder den Indexierungsstatus ändern. Setzen Sie GSC_ACCESS_MODE=readonly, um nur den schreibgeschützten Bereich der Search Console anzufordern und die 12 schreibgeschützten Tools bereitzustellen.

Der Lese-Schreib-Modus fordert die Lese-Schreib-Berechtigungen der Google Search Console und der Indexing API an. Der Nur-Lese-Modus fordert nur https://www.googleapis.com/auth/webmasters.readonly (plus openid und email) an und registriert die fünf Schreib-Tools nicht. Lese-Schreib bleibt die Standardeinstellung, damit bestehende Bereitstellungen ihr aktuelles Verhalten beibehalten; siehe SETUP.md, um vor dem Verbinden von Benutzern einen Modus auszuwählen.

indexing.request-Berechtigung. Die Google Indexing API ist kein allgemeines Tool zur Seiteneinreichung – zum Zeitpunkt der Erstellung dieses Textes beschränkt Googles eigene Dokumentation sie auf zwei Inhaltstypen: Seiten mit JobPosting-strukturierten Daten und Livestream-Seiten mit BroadcastEvent-strukturierten Daten, die in VideoObject verschachtelt sind. Vor der Einreichung ruft der Server die Ziel-URL ab und prüft deren JSON-LD auf einen dieser beiden Typen; wenn keiner vorhanden ist (oder die Seite nicht abgerufen werden kann), gibt er einen Fehler zurück, der erklärt, warum die URL nicht berechtigt ist, anstatt die Indexing API aufzurufen. Eine erfolgreiche Einreichung ist nur eine Bestätigung, dass Google die Benachrichtigung erhalten hat – sie garantiert nicht, dass die URL indexiert wird.

Related MCP server: gsc-mcp

Was Sie fragen können

Sobald Sie verbunden sind, fragen Sie Ihren Assistenten zum Beispiel:

• "Was sind meine Top-20-Anfragen nach Klicks in den letzten 28 Tagen?"

• "Vergleichen Sie die Impressionen für example.com diesen Monat mit dem letzten Monat – welche Seiten sind gefallen?"

• "Ist https://example.com/pricing indexiert? Wann wurde es zuletzt gecrawlt?"

• "Für welche Anfragen rankt mein Blog auf Position 5–15? Das sind meine Quick Wins."

• "Gib mir einen wöchentlichen Digest für sc-domain:example.com bis heute."

• "Haben meine Sitemaps Fehler oder Warnungen?"

• "Teile meine Klicks mithilfe eines Regex auf die Anfrage in Marke vs. Nicht-Marke auf."

• "Wie schneidet meine Website bei Google Discover im Vergleich zur normalen Websuche ab?"

In Ihrem KI-Client verbinden

Sobald Sie den Server bereitgestellt haben (siehe SETUP.md), verbinden Sie ihn, indem Sie die /mcp-URL Ihres Workers in Ihren Client einfügen:

https://<your-worker>.workers.dev/mcp

• Claude.ai – Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → fügen Sie die /mcp-URL ein. Lassen Sie Client-ID und Client-Geheimnis leer. Bei der ersten Verwendung öffnet Claude einen Google-Anmeldevorgang; erteilen Sie den von der Bereitstellung angeforderten Zugriff und der Connector wird grün.

• Cursor – fügen Sie es als benutzerdefinierten MCP-Server hinzu, der auf dieselbe /mcp-URL zeigt.

• ChatGPT (mit Connector-/MCP-Unterstützung) – fügen Sie einen benutzerdefinierten Connector mit der /mcp-URL hinzu.

Jeder MCP-kompatible Client funktioniert – sie zeigen alle auf denselben /mcp-Endpunkt und teilen denselben OAuth-Ablauf.

Setup

Self-Hosting bedeutet, dass Sie Ihre eigenen Google-OAuth-Anmeldedaten und ein Cloudflare-Konto mitbringen. Die vollständige, kopierbare Anleitung finden Sie in SETUP.md – einschließlich eines wichtigen Hinweises zur Google-OAuth-Verifizierung und zum 7-Tage-Refresh-Token-Limit, solange Ihre App nicht verifiziert ist.

Kurzer Überblick:

git clone https://github.com/<you>/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy

Siehe SETUP.md für jeden Schritt im Detail.

Entwicklung

npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment

Beiträge willkommen – siehe CONTRIBUTING.md.

Lizenz

MIT © 2026 DigestSEO.

Erstellt und gepflegt von Tomi Šeregi, dem Entwickler hinter digestseo.com – wöchentliche SEO-Digests für nicht-technische Website-Besitzer.