Wingate SEO MCP

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

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

Herausgeber: Wingnut Innovations
Version: 0.5.1
Lizenz: MIT

Warum verwenden?

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

• Behalten Sie Anmeldedaten und Property-Zuordnungen auf Ihrer eigenen Infrastruktur.

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

• Untersuchen Sie Ereignisaktivität, Landing-Page-Engagement, CTR-Möglichkeiten, Ranking-Änderungen, Abfall und Kannibalisierung.

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

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

Related MCP server: Google SEO MCP

Schreibgeschützte MCP-Tools

Der öffentliche Server stellt genau 11 Tools bereit:

Es gibt keine Search Console-, Google Indexing-, GA4 Admin-, Sitemap-Einreichungs- oder andere Schreib-Tools im öffentlichen Server.

GA4-Berichtsqualitäts-Diagnosen

GA4-Ergebnisse enthalten Berichtsdiagnosen als Beweis für die zurückgegebenen Daten. Google kann Schwellenwerte oder Sampling anwenden, und Dimensionen mit hoher Kardinalität können in einer (other)-Zeile gruppiert werden. Begrenzte Tool-Antworten melden auch, wenn weitere Zeilen verfügbar sind, während Property-Kontingentdetails nur informativ sind. Diese Einschränkungen beweisen nicht, dass das Tracking korrekt oder vollständig ist, und Wingate SEO MCP kann das Berichtsverhalten von Google nicht umgehen.

ga4_overview kann optional Sitzungs-Traffic-Akquisitions-Beweise hinzufügen, ohne ein weiteres MCP-Tool hinzuzufügen:

{
  "siteKey": "example-site",
  "days": 28,
  "includeAcquisition": true,
  "acquisitionLimit": 25
}

Die Standardübersicht stellt keine Akquisitionsanfrage und gibt acquisition: null zurück. Wenn aktiviert, gruppiert acquisition Zeilen nach Standard-Kanalgruppe der Sitzung und Quelle/Medium der Sitzung, verwendet denselben Datumsbereich und googleOrganicOnly-Umfang wie die Übersicht und ist auf 1-100 Zeilen begrenzt. Seine reportDiagnostics legen Kürzung, Schwellenwerte, Sampling und Kontingent-Einschränkungen offen; GA4-Akquisitionsattribution ist nicht gleichbedeutend mit Search Console-Attribution.

Anforderungen

• Node.js 20, 22 oder 24

• npm

• Ein Google Cloud-Projekt mit den erforderlichen APIs

• Eine vom Benutzer bereitgestellte Google-Dienstkonto-JSON-Anmeldedaten mit Zugriff auf Ihre GSC- und GA4-Properties

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

Schnellstart

git clone https://github.com/aitradesniper-blip/wingate-seo-mcp-public.git wingate-seo-mcp
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 Dienstkonto-JSON 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-Laufzeit erfordert explizite Dienstkonto-Anmeldedaten. Setzen Sie GOOGLE_SERVICE_ACCOUNT_FILE (bevorzugt), GOOGLE_APPLICATION_CREDENTIALS oder GOOGLE_SERVICE_ACCOUNT_JSON. Es greift nicht auf eine angehängte Google Cloud-Metadaten-/Workload-Identität zurück.

Validieren Sie Anmeldedaten und entdecken Sie zugängliche Properties:

npm run doctor
npm run discover:google

Generieren Sie ein ignoriertes lokales Site-Register mit den von der Erkennung 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-Lesevorgänge 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

Siehe Google-Setup und Live-Onboarding für eine ausführliche Anleitung.

Google-API-Setup

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 Dienstkonto-E-Mail Zugriff auf jede Search Console-Property und mindestens Viewer-Zugriff auf jede GA4-Property. Die Laufzeit 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 erkennen. Der MCP-Server ändert keine GA4-Admin-Einstellungen.

Site-Zuordnung

Jeder lokale Registereintrag ordnet einen stabilen siteKey einer Search Console-Property, einer optionalen GA4-Property und dem Ursprung der Site zu. Kopieren Sie config/sites.example.json für die Form, oder lassen Sie npm run setup config/sites.local.json generieren und validieren.

Lokale Register werden von Git ignoriert. Committen Sie niemals echte Property-Zuordnungen, wenn Repository-Leser 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. Verwenden Sie eine vom Client unterstützte lokale Verbindung oder eine unabhängig überprüfte Transportgrenze. Dieses Repository enthält keinen Internet-Tunnel oder Authentifizierungsschicht.

Bevor Sie Daten senden, überprüfen Sie die Tool-Erkennung und bestätigen Sie, dass es genau 11 Tools gibt und jedes Tool als schreibgeschützt markiert ist. Siehe MCP-Client-Verbindung.

Beispiel-Fragen

• „Welche Seiten haben diesen Monat Klicks verloren?“

• „Finden Sie Suchanfragen mit Rang 4–20 und schwacher CTR.“

• „Welche organischen Landing-Pages 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 hat keine versteckte Telemetrie. Es sendet keine Nutzungsanalysen an Wingnut Innovations oder Dritte.

Daten verlassen Ihren Rechner 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 überprüfte Authentifizierungs- und Transportgrenze hinzuzufügen. Legen Sie keine Anmeldedaten, lokalen Register oder Befehlsausgaben in Prompts oder Quellcodeverwaltung ab. Siehe SECURITY.md.

Fehlerbehebung

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

• 403 von Google: Aktivieren Sie die relevante API und gewähren Sie der Dienstkonto-E-Mail 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 Erkennung wählt niemals stillschweigend eine schwache Übereinstimmung.

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

• MCP-Client kann keine Verbindung herstellen: Bestätigen Sie npm start, /healthz, Loopback-Bindung und die lokale Netzwerk- oder separat gesicherte Transportkonfiguration des Clients.

Entwicklung und Validierung

npm run ci

Dies führt Syntaxprüfungen, TypeScript-Prüfungen, Unit-/Integrationstests, einen Produktions-Build und MCP-Erkennung aus. CI zielt auf Node.js 20, 22 und 24.

Docker-Paketierung wird absichtlich aufgeschoben, bis ein kleines, überprüfbares Image und eine Nicht-Root-Laufzeitrichtlinie bereit sind; der Node/npm-Self-Hosting-Pfad ist die v0.5.0-Baseline.

Roadmap und Support

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

Lizenz, Herkunft und Unabhängigkeit

Wingate SEO MCP ist unter der MIT-Lizenz lizenziert. Ausgewählte Google-Client- und Methodenzuordnungen wurden aus dem in UPSTREAM.md, UPSTREAM_IMPORT_MANIFEST.json und THIRD_PARTY_NOTICES.md dokumentierten, festgelegten MIT-lizenzierten Upstream adaptiert und wesentlich neu geschrieben.

Wingate SEO MCP ist ein unabhängiges Projekt, das von Wingnut Innovations veröffentlicht wird. Es ist nicht mit Google oder OpenAI verbunden, von ihnen unterstützt oder gesponsert. Google Search Console, Google Analytics, GA4, ChatGPT und OpenAI sind Marken ihrer jeweiligen Inhaber.