Google Search Console MCP Server — Análisis de búsqueda, indexación de URL y gestión de sitemaps para asistentes de IA (SEO / LLMO)

mcp-server-gsc es un servidor MCP (Model Context Protocol) para Google Search Console que conecta tus datos de rendimiento de búsqueda con Claude o cualquier cliente MCP. Permite a los asistentes de IA consultar análisis de búsqueda (clics, impresiones, CTR, posición), inspeccionar el estado de indexación de URL y rastreo, y gestionar sitemaps — para que puedas analizar y optimizar el SEO y LLMO de tu sitio web directamente desde una conversación.

Herramientas

Related MCP server: Google Search Console MCP Server

Configuración

1. Compilación

npm install
npm run build

2. Credenciales de Google Cloud

Necesitas un proyecto de Google Cloud con la Search Console API habilitada (console.cloud.google.com → API y Servicios → Biblioteca → "Google Search Console API" → Habilitar).

Luego elige uno de los dos métodos de autenticación:

Opción A — OAuth (recomendado: inicia sesión con tu propia cuenta de Google)

1. API y Servicios → Credenciales → Crear credenciales → ID de cliente de OAuth → Tipo de aplicación Aplicación de escritorio.

2. Si se te solicita, configura primero la pantalla de consentimiento de OAuth (Externa es suficiente; añade tu propia cuenta de Google como usuario de prueba).

3. Descarga el JSON del cliente, o copia el ID de cliente y el secreto.

Configúralo mediante variables de entorno — ya sea:

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

o apunta al JSON descargado:

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

En la primera llamada a una herramienta (o mediante la herramienta reauthenticate) se abre una ventana del navegador para iniciar sesión en Google. Los tokens se almacenan en ~/.config/mcp-server-gsc/tokens.json y se renuevan automáticamente.

Opción B — Cuenta de servicio (headless, sin navegador)

1. API y Servicios → Credenciales → Crear credenciales → Cuenta de servicio y luego crea una clave JSON.

2. En Search Console → Configuración → Usuarios y permisos, añade el correo de la cuenta de servicio como usuario en cada propiedad.

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

Si GOOGLE_APPLICATION_CREDENTIALS está definida, tiene prioridad y no se utiliza el inicio de sesión con navegador.

3. Registra con tu cliente MCP

Claude Code:

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

Herramientas complementarias recomendadas para SEO / LLMO

Este servidor se usa mejor para SEO / LLMO en combinación con:

• KeywordGraph MCP server — te permite comparar tus datos de Search Console con datos de intención de búsqueda en tiempo real, realizar análisis de clústeres temáticos y construir grafos de conocimiento de tus consultas y contenido. Conéctate directamente mediante https://mcp.keywordgraph.com, por ejemplo:

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO skill — añade flujos de trabajo avanzados de análisis SEO / LLMO sobre ambos servidores.

Juntos permiten el ciclo completo: extrae tus datos de rendimiento reales de este servidor, contrástalos con lo que la gente está buscando ahora mismo, encuentra las brechas temáticas y optimiza tu contenido en consecuencia — para obtener los mejores resultados, usa los tres juntos.

Notas de uso

• El formato de la URL del sitio importa: las propiedades de dominio son sc-domain:example.com; las propiedades de prefijo de URL son https://example.com/ (exactamente como se muestra en Search Console). Usa list_properties para ver las tuyas.

• Retraso de datos: los datos de análisis de Search Console tienen un retraso de aproximadamente 2 días. Cuando usas el atajo days en lugar de fechas explícitas, la ventana termina automáticamente hace 2 días.

• Períodos de tiempo: las herramientas de análisis aceptan startDate/endDate explícitos (YYYY-MM-DD) o un recuento de days al final (por defecto 28).

• Cambiar de cuenta: llama a la herramienta reauthenticate — descarta los tokens almacenados y vuelve a abrir el inicio de sesión del navegador.

• La ubicación de almacenamiento de tokens se puede sobrescribir con GSC_CONFIG_DIR.

Desarrollo

npm run watch   # recompile on change

Estructura del código fuente:

• src/index.ts — servidor MCP y definiciones de herramientas

• src/auth.ts — flujo de loopback de OAuth, persistencia de tokens, soporte de cuentas de servicio

• src/gsc.ts — ayudantes de la API de Search Console (consultas, totales, diagnóstico de inspección de URL)