Skip to main content
Glama
A1-x-Tech

Google Search Console MCP

MCP de Google Search Console

Español | Русский

npm CI Glama License: MIT

MCP de Google Search Console para A1 conecta una app 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 un sitemap cuando sea necesario.

Funciona con las propiedades a las que tu cuenta de Google pueda acceder. El detalle importante: usa el valor exacto de la propiedad de Search Console — una propiedad de dominio y una propiedad de prefijo de URL son objetos distintos.

  • 12 herramientas. Siete leen propiedades, datos de búsqueda, sitemaps y estado del índice; dos añaden una propiedad o envían un sitemap; tres pueden eliminar datos o llamar a un método arbitrario de la API.

  • IDs de propiedad exactos. https://example.com/, https://www.example.com/ y sc-domain:example.com son distintos. list_sites te 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.

  • Indexing, no publicación. La inspección de URL explica el estado actual de Google; no fuerza una página al índice.

Empieza con una pregunta de solo lectura:

Muéstrame las 20 consultas principales de mi propiedad en los últimos 28 días, con clics e impresiones.

Conecta el servidor · Explora casos de uso · Abre documentación técnica


Míralo funcionar en un minuto

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

Asistente: Inspecciona la URL y muestra el veredicto de indexación, información de cobertura, rastreo y URLs canónicas. Nada se puede cambiar.

Tú: Revisa mis sitemaps enviados y prepara la presentación para el que tenga errores.

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

Tú: Confirmado.

Asistente: Reenvía el sitemap seleccionado. No altera el contenido de la página ni garantiza el indexado.

Related MCP server: mcp-gsc

Contenido

Inicio rápido

Necesitas Node.js 20+, una cuenta de Google con acceso a una propiedad de Search Console y credenciales OAuth de Google Cloud.

  1. Prepara el acceso OAuth.

  2. Añade el servidor a tu app de IA.

  3. Empieza con la pregunta de solo lectura anterior.

En la app: abre Configuración → Plugins → Servidores MCP, elige Añadir servidor y añade npx -y mcp-google-search-console@latest con GOOGLE_SEARCH_CONSOLE_CLIENT_ID, GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET y GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN.

codex mcp add google-search-console \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-search-console@latest
codex mcp list

Documentación de Codex MCP

claude mcp add \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

Documentación de Claude Code MCP

Abre Configuración → Desarrollador → Editar configuración y añade:

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Si Editar configuración no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows.

Documentación MCP de Claude Desktop

Añade a ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows:

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Documentación MCP de Cursor

Ejecuta MCP: Abrir configuración de usuario y añade:

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"${input:gsc_client_id}","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"${input:gsc_client_secret}","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"${input:gsc_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gsc_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gsc_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gsc_refresh_token","description":"Google OAuth refresh token","password":true}]}

Compruébalo con MCP: Listar servidores. Documentación MCP de VS Code

Qué puedes pedirle que haga

Encuentra oportunidades de búsqueda

  • ¿Qué páginas y consultas generaron más impresiones este mes?

  • ¿Qué páginas perdieron clics comparado con el período anterior?

  • Muestra consultas que contengan palabraClave donde la frecuencia media esté por debajo de 7.

Comprueba el estado del índice y los sitemaps

  • ¿Esta URL está indexada? Muestra información de cobertura, rastreo y canónica.

  • ¿Qué sitemaps enviados tienen errores o advertencias? Suma (this) y medidas de seguridad antes de volver a enviarlo.

Gestiona las propiedades cuidadosamente

  • Enumera las propiedades de Search Console a las que puedo acceder.

  • Añade el valor exacto de la propiedad; lo comprobaré 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 el protocolo y la barra inclinada final, ej. https://example.com/. Una propiedad de dominio se escribe como sc-domain:example.com. Un valor casi igual provoca error 403 o 404, por lo que se debe usar el valor exacto devuelto por list_sites.

