Wingate SEO MCP

Open-Source-, selbst gehosteter MCP-Server für Google Search Console und Google Analytics 4 für ChatGPT und andere MCP-Clients. Analysieren Sie Ihre eigenen SEO-Daten, ohne für ein weiteres SEO-Dashboard zu zahlen.

Wingate SEO MCP verbindet einen MCP-Client mit Google-Properties, die Sie bereits kontrollieren. Es kombiniert Search-Console-Leistungsdaten, GA4-Engagement, Sitemap- und URL-Inspection-Befunde, Zeitraumvergleiche und deterministische SEO-Diagnosen in einem einzigen schreibgeschützten Dienst.

Herausgeber: Wingnut Innovations
Version: 0.5.0
Lizenz: MIT

Warum nutzen?

• Stellen Sie Fragen zu Ihren eigenen GSC- und GA4-Daten in natürlicher Sprache.

• Behalten Sie Anmeldedaten und Property-Zuordnungen auf Infrastruktur, die Sie kontrollieren.

• Ersetzen Sie wiederkehrende Dashboard-Arbeit durch reproduzierbare Befunde und Berechnungen.

• Untersuchen Sie Ereignisaktivität, Landingpage-Engagement, CTR-Chancen, Rankingänderungen, Rankingverfall und Kannibalisierung.

• Beginnen Sie mit einer bewusst kleinen, schreibgeschützten Sicherheitsgrenze.

Sie stellen Ihre eigenen Google-Anmeldedaten bereit und gewähren dieser Identität Zugriff nur auf die Properties, die Sie analysieren möchten. Wingate SEO MCP enthält keine gehosteten Konten, keinen gebündelten Google-Zugriff, keine Bezahlschranken, keine Telemetrie, keine Werbung und keine Abonnements.

Schreibgeschützte MCP-Tools

Der öffentliche Server stellt genau 11 Tools bereit:

In der öffentlichen Kandidatenversion gibt es keine Schreibwerkzeuge für Search Console, Google Indexing, GA4-Admin, Sitemap-Einreichung oder andere Schreibfunktionen.

Voraussetzungen

• Node.js 20, 22 oder 24

• npm

• Ein Google-Cloud-Projekt mit den erforderlichen aktivierten APIs

• Vom Nutzer bereitgestellte Google-Service-Account-JSON-Anmeldedaten mit Zugriff auf Ihre GSC- und GA4-Properties

• Einen MCP-Client, der den lokalen Streamable-HTTP-Endpunkt erreichen kann

Schnellstart

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
cd wingate-seo-mcp
npm install

Verwenden Sie .env.example als Vorlage und setzen Sie dieselben Umgebungsvariablen in der Shell, die die Befehle startet. Das Projekt lädt .env nicht automatisch. Bewahren Sie die heruntergeladene Service-Account-JSON-Datei außerhalb des Repositorys auf.

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

Die von npm start gestartete MCP-Runtime v0.5.0 erfordert explizite Service-Account-Anmeldedaten. Setzen Sie GOOGLE_SERVICE_ACCOUNT_FILE (bevorzugt), GOOGLE_APPLICATION_CREDENTIALS oder GOOGLE_SERVICE_ACCOUNT_JSON. Sie greift nicht auf eine angehängte Google-Cloud-Metadata-/Workload-Identität zurück.

Validieren Sie die Anmeldedaten und ermitteln Sie zugängliche Properties:

npm run doctor
npm run discover:google

Generieren Sie ein ignoriertes lokales Site-Register mithilfe der von der Ermittlung zurückgegebenen Properties:

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

Führen Sie begrenzte Live-Abfragen aus und starten Sie dann den Server:

npm run live:smoke -- --site example-site --inspect-origin
npm start

Die Standard-Endpunkte sind:

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

Eine ausführliche Schritt-für-Schritt-Anleitung finden Sie unter Google-Einrichtung und Live-Onboarding.

Google-API-Einrichtung

Aktivieren Sie diese APIs in Ihrem Google-Cloud-Projekt:

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

Gewähren Sie der Service-Account-E-Mail-Adresse Zugriff auf jede Search-Console-Property und mindestens Viewer-Zugriff auf jede GA4-Property. Die Runtime fordert nur an:

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

Die Analytics Admin API wird nur verwendet, um zugängliche GA4-Properties und Web-Streams zu ermitteln. Der MCP-Server ändert keine GA4-Admin-Einstellungen.

Website-Zuordnung

Jeder Eintrag im lokalen Register ordnet einem stabilen siteKey eine Search-Console-Property, eine optionale GA4-Property und den Ursprung (Origin) der Website zu. Kopieren Sie config/sites.example.json für die Struktur oder lassen Sie npm run setup die Datei config/sites.local.json generieren und validieren.

