Google Search Console MCP Server
Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a Google Search Console y Google Analytics.
Documentación
Google Search Console MCP Server — La Guía Completa (2026)
Resumir con IA: ChatGPT · Perplexity · Claude · Grok
Respuesta rápida: Un servidor MCP de Google Search Console es un conector de Model Context Protocol que expone datos en vivo de GSC (y opcionalmente GA4) como herramientas que tu asistente de IA puede invocar. Pregunta a Claude, Cursor o Codex cosas como "¿Qué consultas cayeron esta semana?" y obtén respuestas reales de Search Console — sin exportar CSV, sin cambiar de pestaña.
Camino más rápido (recomendado): GenieSeo — alojado, gratis durante la beta, configuración en 60 segundos, GSC + GA4, sin tarjeta de crédito.
Control total: autoalojado con
uvx mcp-search-console(ver configuración autoalojada).
Beta de GenieSeo — gratis ahora mismo: Las 28 herramientas (21 de Search Console + 7 de GA4), una URL MCP personal, funciona en Claude en la web, Cursor, Codex y Antigravity. Empezar gratis →
▶ Ver el video de configuración de 60 segundos — regístrate, conecta Google, pega la URL MCP en Claude
Última actualización: 11 de junio de 2026 · Tiempo de lectura: ~18 minutos · Nivel de habilidad: Apto para principiantes
Esta guía cubre todo lo que necesitas para conectar Google Search Console (y opcionalmente GA4) a Claude, Cursor o Codex usando el Model Context Protocol (MCP) — incluyendo una opción alojada gratuita, instalación autoalojada, referencia de 28 herramientas, indicaciones listas para copiar y pegar, y un video tutorial.
Tabla de contenidos
- Video tutorial — configuración en 60 segundos
- ¿Qué es un servidor MCP de Google Search Console?
- ¿Cuánto cuesta? (opciones gratuitas)
- Por qué los SEOs y desarrolladores usan MCP para Search Console
- Google Analytics 4 en la misma URL MCP
- Las 28 herramientas MCP (referencia)
- Alojado vs autoalojado: ¿cuál deberías elegir?
- Configuración en 60 segundos — GenieSeo (alojado)
- Configuración autoalojada — código abierto
- Conectar a Claude, Cursor, Codex y Antigravity
- Indicaciones de ejemplo y flujos de trabajo SEO
- Casos de uso por rol
- Seguridad, privacidad y permisos
- Precios
- Comparaciones
- Arquitectura
- Preguntas frecuentes
- Recursos y enlaces
Video tutorial — configuración en 60 segundos
¿Prefieres ver en lugar de leer? Haz clic en el póster a continuación para ver el video de configuración de GenieSeo — regístrate, conecta Google OAuth, copia tu URL MCP, pégala en Claude. Gratis durante la beta, sin tarjeta de crédito.
Cubre: inicio de sesión de Google → generación de URL MCP → Configuración de Claude → Conectores → tu primera consulta de Search Console.
Usuarios autoalojados: El video de configuración muestra el flujo alojado de principio a fin. Para instalaciones con
uvxo clon, salta a configuración autoalojada — la configuración de credenciales toma de 15 a 45 minutos.
¿Qué es un servidor MCP de Google Search Console?
Abres Google Search Console, agregas un filtro, cambias el rango de fechas, exportas un CSV, creas una tabla dinámica — y treinta minutos después has respondido una pregunta que debería haber tomado diez segundos.
¿Y si pudieras simplemente preguntar?
"¿Qué páginas perdieron tráfico este mes?" · "¿A qué palabras clave estoy cerca de posicionar en la primera página?" · "¿Hay URLs que se están canibalizando entre sí?"
Model Context Protocol (MCP) es un estándar abierto que permite a los clientes de IA conectarse a datos y herramientas externas a través de una sola URL o proceso local — piensa en él como USB para IA. Un servidor MCP de Google Search Console implementa ese protocolo para GSC: traduce solicitudes en lenguaje natural de tu IA en llamadas a la API de Google Search Console y devuelve JSON estructurado sobre el cual tu modelo puede razonar.
Lo configuras una vez. Después, haces preguntas en inglés sencillo y obtienes respuestas de tus datos reales de Search Console — no suposiciones genéricas de datos de entrenamiento.
flowchart LR
A[You in Claude / Cursor / Codex] --> B[MCP client]
B --> C[Google Search Console MCP Server]
C --> D[Google Search Console API]
C --> E[Google Analytics 4 API]
D --> F[Queries, clicks, indexing, sitemaps]
E --> G[Sessions, conversions, funnels]
F --> C
G --> C
C --> B
B --> A
Lo que obtienes:
| Sin MCP | Con un servidor MCP de GSC |
|---|---|
| Exportar CSV desde GSC, pegar en el chat | Preguntar "Top 20 consultas de los últimos 28 días con CTR inferior al 2%" |
| Inspección manual de URL una a la vez | Inspección por lotes de 10 URLs en una sola llamada de herramienta |
| Cambiar entre pestañas de GSC y GA4 | Cruzar clics (GSC) con conversiones (GA4) en una sola conversación |
| Capturas de pantalla estáticas para interesados | La IA genera tablas, resúmenes y recomendaciones a partir de datos en vivo |
Lo que puedes hacer
Conecta GenieSeo a Claude, Cursor o Codex y trabaja con datos en vivo de Search Console y GA4 — rastrea posiciones, corrige indexación, detecta oportunidades de contenido, cruza tráfico con conversiones y ejecuta flujos de trabajo SEO en inglés sencillo.
Esto no es un producto de chatbot. GenieSeo y los servidores MCP de GSC autoalojados son conectores. La conversación permanece dentro de Claude, Cursor, Codex o Antigravity — tu IA gana superpoderes, no una nueva interfaz que aprender.
¿Cuánto cuesta? (opciones gratuitas)
Todo lo que necesitas para empezar es gratuito.
| Elemento | Costo |
|---|---|
| API de Google Search Console | Gratis |
| API de Google Analytics 4 | Gratis |
| GenieSeo (MCP alojado, beta) | Gratis — sin tarjeta de crédito |
Autoalojado (uvx mcp-search-console) | Gratis (licencia MIT) |
| Claude / Cursor (muchos planes) | El nivel gratuito funciona para pruebas |
El único "costo" real es el tiempo de configuración: ~60 segundos en GenieSeo, o 15–45 minutos si autoalojas con Google Cloud OAuth.
Por qué los SEOs y desarrolladores usan MCP para Search Console
Problemas que resuelve MCP
- Cambio de contexto — La interfaz de GSC está diseñada para humanos que hacen clic en filtros, no para agentes que ejecutan auditorías repetibles en docenas de propiedades.
- Fricción de exportación — Search Analytics limita las exportaciones; la Inspección de URL es una URL por clic.
- Brecha de análisis — Los datos crudos en una hoja de cálculo aún necesitan un analista. MCP pone al analista (tu LLM) en la misma tubería que los datos.
- Puntos ciegos entre canales — Search Console muestra quién hizo clic; GA4 muestra qué pasó después. Una URL MCP combinada cierra ese ciclo.
Quién se beneficia
| Rol | Flujo de trabajo típico |
|---|---|
| Especialista SEO | Revisiones semanales de posiciones, verificaciones de canibalización, minería de oportunidades de contenido |
| Gerente de cuentas en agencia | Auditorías multicliente, resúmenes listos para clientes, triaje de indexación |
| Desarrollador | Errores de indexación, problemas de canónicos y correcciones — en el mismo IDE que el código |
| Especialista en marketing de contenido | Mapeo de consulta a página, optimización de CTR, briefs basados en demanda de búsqueda real |
| Fundador de startup | Instantáneas de crecimiento orgánico sin contratar un stack de herramientas SEO |
GenieSeo es gratis durante la beta — 28 herramientas, una URL MCP, sin necesidad de Python. Empezar gratis →
Google Analytics 4 en la misma URL MCP
La mayoría de los servidores MCP de GSC de código abierto son solo Search Console. El stack documentado aquí agrega 7 herramientas de GA4 en el mismo endpoint MCP y con el mismo consentimiento de Google OAuth (webmasters.readonly + analytics.readonly).
¿Por qué combinar GSC + GA4?
| Fuente de datos | Responde |
|---|---|
| Google Search Console | Qué consultas y páginas obtienen impresiones y clics; estado de indexación; salud de sitemaps |
| Google Analytics 4 | Sesiones, usuarios comprometidos, conversiones, ingresos, tráfico en tiempo real, embudos |
Ejemplo de indicación de referencia cruzada:
"Para mis 10 páginas de destino orgánicas principales por clics (últimos 28 días), obtén sesiones comprometidas de GA4 y tasa de conversión. Señala las páginas con muchos clics pero tasa de conversión inferior al promedio del sitio."
Esa sola pregunta usa análisis de búsqueda de GSC y run_ga4_report de GA4 — imposible en un solo paso sin un conector combinado.
Desactivar GA4 (solo autoalojado): establece GSC_DISABLE_GA4=true para exponer solo herramientas de GSC.
Las 28 herramientas MCP (referencia)
Llama a get_capabilities primero en cualquier sesión — devuelve el estado de autenticación y la lista completa de herramientas.
Autenticación (1 herramienta)
| Herramienta | Descripción |
|---|---|
reauthenticate | Volver a ejecutar el inicio de sesión OAuth en el navegador; úsalo cuando los tokens expiren o necesites cambiar de cuenta de Google |
Google Search Console — Propiedades (3 herramientas)
| Herramienta | Parámetros | Descripción |
|---|---|---|
list_properties | — | Lista todas las propiedades de GSC (empieza aquí para site_url) |
get_site_details | site_url | Detalles de verificación y propiedad |
get_creator_info | — | Metadatos del servidor y atribución |
Google Search Console — Analítica e informes (5 herramientas)
| Herramienta | Pregunta de ejemplo | Descripción |
|---|---|---|
get_search_analytics | "Top 20 consultas de los últimos 28 días con CTR inferior al 2%" | Principales consultas/páginas con clics, impresiones, CTR, posición |
get_performance_overview | "¿Cómo le está yendo a mi sitio este mes?" | Instantánea de KPIs de alto nivel |
compare_search_periods | "¿Qué consultas mejoraron respecto al mes pasado?" | Deltas entre períodos |
get_search_by_page_query | "¿Qué palabras clave generan tráfico a /pricing?" | Consultas que generan tráfico a una página |
get_advanced_search_analytics | "Principales consultas móviles de EE. UU. en los últimos 90 días" | Analítica multidimensional (país, dispositivo, consulta, página) |
Google Search Console — Inspección de URL e indexación (3 herramientas)
| Herramienta | Pregunta de ejemplo | Descripción |
|---|---|---|
inspect_url_enhanced | "¿Está indexada esta URL y cuál es el canónico?" | Estado completo de rastreo/índice/canónico/móvil/datos estructurados |
batch_url_inspection | "Inspecciona mis 10 páginas principales por clics" | Inspección masiva en una sola llamada (hasta 10 URLs) |
check_indexing_issues | "¿Cuáles de estas URLs tienen problemas de indexación?" | Resumen priorizado de problemas de indexación |
Google Search Console — Sitemaps (5 herramientas)
| Herramienta | Parámetros clave | Descripción |
|---|---|---|
get_sitemaps | site_url | Lista sitemaps |
list_sitemaps_enhanced | site_url | Estado detallado del sitemap, errores, advertencias |
get_sitemap_details | site_url, sitemap_url | Análisis profundo de un solo sitemap |
submit_sitemap | site_url, sitemap_url | Enviar un sitemap |
manage_sitemaps | site_url, action | Enviar o eliminar sitemaps |
Google Search Console — Destructivas (desactivadas por defecto, 2 herramientas)
Requiere GSC_ALLOW_DESTRUCTIVE=true:
| Herramienta | Descripción |
|---|---|
add_site | Agregar una propiedad a GSC |
delete_site | Eliminar una propiedad de GSC |
Google Analytics 4 (7 herramientas)
| Herramienta | Parámetros clave | Descripción |
|---|---|---|
list_ga4_properties | — | Todas las propiedades GA4 en la cuenta conectada (empieza aquí) |
get_ga4_property_details | property_id | Zona horaria, moneda, industria, cuenta principal |
get_ga4_custom_dimensions_and_metrics | property_id | Definiciones personalizadas en la propiedad |
list_ga4_ads_links | property_id | Cuentas de Google Ads vinculadas |
list_ga4_property_annotations | property_id | Marcadores de fecha para eventos que afectan a los datos |
run_ga4_report | property_id, dimensiones, métricas, fechas | Informes flexibles (sesiones, usuarios, ingresos, etc.) |
run_ga4_realtime_report | property_id | Últimos ~30 minutos de actividad en vivo |
run_ga4_funnel_report | property_id, pasos del embudo | Embudo de conversión paso a paso |
Meta (1 herramienta)
| Herramienta | Descripción |
|---|---|
get_capabilities | Catálogo completo de herramientas + estado de autenticación en vivo — llama a esto primero |
¿Alojado o autoalojado? ¿Cuál deberías elegir?
| Factor | GenieSeo (alojado, beta gratuita) | Autoalojado (uvx mcp-search-console) |
|---|---|---|
| Tiempo de configuración | ~60 segundos | 15–45 minutos (Google Cloud + configuración del cliente) |
| Python / terminal | No es necesario | Necesario (uvx o clonar) |
| Herramientas GA4 | Incluidas (7 herramientas) | Incluidas en este stack |
| Claude en la web (claude.ai) | Sí — URL MCP HTTPS | No por defecto (stdio = solo Desktop) |
| Claude Desktop | Sí | Sí |
| Cursor | Sí | Sí (con configuración local) |
| OAuth | Inicio de sesión de Google con un clic | Manual client_secrets.json |
| Almacenamiento de tokens | Gestionado de forma segura por GenieSeo | Local token.json en tu máquina |
| Coste | Gratis durante la beta (sin tarjeta de crédito) | Gratis (licencia MIT) |
| Ideal para | SEOs, agencias, incorporación rápida | Desarrolladores, entornos aislados, despliegues personalizados |
Recomendación:
- Elige GenieSeo si quieres hacer consultas en menos de un minuto, necesitas GA4 + GSC juntos, usas Claude en la web o quieres compartir acceso con compañeros no técnicos — actualmente gratis en beta.
- Elige autoalojado si necesitas control total sobre las credenciales, despliegues Docker personalizados o cero dependencia de un servicio alojado.
Configuración en 60 segundos — GenieSeo (alojado)
GenieSeo es el servidor MCP de Google Search Console alojado con GA4 — una URL MCP personal, transporte HTTP Streamable, sin client_secrets.json. Gratis durante la beta (sin tarjeta de crédito).
Mira primero (recomendado)
Haz clic en la imagen para seguir el tutorial — menos de dos minutos desde el registro hasta tu primera consulta en Claude.
Pasos
- Regístrate en seo.geniedial.in/signup — beta gratuita, sin tarjeta de crédito
- Conecta Google — una sola pantalla OAuth para acceso de lectura a Search Console + Analytics
- Copia tu URL MCP desde el panel de GenieSeo (formato:
https://seo.geniedial.in/mcp/u/YOUR_TOKEN) - Pégalo en tu cliente de IA (consulta las guías de clientes más abajo)
- Haz tu primera pregunta: "Lista mis propiedades de Search Console" o "Llama a get_capabilities"
Fragmento de configuración MCP (cualquier cliente Streamable HTTP)
{
"mcpServers": {
"genieseo": {
"url": "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
}
}
}
Reemplaza YOUR_TOKEN con el token de tu panel de GenieSeo.
Transporte: Streamable HTTP (especificación MCP 2025-03-26) — un único endpoint /mcp para POST (JSON-RPC), GET (streaming), DELETE (fin de sesión).
Configuración autoalojada — código abierto
El servidor MCP de Google Search Console de código abierto se ejecuta localmente mediante uvx o desde un repositorio clonado. Las herramientas GA4 se cargan automáticamente a menos que GSC_DISABLE_GA4=true.
Requisitos previos
- Python 3.11+
- uv (recomendado) o virtualenv
- Proyecto de Google Cloud con la API de Search Console habilitada
- Para GA4: Google Analytics Data API y Google Analytics Admin API habilitadas en el mismo proyecto
Opción A — OAuth (recomendado para particulares)
- Google Cloud Console → Crear/seleccionar proyecto
- Habilita la API de Search Console
- Habilita Analytics Data API y Analytics Admin API (para herramientas GA4)
- Credenciales → Crear → ID de cliente OAuth → Aplicación de escritorio
- Descarga el JSON → guárdalo como p. ej.
~/Documents/client_secrets.json - En la primera ejecución, el navegador se abre para iniciar sesión en Google; el token se guarda en el directorio de configuración de la plataforma
Opción B — Cuenta de servicio (automatización / equipos)
- Crea una cuenta de servicio + descarga la clave JSON
- Añade el correo de la cuenta de servicio a cada propiedad de GSC (Configuración → Usuarios → Acceso completo)
- Para GA4: concede Viewer (o superior) en GA4 Admin para cada propiedad
- Configura
GSC_CREDENTIALS_PATHyGSC_SKIP_OAUTH=true
Instalar con uvx (autoalojado más rápido)
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
# Verify
uv --version
which uvx
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
}
}
}
}
Usa la ruta completa de which uvx — las aplicaciones GUI no leen tu PATH del shell.
Variante de cuenta de servicio:
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": {
"GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
"GSC_SKIP_OAUTH": "true"
}
}
}
}
Clonar y ejecutar localmente
Prefiere uvx mcp-search-console cuando solo necesites ejecutar el servidor — no se requiere clonar (consulta la Opción A más arriba).
Para modificar el código fuente localmente:
git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc
uv venv .venv
uv pip install -r requirements.txt
uv run python gsc_server.py
Variables de entorno
| Variable | Por defecto | Descripción |
|---|---|---|
GSC_OAUTH_CLIENT_SECRETS_FILE | — | Ruta al JSON de secretos del cliente OAuth |
GSC_CREDENTIALS_PATH | — | Ruta al JSON de la cuenta de servicio |
GSC_SKIP_OAUTH | false | Forzar modo de cuenta de servicio |
GSC_DATA_STATE | all | all = paridad con el panel de GSC; final = solo datos confirmados (retraso de 2–3 días) |
GSC_ALLOW_DESTRUCTIVE | false | Habilitar add_site, delete_site, eliminación de sitemaps |
GSC_DISABLE_GA4 | false | Omitir registro de herramientas GA4 |
MCP_TRANSPORT | stdio | Configurar streamable-http para remoto/Docker |
MCP_HOST | 127.0.0.1 | Host de enlace para transporte HTTP |
MCP_PORT | 3001 | Puerto de enlace para transporte HTTP |
Docker (remoto / contenedor)
docker build -t mcp-gsc .
docker run \
-e MCP_TRANSPORT=streamable-http \
-e MCP_HOST=0.0.0.0 \
-e MCP_PORT=3001 \
-e GSC_CREDENTIALS_PATH=/app/credentials.json \
-v /path/to/credentials.json:/app/credentials.json \
-p 3001:3001 \
mcp-gsc
Endpoint: http://<host>:3001/mcp
Nota: El transporte
sseobsoleto se ha eliminado. Usa solostreamable-http.
Habilidades del Marketplace de Cursor (autoalojado en Cursor)
Busca mcp-search-console en el Marketplace de Cursor para habilidades incluidas:
| Habilidad | Invoca con | Propósito |
|---|---|---|
seo-weekly-report | "Ejecuta el informe semanal de SEO para example.com" | Rendimiento de 28 días + comparación de períodos |
cannibalization-check | "Comprueba la canibalización de palabras clave en example.com" | Páginas en competencia por consulta |
indexing-audit | "Audita la indexación de mis páginas principales" | Inspección por lotes de las URLs principales |
content-opportunities | "Encuentra oportunidades de contenido para example.com" | Posición 11–20 + impresiones altas |
Verificar la instalación
Pregunta a tu IA: "Lista mis propiedades de GSC" o "Llama a get_capabilities".
Conecta a Claude, Cursor, Codex y Antigravity
Claude (web — claude.ai)
Requiere una URL Streamable HTTP (GenieSeo alojado). Los servidores stdio locales no funcionan en el navegador.
- Claude → Configuración → Conectores → Añadir MCP personalizado
- Nombre:
GenieSeo - URL:
https://seo.geniedial.in/mcp/u/YOUR_TOKEN - Guarda → inicia un nuevo chat → pregunta sobre datos de Search Console
Guía completa: Conecta Search Console a Claude
Claude Desktop
- Alojado: la misma URL de arriba en la configuración de MCP
- Autoalojado:
claude_desktop_config.jsonconuvx+ variables de entorno (consulta autoalojado)
Cursor
- Configuración → MCP → Añadir servidor MCP
- Nombre:
GenieSeo - URL: tu URL MCP de GenieSeo (o endpoint streamable-http local)
- Úsalo en Chat o en Composer (modo agente) — los agentes llaman a las herramientas MCP directamente
Guía completa: Conecta Search Console a Cursor
Codex CLI
~/.codex/config.toml:
[mcp_servers.genieseo]
url = "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
enabled = true
OAuth autoalojado:
[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }
Antigravity
Añade la misma URL MCP de GenieSeo en la configuración de MCP de Antigravity. Una sola URL funciona en todos los clientes Streamable HTTP.
Ejemplos de prompts y flujos de trabajo SEO
Rendimiento de búsqueda
Show me the top 20 search queries for [site] in the last 30 days.
Highlight any with CTR below 2% and suggest title tag improvements.
Compare my site's Search Console performance between last month and the month before.
Which queries improved position the most? Which pages lost clicks?
Find queries with high impressions but average position below 10,
filtered to mobile traffic in the United States only.
Indexación y SEO técnico
Check these URLs for indexing issues:
https://example.com/product
https://example.com/services
https://example.com/about
Group results by issue type and prioritize fixes by estimated traffic impact.
Inspect my top 20 pages by clicks (last 28 days) for indexing status.
Return a table: URL, index status, canonical, last crawl, recommended action.
Sitemaps
List all sitemaps for [site], flag any with errors or warnings,
and recommend which sitemap entries to investigate first.
Analítica GA4
List my GA4 properties, then for property [ID] run a report:
sessions and conversions by landing page for the last 28 days, organic traffic only.
Show realtime active users on [property] broken down by country.
Referencia cruzada GSC + GA4
Pull my top 15 organic landing pages by GSC clicks (last 28 days).
For each, get GA4 engaged sessions and conversion rate.
Flag high-click / low-conversion pages and suggest hypotheses.
Revisión semanal para agencias
For client site [site_url]:
1. Top 50 queries this week vs last week
2. Flag positions that dropped more than 3 places
3. List affected URLs
4. Draft a 3-bullet client email summary
Casos de uso por rol
Agencia SEO
- Revisiones semanales de posiciones en muchas propiedades de clientes sin exportaciones CSV
- Auditorías técnicas — inspección por lotes de URLs + triaje de tráfico GA4
- Informes para clientes — markdown o JSON estructurados que tu IA formatea para presentaciones
Guía: Flujos de trabajo SEO con IA para agencias
SEO freelance
- Detección de canibalización, análisis de brechas de contenido, triaje de indexación en un portátil entre llamadas
Desarrollador
- Diagnostica problemas de indexación, canónicos y de datos estructurados dentro de Cursor mientras editas la solución
Guía: Desarrolladores + Search Console en Cursor
Especialista en contenido
- Mapeo de consulta a página, optimización de CTR a partir de datos reales de demanda de Search Console
Startup
- Instantáneas de crecimiento orgánico y priorización de contenido sin una suscripción completa a herramientas SEO
Seguridad, privacidad y permisos
Ámbitos OAuth (solo lectura por defecto)
| Ámbito | Acceso |
|---|---|
webmasters.readonly | Datos de Search Console (analítica, inspección, sitemaps) |
analytics.readonly | Informes GA4 y metadatos de propiedades |
Las operaciones de escritura (enviar sitemap, añadir/eliminar sitio) requieren configuración explícita del servidor (GSC_ALLOW_DESTRUCTIVE=true) en despliegues autoalojados.
GenieSeo alojado
- Tokens OAuth cifrados en reposo
- URL MCP por usuario — los tokens no se comparten entre cuentas
- Revoca el acceso en cualquier momento mediante los permisos de la cuenta de Google o el panel de GenieSeo
- Sin venta de datos de Google; arquitectura solo de conector
Autoalojado
- Tokens almacenados localmente (
token.jsonen el directorio de configuración de usuario de la plataforma) - Tú controlas la exposición de red (por defecto: stdio, sin puertos abiertos)
- Despliegues Docker/HTTP: volumen de credenciales seguro y terminación TLS en tu borde
Precios
| Plan | Precio | Incluye |
|---|---|---|
| GenieSeo Beta | Gratis (sin tarjeta de crédito) | 28 herramientas, GSC + GA4, URL MCP alojada, todas las propiedades verificadas en la cuenta de Google conectada — gratis durante la beta |
| GenieSeo Pro (hoja de ruta) | Por determinar | Espacios de trabajo de equipo, límites más altos, soporte prioritario |
| Autoalojado | Gratis (MIT) | Código fuente completo, propiedades ilimitadas, solo los costes de tu infraestructura |
Detalles: seo.geniedial.in/pricing
Claude y Cursor se facturan por separado por Anthropic y Cursor. GenieSeo es solo el conector de datos — gratis durante la beta.
Comparaciones
GenieSeo vs servidores MCP autoalojados solo GSC
| GenieSeo (alojado, beta gratuita) | MCP GSC autoalojado típico | |
|---|---|---|
| GA4 | Sí (7 herramientas) | Normalmente no |
| Claude web | Sí | No (stdio por defecto) |
| Configuración | ~60s | ~30 min |
| Paquete | URL alojada | uvx mcp-search-console o clon local |
Comparación completa: GenieSeo vs otros servidores MCP de GSC
GenieSeo vs Advanced GSC Visualizer (extensión de Chrome)
| GenieSeo MCP | Advanced GSC Visualizer | |
|---|---|---|
| Dónde se ejecuta | Claude, Cursor, Codex | Dentro de la pestaña del navegador de GSC |
| Flujos de trabajo con IA | Sí | No |
| GA4 | Sí | No |
Comparación completa: GenieSeo vs Advanced GSC
Mejores servidores MCP de Google Search Console (resumen 2026)
Vea la comparación seleccionada: Mejores servidores MCP de GSC 2026
Arquitectura
Servidor MCP de un solo archivo (núcleo autoalojado)
El servidor está construido con FastMCP — sin framework personalizado. Módulos principales:
| Archivo | Función |
|---|---|
gsc_server.py | Herramientas de GSC, autenticación OAuth/cuenta de servicio, transporte MCP |
ga4_tools.py | Herramientas de GA4 registradas en la misma instancia de FastMCP |
Orden de autenticación:
- OAuth
token.json(alojado o local) - JSON de cuenta de servicio (
GSC_CREDENTIALS_PATH) cuandoGSC_SKIP_OAUTH=trueo OAuth no esté disponible
Formato de respuesta: Todas las herramientas de datos devuelven json.dumps(structured_data) — optimizado para el razonamiento de LLM, no para prosa.
Pila alojada de GenieSeo (alto nivel)
GenieSeo es un conector cloud gestionado. Sigues usando Claude, Cursor o Codex como siempre — GenieSeo gestiona OAuth de Google, almacenamiento seguro de tokens y el endpoint MCP que habla con Google Search Console y GA4 en tu nombre.
flowchart LR
A[You in Claude / Cursor / Codex] --> B[Your personal GenieSeo MCP URL]
B --> C[GenieSeo managed service]
C --> D[Google Search Console API]
C --> E[Google Analytics 4 API]
D --> C
E --> C
C --> B
B --> A
Lo que controlas: qué cuenta de Google conectar, cuándo revocar el acceso y cada pregunta que haces en tu cliente de IA.
Lo que gestiona GenieSeo: OAuth, almacenamiento cifrado de credenciales, disponibilidad y mantener las herramientas MCP sincronizadas con las APIs de Google — para que nunca gestiones client_secrets.json ni tokens locales.
FAQ
¿Qué es un servidor MCP de Google Search Console?
Un servidor que implementa el Protocolo de Contexto de Modelo para exponer Google Search Console (y opcionalmente GA4) como herramientas invocables dentro de asistentes de IA como Claude y Cursor.
¿Cuál es el mejor servidor MCP de Google Search Console en 2026?
Para configuración más rápida y GA4: GenieSeo (alojado, beta gratuita, 28 herramientas, compatible con Claude web). Para control local completo: autoalójalo con uvx mcp-search-console (ver configuración autoalojada).
¿Cómo conecto Google Search Console a Claude?
Regístrate en GenieSeo, conecta OAuth de Google, copia tu URL MCP, pégala en Configuración de Claude → Conectores → Añadir MCP personalizado. En menos de 60 segundos. Guía paso a paso · Video de configuración.
¿Funciona con Claude en la web (claude.ai)?
Sí con GenieSeo (URL HTTPS Streamable HTTP). Los servidores stdio autoalojados solo funcionan en Claude Desktop, no en el navegador.
¿Funciona con Cursor?
Sí. Añade tu URL MCP en Configuración de Cursor → MCP. El modo agente Composer puede llamar a todas las herramientas de GSC y GA4. Guía de Cursor.
¿Cuántas herramientas se incluyen?
28 en total: 21 de Google Search Console + 7 de Google Analytics 4 en una sola URL MCP.
¿Se incluye Google Analytics?
Sí en esta pila (GenieSeo alojado y el paquete mcp-search-console / uvx). La mayoría de los otros servidores MCP solo de GSC no incluyen GA4.
¿Están seguros mis datos de Google?
Los tokens OAuth tienen alcances de solo lectura. Los tokens alojados están cifrados en reposo. Revoca en cualquier momento a través de tu cuenta de Google o tu panel. Los tokens autoalojados permanecen en tu máquina.
¿Hay una opción gratuita?
Sí — GenieSeo es gratuito durante la beta (sin tarjeta de crédito); el autoalojado tiene licencia MIT y es gratuito para siempre.
¿Necesito Python?
No para GenieSeo alojado. Sí para autoalojado (uvx o clonar).
¿Qué es MCP?
Protocolo de Contexto de Modelo — un estándar abierto para que los clientes de IA se conecten a herramientas externas y fuentes de datos.
¿Puedo usar varias cuentas de Google?
GenieSeo: una cuenta de Google por usuario hoy; espacios de trabajo multi-cuenta en la hoja de ruta. Autoalojado: reautentica o usa configuraciones separadas.
¿Qué es get_capabilities?
Una meta-herramienta que devuelve todas las herramientas disponibles, agrupadas por categoría, más el estado de autenticación en vivo. Llámala primero al depurar o incorporar.
¿Por qué recibo spawn uvx ENOENT?
Tu cliente de IA no puede encontrar uvx en PATH. Usa la ruta completa de which uvx en tu configuración MCP.
¿Puedo desactivar operaciones destructivas de GSC?
Sí — están desactivadas por defecto. Establece GSC_ALLOW_DESTRUCTIVE=true solo si necesitas añadir/eliminar sitio o eliminar sitemap.
¿Qué transporte debo usar para despliegue remoto?
MCP_TRANSPORT=streamable-http. El transporte obsoleto sse ya no es compatible.
¿Dónde está el código de código abierto?
Instala con uvx mcp-search-console (PyPI). Para modificar el código fuente, clona una copia local — ver clonar y ejecutar localmente. El servidor con licencia MIT alimenta tanto el autoalojado como los despliegues alojados de GenieSeo.
¿En qué se diferencia de exportar CSV de GSC?
MCP devuelve JSON estructurado directamente a tu IA — sin exportación manual, sin límites de filas en el chat, y el modelo puede encadenar múltiples llamadas de herramientas (inspeccionar → analizar → recomendar) en una sola conversación.
¿Pueden las agencias usarlo para clientes?
Sí. Conecta una cuenta de Google con acceso a las propiedades del cliente; cada miembro del equipo puede tener su propia URL MCP. Cambia de propiedades a mitad de conversación nombrando el site_url.
Recursos y enlaces
Producto
| Recurso | URL |
|---|---|
| GenieSeo — Comienza (beta gratuita) | https://seo.geniedial.in/signup |
| GenieSeo página de inicio | https://seo.geniedial.in |
| Precios | https://seo.geniedial.in/pricing |
| Biblioteca de recetas (prompts de copiar y pegar) | https://seo.geniedial.in/recipes |
| Video de configuración | Ver video de configuración |
Autoalojado (código abierto)
| Recurso | URL |
|---|---|
| Paquete PyPI (recomendado) | uvx mcp-search-console |
| Licencia | MIT |
| Clonar para desarrollo | Ver clonar y ejecutar localmente |
Guías de configuración
| Cliente | URL |
|---|---|
| Claude | https://seo.geniedial.in/integrations/claude |
| Cursor | https://seo.geniedial.in/integrations/cursor |
| Codex | https://seo.geniedial.in/integrations/codex |
| ChatGPT | https://seo.geniedial.in/integrations/chatgpt |
| Todas las integraciones | https://seo.geniedial.in/integrations |
Blog y contenido SEO
| Tema | URL |
|---|---|
| Resumen de GSC MCP | https://seo.geniedial.in/blog/google-search-console-mcp-server |
| Conectar GSC a Claude | https://seo.geniedial.in/blog/connect-google-search-console-to-claude-ai |
| Servidor MCP de GA4 | https://seo.geniedial.in/blog/ga4-mcp-server-claude-cursor |
| Mejores servidores MCP de GSC 2026 | https://seo.geniedial.in/blog/best-google-search-console-mcp-servers-2026 |
Soporte
- Correo electrónico: support@geniedial.in
- Fundador: Nirav Modi en LinkedIn
Registro de cambios (servidor)
| Versión | Destacados |
|---|---|
| Siguiente | Transporte Streamable HTTP; sse eliminado |
| 0.3.2 | Corrección de OAuth para uvx; herramienta get_capabilities; mejores errores de autenticación |
| 0.3.0 | Plugin de Cursor Marketplace; 4 habilidades SEO; salida JSON estructurada |
| 0.2.x | Modo de seguridad para operaciones destructivas; Docker; transporte HTTP |
| 0.1.0 | 19 herramientas iniciales de GSC; OAuth + cuenta de servicio |
Construido por Peakenza Software Services. GenieSeo es gratuito durante la beta. La pila autoalojada tiene licencia MIT. Preguntas: support@geniedial.in