seo-audit-skill MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

108 reglas de auditoría en 12 categorías
Core Web Vitals mediante integración con Lighthouse
Validación de datos estructurados (JSON-LD)
Verificación de encabezados de seguridad (CSP, HSTS, X-Frame-Options)
Conceptos básicos de accesibilidad (texto alternativo, ARIA, orden de encabezados)
Salida como markdown o JSON para herramientas posteriores

Demo en vivo

Cómo se ve en la práctica

seo-audit-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "seo-audit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/seo-skills/seo-audit-skill",
        "~/.claude/skills/seo-audit-skill"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "seo-audit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/seo-skills/seo-audit-skill",
        "~/.claude/skills/seo-audit-skill"
      ],
      "_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": {
    "seo-audit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/seo-skills/seo-audit-skill",
        "~/.claude/skills/seo-audit-skill"
      ],
      "_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": {
    "seo-audit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/seo-skills/seo-audit-skill",
        "~/.claude/skills/seo-audit-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "seo-audit-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/seo-skills/seo-audit-skill",
        "~/.claude/skills/seo-audit-skill"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "seo-audit-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/seo-skills/seo-audit-skill",
          "~/.claude/skills/seo-audit-skill"
        ]
      }
    }
  }
}

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

claude mcp add seo-audit-skill -- git clone https://github.com/seo-skills/seo-audit-skill ~/.claude/skills/seo-audit-skill

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

Casos de uso

Usos del mundo real: seo-audit-skill

Cómo ejecutar tu primera auditoría SEO completa y priorizar soluciones

👤 Propietarios de sitios y profesionales SEO que heredan un sitio con salud SEO desconocida ⏱ ~30 min beginner

Cuándo usarlo: Proyecto nuevo, sitio nuevo o lista de verificación previa al lanzamiento.

Requisitos previos

Skill instalada — git clone https://github.com/seo-skills/seo-audit-skill ~/.claude/skills/seo-audit-skill
Node 18+ — nvm install 18

Flujo

Ejecutar auditoría completa

Ejecuta seo-audit-skill en https://example.com — todas las 108 reglas, salida en markdown.✓ Copiado

→ Informe con aprobado/fallo por regla y resumen de categorías
Priorizar por impacto

Agrupa los fallos en 'enviar esta semana' (alto impacto, bajo esfuerzo) vs 'backlog'. Explica el punto de corte.✓ Copiado

→ Lista de soluciones clasificada con justificación
Generar PRs de solución

Para los 5 elementos principales de 'enviar esta semana', redacta los cambios de código en un diff listo para PR.✓ Copiado

→ Diffs para meta etiquetas, encabezados y datos estructurados

Resultado: Una lista de soluciones SEO de tamaño de sprint con diffs redactados.

Errores comunes

Las puntuaciones de Lighthouse varían de ejecución a ejecución — Ejecuta 3 veces, toma la mediana; la skill admite --runs=3
Las reglas marcan falsos positivos en SPAs pesadas en JS — Usa --render=js para habilitar la representación de JS; cuesta más tiempo

Combinar con: trae-skill

Ejecutar solo las verificaciones de Core Web Vitals en CI

👤 Ingenieros de rendimiento integrando SEO a CI ⏱ ~20 min intermediate

Cuándo usarlo: Quieres una puerta CI que bloquee regresiones en LCP/CLS/INP.

Flujo

Limitar a categoría CWV

Ejecuta seo-audit-skill --category=cwv en nuestra URL de staging.✓ Copiado

→ Solo las reglas de CWV con valores
Envolver en CI

Genera un paso de GitHub Actions que ejecute esto y falle si LCP > 2.5s.✓ Copiado

→ Fragmento YAML con lógica de umbral

Resultado: Una puerta CI que detecte regresiones de rendimiento antes de prod.

Errores comunes

El ejecutor de CI es más lento que los usuarios — Usa datos de campo a través de CrUX cuando sea posible; trata los datos de laboratorio como un detector de regresión, no como un objetivo absoluto

Validar y reparar datos estructurados (JSON-LD)

👤 Desarrolladores que quieren resultados enriquecidos en SERPs ⏱ ~25 min intermediate

