Skip to main content
Glama
deenesjakoruzh
GiorgiKemo

mcp-seo-audit

by GiorgiKemo
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-seo-audit

Un servidor del Protocolo de Contexto de Modelo (MCP) para auditoría SEO con Google Search Console, Indexing API, Chrome UX Report, PageSpeed Insights, Lighthouse local, comprobaciones de robots.txt, análisis de sitemaps, inspección SEO on-page, auditorías de rastreo y análisis de sitios en vivo. Funciona con Claude Code, Claude Desktop, Cursor y cualquier cliente compatible con MCP.

Derivado de AminForou/mcp-gsc y ampliado a un servidor de auditoría técnica SEO y de rendimiento más completo con 30 herramientas y una suite de pruebas completa.

Qué hace

Categoría

Herramientas

Descripción

Gestión de propiedades

list_properties, add_site, delete_site

Listar, añadir y eliminar propiedades de GSC

Analítica de búsqueda

get_search_analytics, get_advanced_search_analytics, get_performance_overview, get_search_by_page_query, compare_search_periods

Consultar clics, impresiones, CTR, posición con filtrado, dimensiones y comparación de periodos

Inspección de URL

inspect_url, batch_inspect_urls

Comprobar estado de indexación, información de rastreo, canonical, robots para una o varias URL

Indexing API

request_indexing, request_removal, check_indexing_notification, batch_request_indexing

Enviar/eliminar URL del índice de Google mediante la Indexing API

Sitemaps

get_sitemaps, submit_sitemap, delete_sitemap

Listar, enviar y eliminar sitemaps

Core Web Vitals

get_core_web_vitals

LCP, FID, CLS, INP, TTFB mediante la API de Chrome UX Report (CrUX)

Auditorías de rendimiento

get_pagespeed_insights, run_lighthouse_audit

Ejecutar PageSpeed Insights y auditorías de Lighthouse local con puntuaciones de categoría y resúmenes de auditorías fallidas

SEO técnico

inspect_robots_txt, analyze_sitemap, analyze_page_seo, crawl_site_seo, audit_live_site

Inspeccionar robots.txt, validar sitemaps, extraer señales SEO on-page, rastrear páginas internas y ejecutar una auditoría SEO en vivo sin acceso a GSC

Análisis SEO

find_striking_distance_keywords, detect_cannibalization, split_branded_queries

Encontrar palabras clave en posiciones 5-20, detectar páginas que compiten por la misma consulta, separar tráfico de marca vs. sin marca

Auditoría de sitio

site_audit

Informe todo en uno: salud del sitemap, estado de indexación, discrepancias de canonical, resumen de rendimiento

Autenticación

reauthenticate

Cambiar de cuenta de Google borrando los tokens OAuth en caché

30 herramientas en total.

Configuración

1. Credenciales de Google API

OAuth (recomendado)

  1. Ve a Google Cloud Console

  2. Habilita la Search Console API y la Web Search Indexing API

  3. Crea un ID de cliente OAuth 2.0 (aplicación de escritorio)

  4. Descarga client_secrets.json

Cuenta de servicio

  1. Crea una cuenta de servicio en Google Cloud Console

  2. Descarga el archivo de clave JSON

  3. Añade el correo electrónico de la cuenta de servicio a tus propiedades de GSC

2. Instalación

git clone https://github.com/GiorgiKemo/mcp-seo-audit.git
cd mcp-seo-audit
python -m venv .venv

# Activate:
# macOS/Linux: source .venv/bin/activate
# Windows:     .venv\Scripts\activate

pip install -r requirements.txt

3. Configura tu cliente MCP

Claude Code (~/.claude/settings.json)

{
  "mcpServers": {
    "seo-audit": {
      "command": "/path/to/mcp-seo-audit/.venv/bin/python",
      "args": ["/path/to/mcp-seo-audit/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
        "PAGESPEED_API_KEY": "your-google-api-key",
        "CRUX_API_KEY": "your-google-api-key"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

Estructura JSON idéntica: consulta la documentación de MCP de Claude Desktop para conocer la ubicación del archivo de configuración.

4. Opcional: Claves de API de rendimiento

Para datos de rendimiento de campo y laboratorio, configura CRUX_API_KEY y PAGESPEED_API_KEY en el bloque env:

"env": {
  "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
  "CRUX_API_KEY": "your-google-api-key",
  "PAGESPEED_API_KEY": "your-google-api-key"
}

También puedes configurar GOOGLE_API_KEY; el servidor la utiliza como clave de respaldo para PageSpeed Insights.

Variables de entorno

Variable

Requerida

Predeterminado

Descripción

GSC_OAUTH_CLIENT_SECRETS_FILE

OAuth

client_secrets.json

Ruta a los secretos del cliente OAuth

GSC_CREDENTIALS_PATH

Cuenta de servicio

service_account_credentials.json

Ruta a la clave de la cuenta de servicio

GSC_SKIP_OAUTH

No

false

Establecer en true para omitir OAuth y usar solo la cuenta de servicio

GSC_DATA_STATE

No

all

all = datos frescos que coinciden con el panel de GSC, final = datos confirmados (retraso de 2-3 días)

CRUX_API_KEY

No

ninguno

Clave de API de Google para Core Web Vitals (CrUX)

PAGESPEED_API_KEY

No

ninguno

Clave de API de Google para llamadas a PageSpeed Insights / Lighthouse API

GOOGLE_API_KEY

No

ninguno

Fuente de respaldo para PAGESPEED_API_KEY

LIGHTHOUSE_CHROME_PATH

No

auto-detect

Ruta explícita opcional a Chrome/Chromium para la CLI de Lighthouse local

Ejemplos de prompts

"List my GSC properties"
"Show search analytics for cdljobscenter.com last 28 days"
"Find striking distance keywords for my site"
"Detect keyword cannibalization"
"Run a full site audit"
"Check Core Web Vitals for cdljobscenter.com"
"Run PageSpeed Insights for https://example.com"
"Run a local Lighthouse audit for https://example.com"
"Inspect robots.txt for https://example.com"
"Analyze https://example.com/sitemap.xml"
"Analyze on-page SEO for https://example.com/jobs"
"Crawl https://example.com and report duplicate titles"
"Run a live SEO audit for https://example.com"
"Inspect indexing status of these URLs: /jobs, /companies, /pricing"
"Request indexing for https://mysite.com/new-page"
"Compare search performance this month vs last month"

Pruebas

81 pruebas que cubren las 30 herramientas con llamadas simuladas a Google/API/auditoría web:

# Activate venv first
python -m pytest test_gsc_server.py -v

Qué ha cambiado respecto al original

  • 30 herramientas — se añadieron PSI, Lighthouse local, inspección de robots.txt, validación de sitemaps, análisis SEO de página, auditorías de rastreo y auditorías de sitio en vivo

  • 7 correcciones de errores — mapeo de dirección de ordenamiento, detección de origen/URL, bloqueo por filas vacías, fuga de clave API, bloqueo de sleep, caché de servicio, caché obsoleta al reautenticar

  • Suite de QA de 81 pruebas — cobertura para GSC, CrUX, PSI, CLI de Lighthouse, robots, sitemaps, auditorías de rastreo y composición de auditoría en vivo

  • Seguridad — claves API redactadas de los mensajes de error

  • Rendimiento — objetos de servicio de Google API cacheados, sleep asíncrono en lugar de bloqueante, además de herramientas de rendimiento de laboratorio sobre los datos de campo de CrUX

Licencia

MIT. Ver LICENSE.

Basado en AminForou/mcp-gsc.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

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/GiorgiKemo/mcp-seo-audit'

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