ga-gsc-analytics
ga-gsc-analytics
Schreibgeschützter MCP-Server, der Google Analytics 4- und Google Search Console-Daten (analytics.readonly + webmasters.readonly-Bereiche) für Claude Code / Codex bereitstellt.
Neu hier? Folgen Sie ONBOARDING.md für eine Schritt-für-Schritt-Anleitung von null bis funktionsfähig (Claude Code installieren, Anmeldedaten erhalten, autorisieren, verifizieren). Der Rest dieser Datei ist Referenzmaterial.
KI-Agenten: Diese Datei dient auch als
AGENTS.md– beginnen Sie hier für die Einrichtung, lesen Sie dannskills/analyze-ga-gsc/SKILL.mdfür die Verwendung der Tools (Zugriffsprüfungen, Standard-Datumsbereiche, GA4- vs. GSC-Semantik, Präsentationsübergabeformat). Bitten Sie einen Benutzer niemals, Anmeldedaten in den Chat einzufügen.
Werkzeuge
analytics_auth_start/analytics_auth_status— lokaler OAuth-Ablauf + Statusprüfunganalytics_list_sources— listet GA4-Properties und GSC-Sites auf, die für das autorisierte Konto verfügbar sindga_run_report— führt einen GA4-Bericht ausgsc_query_search_analytics— fragt Search Console-Daten abanalytics_presentation_snapshot— kombinierter GA4- und GSC-Snapshot für die Berichterstattung
Related MCP server: GSC MCP
Einrichtung (pro Benutzer)
Jeder Benutzer autorisiert mit seinem eigenen Google-Konto und behält sein eigenes lokales Token – teilen Sie niemals client_secret.json-Geheimnisse oder tokens.json zwischen Maschinen.
Google Cloud OAuth-Client: Erstellen Sie (oder verwenden Sie einen vorhandenen) OAuth 2.0-Desktop-Client in der Google Cloud Console und laden Sie dessen
client_secret.jsonherunter. Wenn der Zustimmungsbildschirm den Veröffentlichungsstatus „Testen“ hat, fügen Sie zuerst das Google-Konto jedes neuen Benutzers als Testbenutzer hinzu, andernfalls schlägt die Authentifizierung mit Zugriffsverweigerung fehl.Platzieren Sie die Anmeldedaten unter
~/.config/ga-gsc-analytics/client_secret.json(oder zeigen Sie mitGA_GSC_CLIENT_SECRETauf einen benutzerdefinierten Pfad).Datenzugriff gewähren: Das autorisierende Google-Konto benötigt echte Berechtigungen für die Ziel-GA4-Property (Analytics Admin → Property Access Management) und die GSC-Site (Search Console → Einstellungen → Benutzer und Berechtigungen).
Erstellen Sie den Server (nur erforderlich, wenn Sie
mcp/server.mjsändern; das Repository enthält ein vorgebautesmcp/server.bundle.cjs):
pnpm install
pnpm run build # bundles mcp/server.mjs -> mcp/server.bundle.cjsRegistrieren Sie den MCP-Server. Entweder:
Claude Code, benutzerbezogen:
claude mcp add ga-gsc-analytics -- node /path/to/ga-gsc-analytics/mcp/server.bundle.cjsClaude Code / Codex, projektspezifisch: Dieses Repository enthält bereits eine relative
.mcp.json({"mcpServers": {"ga_gsc_analytics": {"command": "node", "args": ["./mcp/server.bundle.cjs"]}}}) – kopieren Sie sie in ein Projekt oder verlinken/vendoren Sie diesen gesamten Ordner, und sie wird automatisch erkannt, wenn dieses Projekt geöffnet wird.
Autorisieren: Rufen Sie das Tool
analytics_auth_startaus Ihrem KI-Tool auf – es öffnet einen lokalen Browser-OAuth-Ablauf und schreibt~/.config/ga-gsc-analytics/tokens.json.Verifizieren: Rufen Sie
analytics_auth_statusauf (sollteauthorized: truemelden), dannanalytics_list_sources, um zu bestätigen, dass die erwarteten GA4-Properties / GSC-Sites angezeigt werden.
Konfigurationsüberschreibungen
Umgebungsvariable | Standard |
|
|
|
|
|
|
Entwicklung
pnpm run check # syntax check
pnpm test # node --test tests/*.test.mjsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Search Console analytics, URL inspection, indexing diagnostics, and sitemaps.
Read-only Google Search Console and Google Analytics for AI agents.
Read-only Google Search Console, Bing, Google Analytics and privacy-friendly analytics for your AI.
Read-only access for your AI to Search Console, GA4, Google Ads, Meta Ads and your store's sales.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRead-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.MIT
- AlicenseAqualityBmaintenanceEnables read-only access to Google Search Console data, including property discovery, search analytics queries, and URL inspection, through a security-focused interface.32,636 PyPI2MIT
- FlicenseNot gradedqualityCmaintenanceEnables read-only access to Google Analytics 4, Google Search Console, BigQuery saved queries, GitHub repository data, and Metricool status for SEO/SEM monitoring and analysis.-
- AlicenseAqualityBmaintenanceEnables read-only access to Google Search Console data, including search analytics, sitemap status, URL inspection, and property listing.425 npmMIT