Servidor MCP de Google Search Console para SEO

Una herramienta que conecta Google Search Console (GSC) con Claude AI, permitiéndote analizar tus datos SEO mediante conversaciones en lenguaje natural. Esta integración te da acceso a información de propiedades, análisis de búsqueda, inspección de URL y gestión de mapas del sitio, todo a través de un simple chat con Claude.

¿Qué puede hacer esta herramienta por los profesionales de SEO?

1. Administración de propiedades
   • Vea todas sus propiedades de GSC en un solo lugar
   • Obtenga detalles de verificación e información básica del sitio
   • Añade nuevas propiedades a tu cuenta
   • Eliminar propiedades de tu cuenta
2. Análisis de búsqueda e informes
   • Descubra qué consultas de búsqueda llevan visitantes a su sitio
   • Realizar un seguimiento de impresiones, clics y tasas de clics
   • Analizar las tendencias de rendimiento a lo largo del tiempo
   • Comparar diferentes períodos de tiempo para detectar cambios
   • Visualice sus datos con gráficos y tablas creados por Claude
3. Inspección e indexación de URL
   • Comprobar si páginas específicas tienen problemas de indexación
   • Vea cuándo fue la última vez que Google rastreó sus páginas
   • Inspeccione varias URL a la vez para identificar patrones
   • Obtenga información práctica sobre cómo mejorar la indexación
4. Gestión de mapas del sitio
   • Ver todos sus mapas de sitio y su estado
   • Envíe nuevos mapas de sitios directamente a través de Claude
   • Comprueba si hay errores o advertencias en tus mapas de sitio
   • Supervisar el estado de procesamiento del mapa del sitio

Herramientas disponibles

Esto es lo que puedes pedirle a Claude que haga una vez que hayas configurado esta integración:

Para obtener una lista completa de las 19 herramientas disponibles y sus descripciones detalladas, pídale a Claude que "enumere las herramientas" después de la configuración.

Primeros pasos (¡No se requiere experiencia en codificación!)

1. Configurar el acceso a la API de Google Search Console

Antes de usar esta herramienta, deberá crear credenciales de API que le permitan a Claude acceder a sus datos de GSC:

Opciones de autenticación

La herramienta admite dos métodos de autenticación:

1. Autenticación OAuth (recomendada)

Este método te permite autenticarte con tu propia cuenta de Google, lo cual suele ser más cómodo que usar una cuenta de servicio. Tendrás acceso a los mismos recursos que tú normalmente.

Establezca GSC_SKIP_OAUTH en "verdadero", "1" o "sí" para omitir la autenticación OAuth y usar solo la autenticación de cuenta de servicio

Instrucciones de configuración:

1. Vaya a la consola de Google Cloud y cree una cuenta de Google Cloud si no tiene una
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilite la API de Search Console para su proyecto
4. Añade el ámbito https://www.googleapis.com/auth/webmasters a tu proyecto
5. Vaya a la página "Credenciales"
6. Haga clic en "Crear credenciales" y seleccione "ID de cliente OAuth".
7. Configurar la pantalla de consentimiento de OAuth
8. Para el tipo de aplicación, seleccione "Aplicación de escritorio".
9. Dale un nombre a tu cliente OAuth y haz clic en "Crear".
10. Descargue el archivo JSON de secretos del cliente (se llamará algo así como client_secrets.json )
11. Coloque este archivo en el mismo directorio que el script o configure la variable de entorno GSC_OAUTH_CLIENT_SECRETS_FILE para que apunte a su ubicación

Al ejecutar la herramienta por primera vez con autenticación OAuth, se abrirá una ventana del navegador que le solicitará que inicie sesión en su cuenta de Google y autorice la aplicación. Tras la autorización, la herramienta guardará el token para su uso posterior.

2. Autenticación de la cuenta de servicio

Este método utiliza una cuenta de servicio, lo cual es útil para scripts automatizados o cuando no desea usar su cuenta personal de Google. Para ello, debe agregar la cuenta de servicio como usuario en Google Search Console.

Instrucciones de configuración:

