/ Directorio / Playground / mcp-gsc
← Todos los servidores ↗ GitHub
● Comunidad AminForou ⚡ Instantáneo

mcp-gsc

por AminForou · AminForou/mcp-gsc

Extrae datos de Google Search Console en Claude — 20 herramientas para análisis de búsqueda, inspección de URLs, sitemaps. Ideal para triage SEO y reportes.

mcp-gsc (AminForou) conecta Google Search Console a asistentes IA. 20 herramientas cubren gestión de propiedades, análisis de búsqueda con filtrado/comparación, inspección de URLs (estado de indexación), y envío/monitoreo de sitemaps. Autenticación vía OAuth (personal) o cuenta de servicio (equipo).

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

gsc.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gsc",
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "gsc": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-gsc"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add gsc -- uvx mcp-gsc

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mcp-gsc

Genera un reporte SEO semanal con mcp-gsc

👤 Gestores SEO, equipos de contenido ⏱ ~15 min beginner

Cuándo usarlo: Lunes por la mañana — quieres un resumen del desempeño de la semana pasada antes de la reunión.

Requisitos previos
  • Acceso a GSC de la propiedad — search.google.com/search-console
  • Credenciales OAuth o cuenta de servicio — console.cloud.google.com — habilita Search Console API
Flujo
  1. Extrae las consultas principales + deltas
    Para acme.com, las 20 consultas principales de la semana pasada vs la semana anterior. Muestra clics, CTR, deltas de posición.✓ Copiado
    → Tabla de deltas
  2. Extrae los cambios en las páginas de destino principales
    Las 10 páginas con los mayores cambios en clics (arriba o abajo).✓ Copiado
    → Lista de ganadores + perdedores
  3. Redacta el resumen
    Escribe un resumen de 5 puntos para la reunión del equipo, con un elemento de acción para el mayor perdedor.✓ Copiado
    → Reporte listo para pegar

Resultado: Reporte del lunes en 10 minutos.

Combinar con: google-sheets

Audita problemas de indexación en tu sitio

👤 SEOs técnicos ⏱ ~30 min intermediate

Cuándo usarlo: El tráfico cayó y quieres saber si Google aún indexa lo que debería.

Flujo
  1. Selecciona páginas principales
    De las 50 páginas de destino principales del mes pasado, inspecciona el estado de indexación de cada URL vía inspect_url_enhanced.✓ Copiado
    → Estado por URL: indexado/rastreado-no-indexado/excluido
  2. Agrupa problemas
    Agrupa por tipo de problema. Para 'rastreado pero no indexado', ¿cuál es el patrón común?✓ Copiado
    → Diagnóstico por clúster

Resultado: Lista de correcciones priorizadas vinculada a veredictos reales de GSC.

Verifica la salud del sitemap y el estado del envío

👤 Cualquiera que lance nuevas páginas ⏱ ~10 min beginner

Cuándo usarlo: Acabas de lanzar nuevas páginas — verifica que Google recogió el sitemap.

Flujo
  1. Lista sitemaps
    get_sitemaps para acme.com. Muestra las fechas de última lectura y conteos de errores.✓ Copiado
    → Lista de salud del sitemap
  2. Reenvía los antiguos
    Para sitemaps no leídos en 7 días, reenvía.✓ Copiado
    → Enviado

Resultado: Confianza de que Google ve el nuevo contenido.

Extrae GSC para oportunidades de ranking

👤 SEOs en etapa de crecimiento ⏱ ~40 min intermediate

Cuándo usarlo: Quieres consultas donde rankeas 11-20 y estás cerca de la página 1.

Flujo
  1. Encuentra consultas casi ganadas
    Consultas de los últimos 90 días con posición promedio entre 11 y 20 Y >100 impresiones. Devuelve con la página de destino.✓ Copiado
    → Lista de objetivos
  2. Prioriza por esfuerzo
    Para los 20 principales, verifica la página de destino — ¿ya está optimizada para la consulta? Si no, sugiere cambios en la página.✓ Copiado
    → Lista de oportunidades ponderada por esfuerzo

Resultado: Un backlog SEO priorizado basado en tus datos reales de GSC.

Combinar con: firecrawl

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

gsc + google-sheets

Reporte SEO semanal automatizado insertado en una hoja compartida

Cada lunes, ejecuta mi reporte SEO semanal y añade a la hoja 'SEO Weekly'.✓ Copiado
gsc + firecrawl

Raspa páginas de competidores que rankean para tus consultas objetivo

Para cada consulta casi ganada en GSC, encuentra las páginas SERP principales (vía firecrawl), y resume por qué me superan en ranking.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
list_properties Descubre a qué tienes acceso 1 llamada API
get_search_analytics site, start_date, end_date, dimensions[], filters?, row_limit? La consulta más versátil 1 llamada API
inspect_url_enhanced site, url Debug de indexación por URL 1 llamada API
get_sitemaps site Salud del sitemap 1 llamada API
submit_sitemap site, feedpath Reenvía para que se rastree de nuevo 1 llamada API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
GSC API: 1200 QPM por proyecto, 6000 QPD por sitio
Tokens por llamada
Resultados de análisis hasta 25k filas por llamada — divide antes de descargar
Monetario
Gratuito
Consejo
Usa row_limit y filtros; descargar las 10k consultas principales arruina el contexto para agentes

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: https://www.googleapis.com/auth/webmasters.readonly
Almacenamiento de credenciales: GSC_OAUTH_CLIENT_SECRETS_FILE o GSC_CREDENTIALS_PATH en env
Salida de datos: searchconsole.googleapis.com
No conceder nunca: webmasters (acceso completo)

Resolución de problemas

Errores comunes y soluciones

403 El usuario no tiene permiso

La cuenta OAuth o cuenta de servicio debe ser usuario verificado en GSC para esa propiedad. Añade bajo Configuración → Usuarios

Respuesta de análisis vacía

GSC tiene un retraso de datos de 2-3 días; end_date > hoy - 3 puede estar vacío. También: los tipos de búsqueda 'Web' vs 'Discover' difieren

El flujo OAuth se repite

El URI de redirección en client_secrets.json debe coincidir exactamente (incluido el puerto http://localhost)

Alternativas

mcp-gsc vs otros

AlternativaCuándo usarlaContrapartida
GSC web UITrabajo manual ad hocSin automatización, sin ciclo de reporting
Ahrefs/SEMrush APIsQuieres seguimiento de ranking de terceros, no los datos propios de GoogleDe pago; conjunto de datos diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills