mcp-google-search-console

Google Search Console MCP

Español | Русский

A1 Google Search Console MCP conecta una aplicación de IA con Google Search Console. Investiga el rendimiento de búsqueda, comprueba si una URL está indexada, inspecciona sitemaps y envía o elimina deliberadamente un sitemap cuando sea necesario.

Funciona con las propiedades a las que tu cuenta de Google puede acceder. El detalle importante es que utiliza el valor exacto de la propiedad de Search Console: una propiedad de dominio y una propiedad de prefijo de URL son objetos diferentes.

• 18 herramientas. Siete herramientas leen propiedades, datos de búsqueda, sitemaps y estado de indexación; dos añaden una propiedad o envían un sitemap; tres pueden eliminar datos o llamar a un método arbitrario de la API.
• Se conecta desde la conversación. Di "conectar Google Search Console": el servidor te guía a través del cliente OAuth, captura la redirección de Google en 127.0.0.1 con PKCE y guarda los tokens él mismo — sin archivos de configuración, sin reinicios.
• IDs de propiedad exactos. https://example.com/, https://www.example.com/ y sc-domain:example.com son distintos. list_sites muestra el valor a usar.
• Datos de búsqueda con contexto. Consulta clics, impresiones, CTR y posición por fecha, página, consulta, país, dispositivo o apariencia de búsqueda.
• Indexación, no publicación. La inspección de URL explica el estado actual de Google; no fuerza una página en el índice.

Comienza con una pregunta de solo lectura:

Muestra las 20 consultas de búsqueda principales de mi propiedad en los últimos 28 días, con clics y CTR.

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Tú: ¿Está https://example.com/pricing indexada? Si no, ¿por qué?

Asistente: Inspecciona la URL y muestra el veredicto de indexación, cobertura, información de rastreo y URLs canónicas. No cambia nada.

Tú: Revisa mis sitemaps enviados y prepara un reenvío para el que tenga errores.

Asistente: Muestra el sitemap, sus advertencias y errores, y luego pide confirmación antes de enviarlo de nuevo.

Tú: Confirmo.

Asistente: Reenvía el sitemap seleccionado. No cambia el contenido de la página ni garantiza la indexación.

Contenido

• Inicio rápido
• Qué puedes pedirle que haga
• Cómo funcionan las propiedades de Search Console
• Qué puede cambiar
• Obtener acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesitas Node.js 20+ y una cuenta de Google. No se requieren credenciales en el momento de la instalación — el servidor se conecta desde la conversación.

1. Añade el servidor a tu aplicación de IA.
2. Di "conectar Google Search Console": el asistente te guía a través de crear el cliente OAuth y aprobar el acceso sin editar archivos de configuración.
3. Comienza con la pregunta de solo lectura anterior.

codex mcp add google-search-console \
  -- npx -y mcp-google-search-console@latest
codex mcp list

claude mcp add \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

Qué puedes pedirle que haga

Encontrar oportunidades de búsqueda

• ¿Qué consultas y páginas trajeron más clics este mes?
• ¿Qué páginas perdieron clics en comparación con el período anterior?
• Muestra consultas que contengan mcp donde la posición promedio sea inferior a 10.

Comprobar estado de indexación y sitemaps

• ¿Está indexada esta URL? Muestra cobertura, rastreo e información canónica.
• ¿Qué sitemaps enviados tienen errores o advertencias?
• Reenvía este sitemap después de mostrar su estado actual.

Gestionar propiedades con cuidado

• Lista las propiedades de Search Console a las que puedo acceder.
• Añade este valor exacto de propiedad; verificaré la propiedad por separado.
• Elimina esta propiedad de mi cuenta después de la confirmación.

Cómo funcionan las propiedades de Search Console

Una propiedad de prefijo de URL debe incluir su protocolo y barra final, por ejemplo https://example.com/. Una propiedad de dominio se escribe como sc-domain:example.com. Una coincidencia aproximada causa 403 o 404, así que usa el valor exacto devuelto por list_sites.