add_site solo registra una propiedad. La verificación queda 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 Estándar; end_date es inclusivo y los datos analíticos finales suelen tardar entre dos y tres días. data_state: "all" puede incluir filas más recientes que cambian.

Qué refiere.

The English "What can change" table with headers. Need translate Spanish.

Qué puede cambiar

Operación

Qué sucede

Límite de confirmación

Lista de propiedades, análisis, sitemaps y estado de URL

Lee datos de Search Console

Sin cambio

Añadir una propiedad

Añade un registro de propiedad; no la verifica

Cambia el acceso a la cuenta

Enviar o reenviar un sitemap

Solicita el procesamiento de un sitemap

Cambia el estado de Search Console

Eliminar una propiedad

Desvincula la propiedad de la cuenta; los datos de Google no se eliminan

Destructivo

Cuando (error, could not)

If you output a table: "the AI client controls yes/whatever: " | The server marks reads, writes and destructive calls...

Actually careful with table: "Añade una propiedad" text says "Property" but the table says "Add a property". Keep.

Let's translate the table rows:

| Operación | Qué sucede | Límite de confirmación | | Listar propiedades, análisis, sitemaps y estado de URL | Lee datos de Search Console | Sin cambio | | Añadir una propiedad | Añade una entrada de propiedad; no la verifica | Cambia el acceso a la cuenta | | Enviar o reenviar un sitemap | Solicita el procesamiento de un sitemap | Cambia el estado de Search Console | | Eliminar una propiedad | Desvincula la propiedad de la cuenta; los datos de Google no se eliminan | Destructivo | | Eliminar un sitemap | Elimina un sitemap enviado | Destructivo | | Llamada sin procesar a la API | Puede llamar a un endpoint de escritura o eliminación | Potencialmente destructivo |

El cliente IA controla los avisos. Marcar claro el server los reads, writes...

Actually the Spanish sentence "El servidor marca las lecturas, escrituras y llamadas destructivas..." Need translate.

Continuing with the section after table: "The client controls confirmation prompts. The server marks reads, writes, and destructive calls so the client can distinguish an inspection from a real change." Actually there's bullet "El cliente de IA controla los avisos de confirmación. El servidor marca lecturas, escrituras y llamadas destructivas para que..." Let's translate.

Then "## Obtaining through access."

Need maintain headings.

"## Obtención de acceso."

El acceso a los datos de Search Console requiere Google OAuth 2.0; no basta con una clave de API.

  1. Crea o selecciona un proyecto de Google Cloud y habilita la API de Google Search Console.

  2. Configura la pantalla de consentimiento de OAuth y crea un cliente OAuth de tipo Aplicación de escritorio.

  3. Usa el Jardín de juegos de OAuth 2.0 con 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.readonly para incluir sitemaps y cambios de propiedades. Usa https://www.googleapis.com/auth/webmasters.readonly solo si quieres acceso de solo lectura.

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

Configuración

Variable

¿Obligatoria?

Descripción

GOOGLE_SEARCH_CONSOLE_CLIENT_ID

*

Identificación del Cliente OAuth.

GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET

*

Secreto del Cliente OAuth.

GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN

*

Token de actualización OAuth.

GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN

*

Alternativa de corta duración al trío OAuth.

GOOGLE_SEARCH_CONSOLE_API_BASE

No

Anulación de la URL base de la API.

GOOGLE_SEARCH_CONSOLE_TIMEOUT_MS

No

Espera por solicitud; valor por defecto 60000ms.

GOOGLE_SEARCH_CONSOLE_MAX_RETRIES

No

Número de reintentos espera; 3 por defecto.

* Proporciona o trío de identificadores OAuth bien un token de acceso.

Datos, límites y trabajo en segundo plano de fondo*

Wait, there is a bullet "This ongoing part" Actually last bullet "## Datos" With * * ** private telemetry? Let's translate:

Datos, límites y trabajo en segundo plano

  • Privacidad. El servidor local llama a Google y envía telemetría anónima... etc.

