Servidor MCP de Google Search Console

Consulta datos de Google Search Console desde cualquier asistente de IA que admita el protocolo MCP: clasificaciones, clics, impresiones y rendimiento a nivel de página.

Requisitos previos

• Node.js 18+

• Una cuenta de Google con acceso a Google Search Console

Related MCP server: Google Search Console + GA4 MCP Server

Configuración

1. Instalar dependencias

npm install

2. Crear un proyecto de Google Cloud

1. Ve a Google Cloud Console

2. Crea un proyecto nuevo (o selecciona uno existente)

3. Habilita la API de Search Console:

   • Ve a APIs y servicios > Biblioteca

   • Busca "Search Console API"

   • Haz clic en Habilitar

3. Crear credenciales OAuth2

1. Ve a APIs y servicios > Credenciales

2. Haz clic en Crear credenciales > ID de cliente de OAuth

3. Tipo de aplicación: Aplicación de escritorio (o Aplicación web)

4. Ponle el nombre que quieras

5. Copia el ID de cliente y el Secreto de cliente

4. Configurar tu archivo .env

cp .env.example .env

Completa los valores:

5. Ejecutar el servidor

npm start

En la primera ejecución, se abrirá automáticamente una ventana del navegador para completar la autenticación OAuth. Después de eso, los tokens se almacenan localmente en .tokens.json y no se te volverá a solicitar.

Conexión con tu asistente de IA

Este servidor se comunica a través de stdio (entrada/salida estándar), que es la forma estándar de conectar servidores MCP a asistentes de IA. Configura tu asistente de IA para usar:

node /path/to/src/index.js

Reemplaza /path/to con la ruta real a este proyecto en tu máquina.

Herramientas disponibles

getTopQueries

Devuelve tus consultas de búsqueda principales clasificadas por clics.

• Parámetros: startDate (AAAA-MM-DD), endDate (AAAA-MM-DD), rowLimit (opcional, predeterminado 10)

• Devuelve: consulta, clics, impresiones, CTR, posición para cada fila

getSiteSummary

Devuelve los totales generales de rendimiento de búsqueda del sitio.

• Parámetros: startDate (AAAA-MM-DD), endDate (AAAA-MM-DD)

• Devuelve: total de clics, impresiones, CTR, posición media

getPagePerformance

Devuelve datos de rendimiento filtrados para una página específica.

• Parámetros: pageUrl (URL exacta como se muestra en GSC), startDate (AAAA-MM-DD), endDate (AAAA-MM-DD)

• Devuelve: clics, impresiones, CTR, posición para esa página

getRankingChanges

Encuentra páginas con los mayores cambios de posición entre dos períodos.

• Parámetros: days (número de días a comparar, predeterminado 28)

• Devuelve: URL de la página, cambio de posición, posición actual, posición anterior

Importante

Nunca subas .env o .tokens.json al control de versiones. Estos archivos ya están excluidos mediante .gitignore.