1. Vaya a la consola de Google Cloud y cree una cuenta de Google Cloud si no tiene una
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilite la API de Search Console para su proyecto
4. Vaya a la página "Credenciales"
5. Haga clic en "Crear credenciales" y seleccione "Cuenta de servicio".
6. Complete los detalles de la cuenta de servicio y haga clic en "Crear"
7. Haga clic en la cuenta de servicio recién creada
8. Vaya a la pestaña "Claves" y haga clic en "Agregar clave" > "Crear nueva clave".
9. Seleccione el formato JSON y haga clic en "Crear"
10. Descargue el archivo de clave y guárdelo como service_account_credentials.json en el mismo directorio que el script o configure la variable de entorno GSC_CREDENTIALS_PATH para que apunte a su ubicación
11. Agregue la dirección de correo electrónico de su cuenta de servicio a las propiedades correspondientes de Search Console

🎬 Mira este tutorial para principiantes en Youtube:

Haga clic en la imagen de arriba para ver el video tutorial paso a paso.

2. Instalar el software necesario

Necesitarás instalar estas herramientas en tu computadora:

• Python (versión 3.11 o más reciente): esto ejecuta la conexión entre GSC y Claude
• Node.js : necesario para ejecutar el inspector MCP y ciertos componentes MCP
• Claude Desktop : el asistente de inteligencia artificial con el que chatearás

Asegúrese de que tanto Python como Node.js estén correctamente instalados y disponibles en la ruta de su sistema antes de continuar.

3. Descargue el MCP de Google Search Console

Necesitas descargar esta herramienta a tu computadora. La forma más fácil es:

1. Haga clic en el botón verde "Código" en la parte superior de esta página.
2. Seleccione "Descargar ZIP"
3. Descomprima el archivo descargado en una ubicación que pueda encontrar fácilmente (como su carpeta Documentos)

Alternativamente, si está familiarizado con Git:

4. Instalar los componentes necesarios

Abra la Terminal de su computadora (Mac) o el Símbolo del sistema (Windows):

1. Navega hasta la carpeta donde descomprimiste los archivos:
   # Example (replace with your actual path): cd ~/Documents/mcp-gsc-main
2. Cree un entorno virtual (esto mantiene aisladas las dependencias del proyecto):
   # Using uv (recommended): uv venv .venv # If uv is not installed, install it first: pip install uv # Then create the virtual environment: uv venv .venv # OR using standard Python: python -m venv .venv
   Nota: Si recibe un error "pip no encontrado" al intentar instalar uv, consulte la sección "Si recibe el error 'pip no encontrado'" a continuación.
3. Activar el entorno virtual:
   # On Mac/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate
4. Instale las dependencias necesarias:
   # Using uv: uv pip install -r requirements.txt # OR using standard pip: pip install -r requirements.txt
   Si recibe el error "pip no encontrado":
   # First ensure pip is installed and updated: python3 -m ensurepip --upgrade python3 -m pip install --upgrade pip # Then try installing the requirements again: python3 -m pip install -r requirements.txt # Or to install uv: python3 -m pip install uv

Cuando vea (.venv) al comienzo de su símbolo del sistema, significa que el entorno virtual está activo y las dependencias se instalarán allí sin afectar la instalación de Python de su sistema.

5. Conecta a Claude a Google Search Console

1. Descargue e instale Claude Desktop si aún no lo ha hecho
2. Asegúrate de tener el archivo de credenciales de tu cuenta de servicio de Google guardado en algún lugar de tu computadora
3. Abra la Terminal de su computadora (Mac) o el Símbolo del sistema (Windows) y escriba:

4. Agregue el siguiente texto de configuración (esto le dice a Claude cómo conectarse a GSC):

Autenticación OAuth (usando su propia cuenta)

Autenticación de cuenta de servicio

Importante: reemplace todas las rutas con las ubicaciones reales en su computadora:

• La primera ruta debe apuntar al ejecutable de Python dentro de su entorno virtual
• La segunda ruta debe apuntar al archivo gsc_server.py dentro de la carpeta que descomprimiste
• La tercera ruta debe apuntar al archivo JSON de credenciales de su cuenta de servicio de Google

Ejemplos:

• Impermeable:
  • Ruta de Python: /Users/yourname/Documents/mcp-gsc/.venv/bin/python
  • Ruta del script: /Users/yourname/Documents/mcp-gsc/gsc_server.py
• Ventanas:
  • Ruta de Python: C:\\Users\\yourname\\Documents\\mcp-gsc\\.venv\\Scripts\\python.exe
  • Ruta del script: C:\\Users\\yourname\\Documents\\mcp-gsc\\gsc_server.py

5. Guardar el archivo:
   • Mac: Presione Ctrl+O, luego Enter, luego Ctrl+X para salir
   • Windows: haga clic en Archivo > Guardar y luego cierre el Bloc de notas