Let's reconstruct the entire final section:

Datos, límites y trabajo en segundo plano

  • Privacidad. El servidor local llama a Google y envía telemetría anónima con ID de instalación, versiones y nombres de herramientas, nunca tokens OAuth, datos de propiedades, argumentos o prompts. Establece ASKADS_TELEMETRY=0 para desactivarlo.

  • Límites de la API. La inspección de URL permite 2.000 inspecciones por propiedad y día, y 600 por minuto. Analytics devuelve como máximo 25.000 filas por solicitud; las colas de consultas anónimas de cola larga nunca se devuelven. Usa paginación y no inspecciones sitios enteros URL a URL.

  • Sin visibilidad en segundo plano. El servidor solo funciona mientras se le llama. Si tu app de IA permite tareas programadas, puede comprobar periódicamente un sitemap o de la página importante.

Documentación técnica

Soporte

¿Encontraste un bug o necesitas un escenario? Abre un problema o escribe en Telegram.

Need to ensure original URLs preserved exactly, but link text translated. In the original, links are like English, but I changed? The second bullet "Quick start" should translate to "Inicio rápido". The URL to README.ru.md remains. Correct.

Need to preserve exact link targets, only text changes.

We need to provide the final Spanish output only, no wrapper.

Let's refine the output. We'll produce a full Spanish translation with markdown preserved, and the tricky parts. Need to be accurate and not omit content.

We need ensure the table rows are correctly translated. The paragraph "If you want...". Let's parse.

Important: The target link for "English" original is English Wait, original: [English](./README.ru.md) maybe. Actually original: **English** | [Русский](./README.ru) We need to translate the language name for Spanish: **Español** | [Русский](./README.ru)? But the target is Spanish, so we alter "English" to "Español" and keep "Русский". Useful.

However "README.ru" is English? It's a filename. So it stays.

Also table with "Configuración" fields.

Need to translate "## What can change" table.

Need to treat GXP1-GXP5 tokens verbatim.

Need to translate "See what it can do" etc.

Let's formulate final:

"# MCP de Google Search Console

Español | Русский

npm CI Glama License: MIT

El MCP de Google Search Console para A1 conecta una app 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 uno cuando lo necesites.

Funciona con las propiedades a las que tu cuenta de Google puede acceder. El hecho clave: usa el valor exacto de la propiedad de Search Console importante, ya que una propiedad de dominio y una propiedad de prefijo de URL son objetos distintos.

  • 12 herramientas: Siete leen propiedades, datos de búsqueda, sitemaps y estado del índice; dos añaden una propiedad o envían un sitemap; tres pueden eliminar datos o llamar a un método arbitrario de la API.

  • IDs exactos de propiedades. https://example.com/, https://www.example.com/ y sc-domain:example.com son distinctas. 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. El análisis de URL explica el estado actual de Google bytecode estable; no fuerza una página al índice.

Empieza con una pregunta de solo lectura:

Muéstrame las 20 publicaciones principales de mi propiedad en los últimos 28 días, con clics e impresiones.

Conectar el servidor a una ventaja · Explora casos de uso · Abre la documentación técnica


Míralo funcionar en un minuto

Tú: ¿Está indexada la URL https://example.com/precios? ¿Y por qué?

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

Tú: Compruena mis sitemaps enviados y produce un reenvío para el que tiene errores.

Asistente: Muestra el sitemap, sus avisos y errores, luego pide confirmación antes de reenviarlo.

Tú: Confirmo.

Asistente: He enviado el sitemap editado. No cambia el contenido de la página ni aporta cobertura.

Contenidos

Inicio rápido

Necesitas el runtime y, además, una cuenta de Google con acceso a una propiedad de la Search Console y credenciales OAuth de Google Cloud.

  1. Prepara a tus clientes (Credenciales).

  2. Ejecuta tu proyecto con los servidores MCP de tu aplicación.

  3. Empieza con una pregunta segura o de solo lectura.

