ga-gsc-analytics
ga-gsc-analytics
Servidor MCP de solo lectura que expone datos de Google Analytics 4 y Google Search Console
(ámbitos analytics.readonly + webmasters.readonly) a Claude Code / Codex.
¿Nuevo aquí? Sigue ONBOARDING.md para un recorrido de cero a funcionando
(instalar Claude Code, obtener credenciales, autorizar, verificar). El resto de este archivo es
material de referencia.
Agentes de IA: este archivo también sirve como
AGENTS.md— comienza aquí para la configuración, luego leeskills/analyze-ga-gsc/SKILL.mdpara saber cómo usar las herramientas (comprobaciones de acceso, rangos de fechas predeterminados, semántica de GA4 vs. GSC, formato de entrega de presentación). Nunca pidas a un usuario que pegue credenciales en el chat.
Herramientas
analytics_auth_start/analytics_auth_status— flujo OAuth local + comprobación de estadoanalytics_list_sources— lista las propiedades de GA4 y los sitios de GSC disponibles para la cuenta autorizadaga_run_report— ejecuta un informe de GA4gsc_query_search_analytics— consulta datos de Search Consoleanalytics_presentation_snapshot— instantánea combinada de GA4 + GSC para informes
Related MCP server: google-search-console-mcp-server
Configuración (por usuario)
Cada usuario se autoriza con su propia cuenta de Google y mantiene su propio token
local — nunca compartas secretos de client_secret.json ni tokens.json entre máquinas.
Cliente OAuth de Google Cloud: crea (o reutiliza un existente) un cliente de escritorio OAuth 2.0 en Google Cloud Console y descarga su
client_secret.json. Si la pantalla de consentimiento está en estado de publicación "Pruebas", añade primero la cuenta de Google de cada nuevo usuario como usuario de prueba, o la autorización fallará con acceso denegado.Coloca las credenciales en
~/.config/ga-gsc-analytics/client_secret.json(o apuntaGA_GSC_CLIENT_SECRETa una ruta personalizada).Concede acceso a los datos: la cuenta de Google que autoriza necesita permisos reales en la propiedad de GA4 objetivo (Analytics Admin → Administración de acceso a la propiedad) y en el sitio de GSC (Search Console → Configuración → Usuarios y permisos).
Compila el servidor (solo necesario si cambias
mcp/server.mjs; el repositorio incluye unmcp/server.bundle.cjsprecompilado):
pnpm install
pnpm run build # bundles mcp/server.mjs -> mcp/server.bundle.cjsRegistra el servidor MCP. Ya sea:
Claude Code, a nivel de usuario:
claude mcp add ga-gsc-analytics -- node /path/to/ga-gsc-analytics/mcp/server.bundle.cjsClaude Code / Codex, con ámbito de proyecto: este repositorio ya incluye un
.mcp.jsonrelativo ({"mcpServers": {"ga_gsc_analytics": {"command": "node", "args": ["./mcp/server.bundle.cjs"]}}}) — cópialo en un proyecto, o enlaza simbólicamente / incluye esta carpeta completa, y se detectará automáticamente cuando se abra ese proyecto.
Autoriza: llama a la herramienta
analytics_auth_startdesde tu herramienta de IA — abre un flujo OAuth local en el navegador y escribe~/.config/ga-gsc-analytics/tokens.json.Verifica: llama a
analytics_auth_status(debería informarauthorized: true), luegoanalytics_list_sourcespara confirmar que aparecen las propiedades de GA4 / sitios de GSC esperados.
Anulaciones de configuración
Variable de entorno | Por defecto |
|
|
|
|
|
|
Desarrollo
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…
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 MCP clients to query Google Search Console search performance, inspect indexing, analyze sitemaps, and run SEO analyses such as cannibalisation detection, query clustering, and wins/losses, all with read-only access.20Apache 2.0
- 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.-