6. Reiniciar Claude Desktop
7. Cuando Claude se abra, ahora debería ver las herramientas GSC disponibles en la sección de herramientas

6. ¡Comienza a analizar tus datos de SEO!

¡Ahora puedes hacerle preguntas a Claude sobre tus datos de GSC! Claude no solo puede recuperarlos, sino también analizarlos, explicar tendencias y crear visualizaciones para ayudarte a comprender mejor tu rendimiento SEO.

A continuación se muestran algunas sugerencias útiles que puedes usar con cada herramienta:

También puedes pedirle a Claude que combine varias herramientas y analice los resultados. Por ejemplo:

• Encuentra mis 20 páginas de destino principales por tráfico, verifica su estado de indexación y crea un informe que destaque las páginas con alto tráfico y problemas de indexación.
• Analice la tendencia de rendimiento de mi sitio durante los últimos 90 días, identifique las consultas de mayor crecimiento y verifique si las páginas de destino correspondientes presentan problemas técnicos.
• Compara el rendimiento de mi búsqueda en computadoras de escritorio y en dispositivos móviles, visualiza las diferencias con gráficos y recomienda páginas específicas que necesitan optimización móvil según las diferencias de rendimiento.
• Identificar las consultas en las que estoy posicionado en la página 2 (posiciones 11 a 20) que tienen muchas impresiones pero un CTR bajo. Luego, inspeccionar las URL correspondientes y sugerir mejoras en el título y la meta descripción.

Claude utilizará las herramientas de GSC para obtener los datos, presentarlos en un formato fácil de entender, crear visualizaciones cuando sea útil y proporcionar información práctica basada en los resultados.

Capacidades de visualización de datos

Claude puede ayudarte a visualizar tus datos GSC de varias maneras:

• Gráficos de tendencias : vea cómo cambian las métricas a lo largo del tiempo
• Gráficos de comparación : compare diferentes períodos de tiempo o dimensiones
• Distribuciones de rendimiento : comprenda cómo funciona su contenido en las distintas posiciones
• Análisis de correlación : identificar relaciones entre diferentes métricas
• Mapas de calor : visualice conjuntos de datos complejos con representaciones codificadas por colores

Simplemente pídale a Claude que "visualice" o "cree un gráfico" al analizar sus datos y generará visualizaciones apropiadas para ayudarlo a comprender mejor la información.

Solución de problemas

Comando de Python no encontrado

En macOS, el comando Python predeterminado suele ser python3 en lugar de python , lo que puede causar problemas con algunas aplicaciones, incluidas las integraciones con Node.js.

Si encuentra errores relacionados con que no se encuentra Python, puede crear un alias:

1. Crear un alias de Python (configuración única):
   # For macOS users: sudo ln -s $(which python3) /usr/local/bin/python # If that doesn't work, try finding your Python installation: sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python
2. Verifique que el alias funcione:
   python --version

Esto crea un enlace simbólico para que cuando las aplicaciones llamen python , en realidad utilicen su instalación python3 .

Problemas de configuración de Claude

Si tiene problemas para conectarse:

1. Asegúrese de que todas las rutas de archivos en su configuración sean correctas y utilice la ruta completa
2. Comprueba que tu cuenta de servicio tenga acceso a tus propiedades de GSC
3. Reinicie Claude Desktop después de realizar cualquier cambio
4. Busque mensajes de error en la respuesta de Claude cuando intente utilizar una herramienta
5. Asegúrese de que su entorno virtual esté activado al ejecutar el servidor manualmente

Otros problemas inesperados

Si encuentra algún otro problema inesperado durante la instalación o el uso:

1. Copia el mensaje de error exacto que estás recibiendo
2. Utilice ChatGPT o Claude y explique su problema en detalle, incluyendo:
   • Lo que estabas intentando hacer
   • El mensaje de error exacto
   • Su sistema operativo
   • ¿Algún paso que ya hayas probado?
3. Los asistentes de IA a menudo pueden ayudar a diagnosticar y resolver problemas técnicos al sugerir soluciones específicas para su situación.

Recuerde que la mayoría de los problemas ya los han experimentado otras personas anteriormente y que, generalmente, existe una solución sencilla disponible.

Contribuyendo

¿Encontraste un error o tienes alguna idea para mejorar? ¡Agradecemos tus comentarios! Abre un problema o envía una solicitud de extracción en GitHub.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.