En la aplicación: abre Configuración → Extensions → MCP servers, pulsa Añadir servidor y añade npx -y mcp-google-search-console@latest con GOOGLE_SEARCH_CONSOLE_CLIENT_ID, GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET y GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN.

codex mcp add google-search-console \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-search-console@latest
codex mcp list

Documentación de MCP para Codex

claude mcp add \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

Documentación de MCP para Claude Code

Abre Configuración → Desarrollador → Editar config y añade:

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Si Editar config no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS, y %APPDATA%\Claude\claude_desktop_config.json en Windows.

Documentación de MCP para Claude Desktop

Añade a ~/.cursor/mcp.json en macOS/Linux, o %USERPROFILE%\.cursor\mcp.json en Windows:

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Documentación de MCP para Cursor

Ejecuta MCP: Abrir configuración de usuario y añade:

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"${input:gsc_client_id}","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"${input:gsc_client_secret}","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"${input:gsc_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gsc_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gsc_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gsc_refresh_token","description":"Google OAuth refresh token","password":true}]}

Compruébalo con MCP: Listar servidores. Documentación de MCP en VS Code

Qué puedes pedirle que haga

Encontrar oportunidades de búsqueda

  • ¿Qué páginas y consultas generaron más impresiones este mes?

  • ¿Qué páginas perdieron clics en comparación con el período periodístico anterior?

  • Muestra consultas que contengan palabra clave en las que la posición promedio sea menor a 7.

Comprobar el estado del índice y sitemaps

  • ¿Está esta URL indexada? Muestra la cobertura, el rastreo y la información canónica.

  • ¿Qué sitemaps enviados tienen errores o advertencias?

  • Vuelve a enviar este sitemap después de mostrar su estado actual.

Gestiona las propiedades cuidadosamente

  • Enumera las propiedades de Search Console a las que puedo acceder.

  • Añade este valor de propiedad exacto; Lo verificaré por separado.

  • Elimina esta propiedad de mi cuenta después de confirmar.

Cómo funcionan las propiedades de Search Console

Una propiedad de prefijo de URL incluye el protocolo y la barra inclinada final, por ejemplo https://example.com/. Una propiedad de dominio se escribe como sc-domain:example.com. Una circunstancia casi coincidente por 403 o 404, 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 final suelen tardar entre dos y tres días. data_state: "all" puede incluir filas con cambios aún más recientes.

Qué puede cambiar

Operación

Qué sucede

Límite de confirmación

Listar propiedades, análisis, sitemaps y estado de URLs

Los datos se aparecen de

Sin cambios

Añadir una propiedad

Añade una entrada de propiedad; no verifica la propiedad

Cambia el acceso a la cuenta

Enviar o reenviar un sitemap

Solicita el tratamiento de un sitemap

Cambia el ámbito de la búsqueda

Eliminar una propiedad

Desvincula la propiedad de la cuenta; los datos de Google no se eliminan

Destructivo

Eliminar un sitemap

Elimina un sitemap enviado

Destructivo

Solicitud de API forma libre

Puede llamar a un endpoint de escritura o de borrado

Potencialmente destructivo

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.

Cómo obtener acceso

Para acceder a los datos de Search Console se requiere OAuth 2.0 de Google; no basta con una clave de API.

  1. Crea o elige un proyecto de Google Cloud y habilita la API de Google Search Console.

  2. Configura la pantalla de consentimiento de OAuth y crea un cliente OAuth de tipo Aplicación de escritorio.

  3. Utiliza el Parque infantil de OAuth 2.0 con tus propias credenciales de 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 propiedades. Usa https://www.googleapis.com/auth/webmasters.readonly solo si necesitas acceso de solo lectura.

Los tokens de actualización en modo de pruebas pueden caducar a los siete días. Publica la aplicación de OAuth, o usa una aplicación de Workspace interno, para acceso de larga duración. Trata el secreto de cliente y el token de actualización como contraseñas.

Configuración

