SEO Webmaster MCP

Audita una web desde tu asistente con solo pegar su URL. Este MCP local y de solo lectura detecta problemas técnicos y propone acciones con evidencia y pasos de verificación. Puedes conectar Google Search Console y Bing Webmaster Tools para añadir datos oficiales. Requiere Node.js 22 o posterior.

Pega una URL → encuentra problemas concretos → corrígelos → repite la auditoría para verificar el cambio.

Guía paso a paso, con un caso real de CTR bajo: Cómo auditar el SEO de tu web con tu asistente de IA y Search Console.

Inicio rápido

No necesitas clonar ni compilar el repositorio, ni configurar credenciales para tu primera auditoría. Conecta tu cliente MCP:

npx -y seo-webmaster-mcp inicia el servidor por stdio. Ejecuta npx -y seo-webmaster-mcp config codex|claude|cursor para copiar la configuración correspondiente; no incluyas claves en ella.

Codex:

codex mcp add seo-webmaster -- npx -y seo-webmaster-mcp
codex mcp list

Claude Desktop: agrega lo siguiente a claude_desktop_config.json y reinicia la aplicación. Cursor: agrega el mismo objeto a tu mcp.json.

{
  "mcpServers": {
    "seo-webmaster": {
      "command": "npx",
      "args": ["-y", "seo-webmaster-mcp"]
    }
  }
}

Consulta la configuración MCP de Codex, la ayuda de Claude Desktop o la documentación MCP de Cursor si tu cliente requiere una ruta distinta. En Windows, si el cliente no encuentra npx, usa la ruta absoluta del ejecutable npx.cmd.

Tu primera auditoría

Pide a tu asistente:

Audita https://example.com con seo_audit_advanced. Prioriza los problemas detectados y muestra las URL afectadas, la evidencia, cómo corregirlos y cómo comprobar cada corrección. Distingue los problemas confirmados de las comprobaciones que requieren contexto.

La llamada mínima es:

{ "baseUrl": "https://example.com/" }

El informe puede detectar errores HTTP, enlaces internos rotos, títulos ausentes o repetidos, canónicas mal formadas y directivas de indexación. También propone revisar imágenes sin alt, idioma de la página y viewport. Analiza el HTML recibido sin ejecutar JavaScript y no confirma la indexación real. Los apartados de datos oficiales quedan vacíos hasta que indiques una propiedad de Google o Bing.

summary indica cuántas páginas HTML se analizaron, qué se comprobó, qué quedó pendiente y si el rastreo se limitó. actions: [] significa que no se detectaron problemas en esas comprobaciones y esa muestra; no equivale a una auditoría exhaustiva ni garantiza que no haya nada que mejorar.

summary.truncationReasons explica los límites alcanzados: max_pages (URL pendientes), discovery_limit (hasta 2 × maxPages URL distintas descubiertas) o sitemap_limit (hasta seis archivos de sitemap). Los enlaces repetidos y fragmentos como #seccion no consumen páginas adicionales. Las canónicas y enlaces relativos se resuelven usando el primer <base href> cuando existe.

Cada página incluye jsonLdBlocks, con los bloques application/ld+json numerados desde 1. parsed indica JSON legible con raíz de objeto o array de objetos; invalid_json identifica JSON mal formado o vacío, y invalid_root una raíz incompatible. Los errores generan la acción invalid_json_ld con URL, bloque y pasos de corrección. Esta comprobación no resuelve contextos remotos ni valida la semántica de schema.org o los requisitos de resultados enriquecidos; completa esa revisión con Rich Results Test. Los indicadores indexablePages y snippetEligiblePages son señales del HTML observado, no confirmación de indexación o elegibilidad real.

Para una comprobació

... View full README on GitHub