add_site solo registra una propiedad. La verificación permanece en la interfaz de Search Console o en la API de verificación de sitios. Los datos de búsqueda usan hora del Pacífico; end_date es inclusivo y los datos analíticos finales suelen retrasarse de dos a tres días. data_state: "all" puede incluir filas más recientes y aún cambiantes.

Qué puede cambiar

El cliente de IA controla los avisos de confirmación. El servidor marca lecturas, escrituras y llamadas destructivas para que el cliente pueda distinguir una inspección de un cambio real.

Obtener acceso

Google Search Console requiere OAuth 2.0; una clave de API no es suficiente. Hay dos formas de acceder, y la primera no necesita archivos de configuración.

Conectar desde el chat (recomendado)

Di "conectar Google Search Console" y el asistente ejecuta el flujo contigo:

1. setup_instructions imprime la lista de verificación: crea o selecciona un proyecto de Google Cloud, habilita Google Search Console API, configura la pantalla de consentimiento y crea un cliente OAuth de Aplicación de escritorio.
2. Descarga el JSON de ese cliente ("Descargar JSON") y dale al asistente su ruta — set_client lo almacena solo para el propietario. El secreto nunca pasa por la conversación.
3. start_login devuelve un enlace de consentimiento de Google. Ábrelo en esta máquina y aprueba; el código vuelve a un listener de un solo uso en 127.0.0.1 (PKCE), nunca a través del chat.
4. finish_login intercambia el código y guarda los tokens en ~/.config/mcp-google-search-console/credentials.json (modo 0600) y los verifica con una llamada real a la API de Google Search Console — así, una API que aún está desactivada se detecta en ese momento.

Los tokens se releen en cada llamada, por lo que la conexión funciona de inmediato — sin reiniciar la aplicación de IA. auth_status muestra qué está conectado, logout revoca y elimina.

Variables de entorno (CI, instalaciones desatendidas)

1. Crea o selecciona un proyecto de Google Cloud y habilita Google Search Console API.
2. Configura la pantalla de consentimiento de OAuth y crea un cliente OAuth de Aplicación de escritorio.
3. Usa el OAuth 2.0 Playground con Usar tus propias credenciales OAuth para autorizar la cuenta de Google que puede acceder a las propiedades y obtener un token de actualización.
4. Usa https://www.googleapis.com/auth/webmasters para incluir sitemaps y cambios de propiedad. Usa https://www.googleapis.com/auth/webmasters.readonly solo si necesitas intencionalmente acceso de solo lectura.

Los tokens de actualización en modo de prueba pueden expirar después de siete días. Publica la aplicación OAuth, o usa una aplicación interna de Workspace, para acceso a largo plazo. Trata el secreto del cliente y el token de actualización como contraseñas.

Configuración

Cada variable es opcional — sin ninguna de ellas, el servidor se conecta desde el chat.

* Proporciona el trío OAuth o un token de acceso.

Datos, límites y trabajo en segundo plano

• Privacidad. El servidor local llama a Google y envía telemetría anónima con un ID de instalación, versiones y nombres de herramientas — nunca tokens OAuth, datos de propiedad, argumentos de herramientas o avisos. Establece ASKADS_TELEMETRY=0 para optar por no participar.
• Límites de API. La inspección de URL permite 2,000 inspecciones por propiedad por día y 600 por minuto. Los análisis devuelven como máximo 25,000 filas por solicitud; las consultas anónimas de cola larga nunca se devuelven. Usa paginación y no inspecciones sitios completos URL por URL.
• Sin monitoreo en segundo plano. El servidor funciona solo cuando se le llama. Si tu aplicación de IA admite tareas programadas, puede verificar periódicamente un sitemap o una URL importante.

Documentación técnica

• Catálogo de capacidades MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas y entradas
• Documentación de desarrollo
• Documentación de publicación
• API de Google Search Console

Soporte

¿Encontraste un error o necesitas un escenario? Crea un problema o escribe en Telegram.

¡Llegaste al final!