Variable

Obligatoria

Descripción

GOOGLE_SEARCH_CONSOLE_CLIENT_ID

*

ID del cliente OAuth.

GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET

*

Secreto del cliente OAuth.

GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN

*

Testigo de actualización de OAuth.

GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN

*

Alternativa de corta duración al trío OAuth.

GOOGLE_SEARCH_CONSOLE_API_BASE

No

Anulación de la URL base de la API.

GOOGLE_SEARCH_CONSOLE_TIMEOUT_MS

No

Tiempo de espera por solicitud; por defecto 60000ms.

GOOGLE_SEARCH_CONSOLE_MAX_RETRIES

No

Aviso de errores temporales; por defecto 3.

* Proporciona el trío de OAuth o un token per se.

Privacidad. El servidor local llama a Google y h hdata de telemetría en los clientes con ID de instalación, números de versión y Nombres de herramientas — nunca envía tokens de OAuth, datos de contenido, argumentos de herramientas o contenidos del cliente. Usa ASKADS_TELEMETRY=0 para no participarlo.

Límites de API. URL Inspection permite 2,000 inspecciones por propiedad por día y la 600 por minuto. Analytics website projects across the entire space. A request devuelve como máximo 25,000 filas; las consultas largas; Devuelve. Usa paginación y no lo inspecciona.

**Sin trabajo de fondo... El servidor solo se ejecuta cuando se usa. Si tu aplicación app soporta tareas programadas, puede revisar un sitemap o una URL importante.

Documentación técnica

Soporte

¿Encontraste un error o necesitas un escenario? Crea un problema o escríbenos en Telegram.

Need preserve link href exactly? There are original GitHub URLs. Need not translate hrefs. OK.

Now "Search" table etc. Need check final line [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) includes "./LICENSE" relative to repo? Keep.

The first heading # MCP de Google Search Console etc.

Need to check all headings.