Lokale Register werden von Git ignoriert. Committen Sie niemals echte Property-Zuordnungen, wenn die Leser des Repositorys nicht wissen sollen, welche Sites Sie betreiben.

MCP-Client verbinden

Starten Sie den Server und richten Sie einen Streamable-HTTP-fähigen MCP-Client auf den lokalen /mcp-Endpunkt aus. Verwenden Sie eine vom Client unterstützte lokale Verbindung oder eine unabhängig geprüfte Transportgrenze. Dieses Repository enthält weder einen Internet-Tunnel noch eine Authentifizierungsschicht.

Prüfen Sie vor dem Senden von Daten die Tool-Ermittlung und bestätigen Sie, dass es genau 11 Tools gibt und jedes Tool als schreibgeschützt markiert ist. Siehe MCP-Client-Verbindung.

Beispielfragen

• „Welche Seiten haben diesen Monat Klicks verloren?"

• „Finden Sie Suchanfragen auf den Positionen 4–20 mit schwacher CTR."

• „Welche organischen Landingpages haben das beste Engagement?"

• „Wurde mein Lead-Ereignis ausgelöst?"

• „Vergleichen Sie die letzten 28 Tage mit den vorherigen 28 Tagen."

Datenschutz und Sicherheit

Wingate SEO MCP enthält keine verdeckte Telemetrie. Es sendet keine Nutzungsanalysen an Wingnut Innovations oder an Dritte.

Daten verlassen Ihren Computer oder Server nur, wenn:

• der Connector Google-APIs mit den von Ihnen konfigurierten Anmeldedaten und Property-Zugriffen aufruft; oder

• Ihr konfigurierter MCP-Client Anfragen an diesen Server sendet und Ergebnisse von ihm empfängt.

Der Server bindet standardmäßig an 127.0.0.1. Setzen Sie ihn nicht direkt dem öffentlichen Internet aus, ohne eine unabhängig geprüfte Authentifizierungs- und Transportgrenze hinzuzufügen. Geben Sie keine Anmeldedaten, lokalen Register oder Befehlsausgaben in Prompts oder in die Versionsverwaltung. Siehe SECURITY.md.

Fehlerbehebung

• Anmeldedatei nicht lesbar: Verwenden Sie einen absoluten Pfad und bewahren Sie die JSON-Datei außerhalb des Repositorys auf.

• 403 von Google: Aktivieren Sie die jeweilige API und gewähren Sie der Service-Account-E-Mail-Adresse Zugriff auf die Property.

• Keine GA4-Property gefunden: Gewähren Sie mindestens Viewer-Zugriff und führen Sie dann npm run doctor erneut aus.

• Mehrdeutige Zuordnung: Geben Sie --ga4 explizit an; die Ermittlung wählt niemals stillschweigend eine schwache Übereinstimmung.

• Keine Ereigniszeile: GA4 hat für diesen Datums-/Filterbereich keine passende Zeile beobachtet; das Fehlen allein diagnostiziert keine Instrumentierung.

• MCP-Client kann keine Verbindung herstellen: Prüfen Sie npm start, /healthz, die Loopback-Bindung und die Transportkonfiguration des Clients (lokales Netzwerk oder separat abgesichert).

Entwicklung und Validierung

npm run ci

Dabei werden Syntaxprüfungen, TypeScript-Prüfungen, Unit-/Integrationstests, ein Produktions-Build und die MCP-Ermittlung ausgeführt. CI zielt auf Node.js 20, 22 und 24.

Die Docker-Verpackung wird bewusst zurückgestellt, bis ein kleines, überprüfbares Image und eine Non-Root-Runtime-Richtlinie bereit sind; der Node-/npm-Self-Hosting-Pfad ist die Baseline von v0.5.0.

Roadmap und Support

Siehe die Roadmap. Wingate SEO MCP ist kostenlos und Open Source. Wenn es Ihnen Zeit oder ein SEO-Tool-Abonnement erspart, können Sie die weitere Entwicklung optional unterstützen. In v0.5.0 ist kein Fördergeber konfiguriert.

Lizenz, Herkunft und Unabhängigkeit

Wingate SEO MCP ist unter der MIT-Lizenz lizenziert. Ausgewählte Google-Client- und Methodenzuordnungen wurden auf der Grundlage des fest gepinnten, unter der MIT-Lizenz stehenden Upstreams angepasst und erheblich neu geschrieben. Dieser ist in UPSTREAM.md, UPSTREAM_IMPORT_MANIFEST.json und THIRD_PARTY_NOTICES.md dokumentiert.

Wingate SEO MCP ist ein unabhängiges Projekt, das von Wingnut Innovations herausgegeben wird. Es ist weder mit Google noch mit OpenAI verbunden, wird von ihnen weder unterstützt noch gesponsert. Google Search Console, Google Analytics, GA4, ChatGPT und OpenAI sind Marken der jeweiligen Inhaber.