Google Search Console

Servidor MCP de Google Search Console

Un servidor de Model Context Protocol (MCP) que brinda a los agentes de IA acceso directo a tus datos de Google Search Console.

• Analítica de búsqueda — consulta clics, impresiones, CTR y posición media por página, consulta, país, dispositivo o rango de fechas
• Comparar períodos — tendencias semana a semana, mes a mes
• Encontrar oportunidades — consultas con muchas impresiones y pocos clics, palabras clave que no sabías que estaban posicionando
• Seguimiento de páginas específicas — ve qué URLs están ganando o perdiendo tracción
• Cobertura de indexación — comprueba qué páginas están indexadas, excluidas o con errores
• Estado de sitemaps — verifica que los sitemaps se están leyendo y cuántas URLs están indexadas

Acceso de solo lectura: este servidor no puede enviar URLs, modificar configuraciones ni realizar cambios en tus propiedades de Search Console.

[!IMPORTANT] Este servidor utiliza autenticación de cuenta de servicio. La cuenta de servicio debe agregarse como usuario en cada propiedad de Search Console a la que quieras acceder.

Herramientas

list_sites

Lista todos los sitios (propiedades) a los que tienes acceso en Google Search Console.

No se requieren parámetros.

search_analytics

Consulta datos de analítica de búsqueda: clics, impresiones, CTR y posición.

Parámetro	Tipo	Requerido	Descripción
siteUrl	string	Sí	URL del sitio tal como aparece en Search Console (p. ej. https://example.com/ o sc-domain:example.com)
startDate	string	Sí	Fecha de inicio en formato YYYY-MM-DD
endDate	string	Sí	Fecha de fin en formato YYYY-MM-DD
dimensions	string	No	Separados por comas: query, page, country, device, searchAppearance, date
rowLimit	number	No	Máximo de filas a devolver (por defecto 100, máximo 25000)
searchType	string	No	web, image, video, news, discover o googleNews (por defecto web)
queryFilter	string	No	Filtrar por consulta. Prefija con regex: para coincidencia de expresiones regulares
pageFilter	string	No	Filtrar por URL de página. Prefija con regex: para coincidencia de expresiones regulares
countryFilter	string	No	Código de país ISO 3166-1 alfa-3 (p. ej. USA, GBR)
deviceFilter	string	No	DESKTOP, MOBILE o TABLET

inspect_url

Comprueba el estado de indexación, la información de rastreo y la usabilidad móvil de una URL.

Parámetro	Tipo	Requerido	Descripción
siteUrl	string	Sí	URL del sitio tal como aparece en Search Console
inspectionUrl	string	Sí	La URL completa a inspeccionar (debe pertenecer al sitio)

list_sitemaps

Lista todos los sitemaps enviados y su estado para un sitio.

Parámetro	Tipo	Requerido	Descripción
siteUrl	string	Sí	URL del sitio tal como aparece en Search Console

Instalación

Configuración rápida mediante agente

¿Ya tienes tu clave de cuenta de servicio? Pega este prompt en Claude Code o Claude Desktop y configurará todo por ti:

Clona y compila el servidor MCP de Google Search Console desde https://github.com/sarahpark/google-search-console-mcp, y luego agrégalo a mi configuración global de MCP. Mi clave de cuenta de servicio está en /path/to/service-account-key.json. Después de la configuración, llama a list_sites para verificar que funciona.

Reemplaza la ruta de la clave con la ubicación real de tu archivo.

Compilar desde el código fuente

git clone https://github.com/sarahpark/google-search-console-mcp.git
cd google-search-console-mcp
npm install
npm run build

Configuración

Configuración de Google Cloud: clave de cuenta de servicio

1. Ve a Google Cloud Console y crea un nuevo proyecto (o selecciona uno existente)
2. Abre la página de la API de Search Console y haz clic en Habilitar
3. En la barra lateral, ve a APIs y servicios → Credenciales
4. Haz clic en Crear credenciales → Cuenta de servicio
5. Asigna un nombre (p. ej. "search-console-mcp"), luego haz clic en Crear y continuar
6. Puedes omitir los pasos opcionales de rol/acceso: haz clic en Listo
7. En la página de Credenciales, haz clic en la cuenta de servicio que acabas de crear
8. Ve a la pestaña Claves → Agregar clave → Crear clave nueva → selecciona JSON → haz clic en Crear
9. Se descargará un archivo de clave .json: guárdalo en un lugar seguro (p. ej. ~/.config/gcloud/service-account-key.json)

[!CAUTION] Trata este archivo de clave como una clave secreta. No lo guardes dentro de tu repositorio de proyecto ni lo confirmes en git. Guárdalo fuera de tu directorio de proyecto y refiérelo por ruta absoluta en tu configuración de MCP.

Acceso a Google Search Console

1. Copia la dirección de correo electrónico de la cuenta de servicio (se parece a name@project-id.iam.gserviceaccount.com: puedes encontrarla en la página de detalles de la cuenta de servicio)
2. Ve a Google Search Console
3. Selecciona tu propiedad, luego ve a Configuración → Usuarios y permisos
4. Haz clic en Agregar usuario, pega el correo de la cuenta de servicio, establece el permiso en Restringido y haz clic en Agregar

Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/absolute/path/to/google-search-console-mcp/build/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Claude Code (VS Code)

Agrega al objeto "mcpServers" en ~/.claude.json:

{
  "mcpServers": {
    "gsc": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/google-search-console-mcp/build/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Uso

Una vez configurado, pregunta a Claude de forma natural:

• "Lista mis propiedades de Search Console"
• "Muéstrame las 20 consultas principales de mi sitio en los últimos 28 días"
• "Comprueba el estado de indexación de https://example.com/blog/my-post"
• "Compara el rendimiento de móvil vs escritorio este mes"
• "¿Qué sitemaps están enviados para mi sitio?"

Licencia

MIT