Also the table row | GOOGLE_SEARCH_CONSOLE_CLIENT_ID` are backticks, okay.

The ## Acceso needs article.

Potential issue with "Owner data (false) is not deleted" etc.

Let's produce final translation.

Need to ensure the "Current" line: "Conecta un servidor MCP a tus propiedades" Good.

Also the "Read" row: "Lee los datos de Search Console". "Añade una propiedad" etc.

Everything must be translated. We must not translate code or URLs.

Let's deliver# MCP de Google Search Console

Español | Русский

npm CI Glama License: MIT

MCP de Google Search Console para A1 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 un sitemap cuando sea necesario.

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

  • 12 herramientas. Siete leen propiedades, datos de búsqueda, sitemaps y estado del índice; dos añaden una propiedad o envían un sitemap; tres pueden eliminar datos o llamar a un método arbitrario de la API.

  • IDs de propiedad exactos. https://example.com/, https://www.example.com/ y sc-domain:example.png son distintos. list_sites muestra el valor a usar.

  • Datos de búsqueda con contexto. Consulte 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 obliga a que una página esté en el índice.

Comienza con una pregunta de solo lectura:

Muéstrame las 20 consultas principales de mi propiedad en los últimos 28 días, con clics e impresiones.

Guía de inicio rápido · Explora los casos de uso · Abre la documentación técnica


Míralo Adivina en un minuto

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

Asistente: Inspecciona la URL y muestra el veredicto de indexación, información de cobertura, rastreo y URLs canónicas. No se puede cambiar 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 reenviarlo.

Tú: Confirmo.

Asistente: Reenvía el sitemap seleccionado. No altera el contenido ni lo registra en el índice.

  1. ¿Qué puedes pedirle?

  2. Wave Inicio rápido

  3. WAVE Los casos de uso

  4. Wave Propiedades de Search Console

  5. Wave Qué puede cambiar

  6. Wave Obtención de acceso

  7. Wave Configuración

  8. Wave Data, límites, trabajo de fondo

  9. Wave Documentación técnica

Guía de inicio rápidos

Necesitas Node.js 20+, una cuenta de Google con acceso a una propiedad de Search Console y credenciales de OAuth de Google Cloud.

  1. Prepara el acceso a OAuth.

  2. Añade el servidor en tu app AI.

  3. Comienza con la pregunta de solo lectura anterior.

OAuth

Search Console requiere OAuth 2.0; una clave de API no es suficiente.

Obtención de acceso

Para obtener acceso a los datos del Search Console necesitarás OAuth 2.0 de Google; no será suficiente con una clave API normal.

  1. Crea o abre un proyecto de Google Cloud y habilita Google Search Console API.

  2. Configura la pantalla de consentimiento de OAuth y un cliente OAuth Desktop app.

  3. Usa el OAuth 2.0 Playground con tus propias credenciales OAuth para autorizar e cuenta de Google que puede acceder a las propiedades y conseguir un refresh token.

  4. https://www.googleapis.com/auth/webmasters incluye sitemaps y cambios de propiedad. Usa https://www.googleapis.com/auth/webmasters.readonly si realmente quieres solo lectura.

Los tokens de actualización pueden expirar a los siete días. Publica la app OAuth para accesos duraderos, o usa un proyecto interno Workspace. Cambia el secreto del cliente como contraseña.

Configuración ️

Variable

¿Requerida?

Descripción

GOOGLE_SEARCH_CONSOLE_CLIENT_ID

*

ID de cliente OAuth.

GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET

*

Client secreto OAuth.

GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN

*

Token de actualización de OAuth.

GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN

*

Alternativa de corta duración a trio OAuth.

GOOGLE_SEARCH_CONSOLE_API_BASE

No

Parámetro de anulación sencillo (base API).

GOOGLE_SEARCH_CONSOLE_TIMEOUT_MS

No

Número de espera por solicitud; 60000s.

GOOGLE_SEARCH_CONSOLE_MAX_RETRIES

No

Reintentos errores temporales; 3 por defecto.

* O proporciona o bien la trío de tokens OAuth para tokens de usuario y acceso / refresh.

Los tokens de actualización en modo pruebas pueden caducar en siete días. Publica la aplicación OAuth, o usa una aplicación de Workspace interna, para acceso prolongado.

Variables y límites de fondo

  • Privacidad. El servidor local llama a Google y envía telemetría anónima — con ID de instalación, número de versión y nombre de las herramientas— nunca tokens, tokens, ni argumentos de herramientas. ASK_TELEMETRY=0 para no enviarla.

  • Límites API. Inspección de URL 2000 por propiedad y por día, 600 por minuto. Los informes devuelven como máximo 25 000 filas; las colas de consultas largas nunca devuelven. Usa paginación y no inspecciones la URL completa.

  • **Nada de trabajo en segundo plano...**El servidor solo corre cuando lo llamas. Si tu app admite tareas programadas, puede revisar un sitemap o una URL importante.

Documentación técnica

Soporte

¿Encontraste un problema o necesitas un escenario? Abre con un incidencia o escribe en Telegram.

A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
4dRelease cycle
3Releases (12mo)
Commit activity

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP Server that provides access to Google's Search Console API, allowing users to interact with website search performance data and manage search presence through natural language.
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server for Google Search Console, enabling querying search analytics, URL inspection, sitemap management, and more via natural language.
    267
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    This MCP server provides LLMs with programmatic access to Google Search Console data and functionality, including search analytics, sitemap management, site management, and URL inspection.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that exposes the Google Search Console API, allowing LLMs to query SEO data, inspect URLs, manage sitemaps, and analyze search performance via natural language.
    63
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP server for Google search results via SERP API

  • Serper MCP — wraps the Serper Google Search API (serper.dev)

  • SEO MCP server: crawl your site, find AI-visibility gaps, and ship the fix from your coding agent.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/A1-x-Tech/mcp-google-search-console'

If you have feedback or need assistance with the MCP directory API, please join our Discord server