Cuándo usarlo: Tus páginas no están obteniendo fragmentos enriquecidos a pesar de tener JSON-LD.

Flujo

Limitar a reglas de datos estructurados

Ejecuta seo-audit-skill --category=structured-data en estas 5 URLs.✓ Copiado

→ Lista por URL de errores de esquema y campos requeridos faltantes
Generar JSON-LD corregido

Para cada error, produce el fragmento JSON-LD corregido codificado por tipo de página.✓ Copiado

→ Fragmentos por página listos para pegar

Resultado: JSON-LD válido para Schema.org desplegado; listo para volver a verificar mediante Google Rich Results Test.

Errores comunes

Esquema válido pero Google aún no muestra resultados enriquecidos — La validez es necesaria, pero no suficiente. Verifica las directrices de elegibilidad para el tipo de resultado enriquecido específico.

Auditar y establecer encabezados de seguridad

👤 Desarrolladores que desean seguridad base + señal SEO ⏱ ~45 min intermediate

Cuándo usarlo: securityheaders.com te dio una F y quieres saber por qué.

Flujo

Ejecutar categoría de seguridad

Ejecuta seo-audit-skill --category=security en https://example.com.✓ Copiado

→ Estado de CSP, HSTS, X-Frame-Options, Referrer-Policy
Generar configuración de encabezados

Produce las configuraciones de nginx y Cloudflare Worker para establecer los encabezados faltantes de manera segura (CSP de solo informe primero).✓ Copiado

→ Configuraciones listas para copiar y pegar con CSP de solo informe

Resultado: Una configuración de encabezado seguro implementada detrás del modo de solo informe.

Errores comunes

Aplicar CSP rompe el sitio — Siempre comienza con Content-Security-Policy-Report-Only; observa los informes durante 1-2 semanas antes de aplicar

Combinar con: claude-code-owasp-skill

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

seo-audit-skill + trae-skill

TRAE proporciona la estructura de conceptos básicos de SEO, seo-audit los verifica

Proporciona la estructura de SEO con TRAE, ejecuta seo-audit para verificar, soluciona lagunas.✓ Copiado

seo-audit-skill + claude-code-owasp-skill

El subconjunto de encabezado de seguridad de SEO se superpone con las verificaciones de OWASP

Ejecuta la categoría de seguridad de seo-audit, luego la skill de OWASP para una revisión de seguridad más profunda.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
full_audit	url: str, runs?: int, render?: 'js'\|'static'	Primera auditoría en un sitio	0
category_audit	url, category: 'cwv'\|'security'\|'structured-data'\|...	Verificaciones enfocadas o CI	0
diff_fix_generator	report, top_n?	Después de la auditoría, para convertir los hallazgos en PRs	Claude tokens

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno. Se ejecuta localmente a través de Chromium sin interfaz.
Tokens por llamada: La interpretación del informe utiliza 5-15k tokens de Claude dependiendo del tamaño del sitio
Monetario: Gratuito
Consejo: Usa --category= para evitar ejecutar las 108 reglas cuando solo necesitas un subconjunto.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales

Salida de datos: Obtiene la URL de destino y sus activos. No envía el informe a terceros.

La ejecución contra URLs autenticadas/intranet requiere que pases cookies — no codifiques tokens de sesión.

Resolución de problemas

Errores comunes y soluciones

Puppeteer no se inicia

Instala las dependencias de Chrome: apt-get install libgbm1 libnss3 (Linux) o ejecuta npx puppeteer browsers install chrome

Verificar: node -e 'require("puppeteer").launch().then(b=>b.close())'

Las reglas marcan características modernas del marco JS como problemas

Usa --render=js para que la auditoría se ejecute después de la hidratación

Todas las reglas de CWV reportan N/A

Modo de laboratorio de Lighthouse; en conexiones lentas se agota. Aumenta --timeout.

Alternativas

seo-audit-skill vs otros

Alternativa	Cuándo usarla	Contrapartida
Google Lighthouse CLI	Solo necesitas el subconjunto canónico de CWV/perf	Sin datos estructurados o reglas específicas de SEO
Screaming Frog	Necesitas rastreo de nivel empresarial de sitios grandes	Pagado, aplicación de escritorio, no integrado con LLM

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills