Habilidad de Auditoría SEO
Audita sitios web para SEO, aspectos técnicos, contenido, rendimiento, seguridad, renderizado JavaScript y preparación para IA usando la CLI de SEOmator.
SEOmator proporciona una auditoría integral del sitio web mediante el análisis de su estructura y contenido según 251 reglas en 20 categorías.
Proporciona una lista de problemas con niveles de gravedad, URL afectadas y sugerencias de corrección procesables.
Enlaces
- Paquete npm de SEOmator: npmjs.com/package/@seomator/seo-audit
- Repositorio de GitHub: github.com/seo-skills/seo-audit-skill
- Interfaz web: seomator.com/free-seo-audit-tool
Qué hace esta habilidad
Esta habilidad permite a los agentes de IA auditar sitios web según 251 reglas en 20 categorías, incluyendo:
- SEO Básico (19 reglas): URLs canónicas, directivas de indexación, unicidad de título, conflictos/bucles canónicos
- Rendimiento (22 reglas): LCP, CLS, FCP, TTFB, INP, compresión, almacenamiento en caché, minificación, HTTP/2
- Enlaces (19 reglas): Enlaces rotos, cadenas de redirección, texto de anclaje, páginas huérfanas, enlaces localhost/fragmento
- Imágenes (14 reglas): Texto alternativo, dimensiones, carga diferida, formatos modernos, longitud de alt, imágenes de fondo
- Seguridad (16 reglas): HTTPS, HSTS, CSP, seguridad de enlaces externos, secretos filtrados, caducidad/protocolo SSL
- SEO Técnico (13 reglas): robots.txt, sitemap.xml, estructura de URL, páginas 404, soft 404s, códigos de error
- Rastreabilidad (18 reglas): Conflictos de sitemap, señales de indexabilidad, cadenas canónicas, problemas de paginación
- Datos Estructurados (13 reglas): Marcado Schema.org, Artículo, Organización, FAQ, Producto, Migas de pan
- Renderizado JavaScript (13 reglas): Verificaciones del DOM renderizado, discrepancias entre raw y renderizado, detección SSR
- Accesibilidad (12 reglas): Etiquetas ARIA, contraste de color, etiquetas de formulario, puntos de referencia, objetivos táctiles
- Contenido (17 reglas): Conteo de palabras, legibilidad, densidad de palabras clave, detección de duplicados, anchos de píxel
- Social (9 reglas): Etiquetas Open Graph, tarjetas de Twitter, botones para compartir, enlaces de perfil
- E-E-A-T (14 reglas): Firma de autor, citas, señales de confianza, páginas de acerca de/contacto, detección YMYL
- Estructura URL (14 reglas): Slugs con palabras clave, palabras vacías, mayúsculas, guiones bajos, IDs de sesión, parámetros de seguimiento
- Redirecciones (8 reglas): Bucles de redirección, tipos (301/302), meta refresh, redirecciones JavaScript, redirecciones rotas
- Móvil (5 reglas): Tamaños de fuente, desplazamiento horizontal, intersticiales intrusivos, problemas de viewport
- Internacionalización (10 reglas): Atributo lang, validación de hreflang (enlaces de retorno, conflictos, discrepancias)
- Validación HTML (9 reglas): Doctype, charset, estructura de head, lorem ipsum, múltiples títulos/descripciones
- Preparación para IA/GEO (5 reglas): HTML semántico, acceso a bots de IA, llms.txt, deriva de esquema
- Cumplimiento Legal (1 regla): Consentimiento de cookies
La auditoría rastrea el sitio web, analiza cada página según las reglas de auditoría y devuelve un informe completo con:
- Puntuación de salud general (0-100) con calificación en letra (A-F)
- Desgloses por categoría con recuentos de aprobados/advertencias/fallos
- Problemas específicos con URL afectadas agrupadas por regla
- Recomendaciones de corrección procesables
Cuándo usar
Usa esta habilidad cuando necesites:
- Analizar la salud SEO de un sitio web
- Depurar problemas técnicos de SEO
- Verificar enlaces rotos y cadenas de redirección
- Validar metaetiquetas, URLs canónicas y datos estructurados
- Auditar cabeceras de seguridad, SSL y HTTPS
- Verificar el cumplimiento de accesibilidad
- Analizar el renderizado JavaScript y la compatibilidad SSR
- Evaluar la preparación para IA/GEO (HTML semántico, llms.txt, acceso a bots)
- Detectar contenido duplicado entre páginas
- Validar la configuración de hreflang e internacionalización
- Verificar la estructura y validación del documento HTML
- Generar informes de auditoría del sitio en múltiples formatos
- Comparar la salud del sitio antes/después de los cambios
Prerrequisitos
Esta habilidad requiere tener instalada la CLI de SEOmator.
Instalación
npm install -g @seomator/seo-audit
Verificar instalación
Comprueba que seomator esté instalado y el sistema esté listo:
seomator self doctor
Esto verifica:
- Versión de Node.js (18+ recomendada)
- Disponibilidad de npm
- Chrome/Chromium para Core Web Vitals y renderizado JS
- Permisos de escritura en ~/.seomator
- Presencia del archivo de configuración local
Configuración
Ejecutar seomator init crea un archivo de configuración seomator.toml en el directorio actual.
seomator init # Configuración interactiva
seomator init -y # Usar valores predeterminados
seomator init --preset blog # Configuración optimizada para blogs
seomator init --preset ecommerce # Configuración para comercio electrónico
seomator init --preset ci # Configuración mínima para CI
Si no hay un archivo seomator.toml en el directorio, CREA UNO con seomator init antes de ejecutar auditorías.
Uso
Mejores Prácticas para Agentes de IA
SIEMPRE debes preferir --format llm - proporciona una salida XML optimizada en tokens, diseñada específicamente para agentes de IA (50-70% más pequeña que JSON).
Al auditar:
- Prefiere sitios web en vivo sobre servidores de desarrollo locales para obtener datos precisos de rendimiento y renderizado
- Usa
--no-cwvpara auditorías más rápidas cuando no sean necesarias las comprobaciones de Core Web Vitals y renderizado JS - Delimita correcciones como tareas concurrentes al implementar múltiples correcciones
- Ejecuta verificación de tipos/formateo después de implementar correcciones (tsc, eslint, prettier, etc.)
Descubrimiento del Sitio Web
Si el usuario no proporciona un sitio web para auditar:
- Verifica las configuraciones del servidor de desarrollo local (scripts en package.json, archivos .env)
- Busca enlaces de proyectos de Vercel/Netlify
- Verifica las variables de entorno para URLs de despliegue
- Pregunta al usuario qué URL auditar
Si tienes sitios web locales y en vivo disponibles, sugiere auditar el sitio en vivo para obtener resultados precisos.
Flujo de trabajo básico
# Auditoría rápida de una sola página con salida LLM
seomator audit https://example.com --format llm --no-cwv
# Rastreo de múltiples páginas (hasta 50 páginas)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# Auditoría completa con Core Web Vitals + análisis de renderizado JS
seomator audit https://example.com --crawl -m 20 --format llm
Opciones avanzadas
Forzar rastreo fresco (ignorar caché):
seomator audit https://example.com --refresh --format llm
Reanudar rastreo interrumpido:
seomator audit https://example.com --resume --format llm
Auditar solo categorías específicas:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
Guardar informe HTML para compartir:
seomator audit https://example.com --format html -o report.html
Salida verbosa para depuración:
seomator audit https://example.com --format llm -v
Referencia de comandos
Opciones del comando audit
| Opción | Alias | Descripción | Valor predeterminado |
|---|---|---|---|
--format <fmt> | -f | Formato de salida: console, json, html, markdown, llm | console |
--max-pages <n> | -m | Número máximo de páginas a rastrear | 10 |
--crawl | Habilitar rastreo de múltiples páginas | false | |
--categories <list> | -c | Lista separada por comas de categorías a auditar | Todas |
--refresh | -r | Ignorar caché, obtener datos frescos | false |
--resume | Reanudar rastreo interrumpido | false | |
--no-cwv | Omitir Core Web Vitals + renderizado JS | false | |
--verbose | -v | Mostrar progreso | false |
--output <path> | -o | Ruta del archivo de salida | |
--config <path> | Ruta del archivo de configuración | ||
--save | Guardar en ~/.seomator | false |
Otros comandos
seomator init # Crear archivo de configuración
seomator self doctor # Verificar configuración del sistema
seomator config --list # Mostrar todos los valores de configuración
seomator report --list # Listar informes anteriores
seomator db stats # Mostrar estadísticas de la base de datos
Formatos de salida
| Formato | Banderín | Mejor para |
|---|---|---|
| console | --format console | Salida de terminal para humanos (predeterminado) |
| json | --format json | CI/CD, procesamiento programático |
| html | --format html | Informes independientes, compartir |
| markdown | --format markdown | Documentación, GitHub |
| llm | --format llm | Agentes de IA (recomendado) |
La salida --format llm es un formato XML compacto optimizado para eficiencia de tokens:
- 50-70% más pequeña que la salida JSON
- Problemas ordenados por gravedad (críticos primero)
- Sugerencias de corrección incluidas para cada problema
- Salida estándar limpia para canalizar a herramientas de IA
Ejemplos
Ejemplo 1: Auditoría rápida con salida LLM
# El usuario pregunta: "Verifica example.com en busca de problemas de SEO"
seomator audit https://example.com --format llm --no-cwv
Ejemplo 2: Rastreo profundo para sitios grandes
# El usuario pregunta: "Haz una auditoría exhaustiva de hasta 100 páginas"
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
Ejemplo 3: Auditoría fresca después de cambios
# El usuario pregunta: "Vuelve a auditar el sitio, ignora los resultados en caché"
seomator audit https://example.com --refresh --format llm --no-cwv
Ejemplo 4: Generar informe compartible
# El usuario pregunta: "Crea un informe HTML que pueda compartir"
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
Ejemplo 5: Enfócate en áreas específicas
# El usuario pregunta: "Solo verifica mi renderizado JavaScript y redirecciones"
seomator audit https://example.com -c js,redirect --format llm
Evaluación de resultados
Rangos de puntuación
| Puntuación | Calificación | Significado |
|---|---|---|
| 90-100 | A | Excelente - Solo optimizaciones menores |
| 80-89 | B | Bueno - Abordar advertencias |
| 70-79 | C | Necesita trabajo - Correcciones prioritarias requeridas |
| 50-69 | D | Pobre - Múltiples problemas críticos |
| 0-49 | F | Crítico - Problemas importantes que resolver |
Orden de prioridad (por peso de categoría)
Corrige los problemas en este orden para máximo impacto:
- Básico (12%) - Metaetiquetas, canónicas, H1, indexación
- Rendimiento (12%) - Core Web Vitals + optimización
- Enlaces (8%) - Estructura de enlaces internos
- Imágenes (8%) - Rendimiento + accesibilidad
- Seguridad (8%) - Señales de confianza, SSL
- SEO Técnico (7%) - Base de rastreo
- Rastreabilidad (5%) - Indexabilidad, paginación
- Datos Estructurados (5%) - Fragmentos enriquecidos
- Renderizado JavaScript (5%) - DOM renderizado, SSR
- Contenido (5%) - Calidad de texto + duplicados
- Accesibilidad (4%) - Cumplimiento WCAG
- Social (3%) - Compartir en redes sociales
- E-E-A-T (3%) - Confianza, experiencia
- Estructura URL (3%) - Higiene de URL
- Redirecciones (3%) - Cadenas de redirección
- Móvil (2%) - Viewport, fuentes
- Internacionalización (2%) - Hreflang
- Validación HTML (2%) - Estructura del documento
- Preparación para IA/GEO (2%) - HTML semántico, bots de IA
- Cumplimiento Legal (1%) - Consentimiento de cookies
Corregir por gravedad
- Fallos (status: "fail") - Debes corregir de inmediato
- Advertencias (status: "warn") - Debes corregir pronto
- Aprobados (status: "pass") - No se necesita acción
Resumen de salida
Después de implementar correcciones, proporciona al usuario un resumen de todos los cambios realizados.
Al planificar el alcance, organiza las tareas para que puedan ejecutarse de forma concurrente como subagentes para acelerar la implementación.
Solución de problemas
Comando seomator no encontrado
Si ves este error, seomator no está instalado o no está en tu PATH.
Solución:
npm install -g @seomator/seo-audit
Core Web Vitals no medidos
Si faltan métricas de CWV, es posible que Chrome/Chromium no esté disponible.
Solución:
- Instala Chrome, Chromium o Edge
- Ejecuta
seomator self doctorpara verificar la detección del navegador - Usa
--no-cwvpara omitir CWV si no es necesario
Tiempo de espera o rendimiento lento del rastreo
Para sitios grandes, las auditorías pueden tomar varios minutos.
Solución:
- Usa
--verbosepara ver el progreso - Limita las páginas con
-m 20para obtener resultados más rápidos - Usa
--no-cwvpara omitir mediciones basadas en navegador
URL inválida
Asegúrate de que la URL incluya el protocolo:
# Incorrecto
seomator audit example.com
# Correcto
seomator audit https://example.com
Cómo funciona
- Obtener: Descarga el HTML de la página y mide el tiempo de respuesta
- Analizar: Extrae DOM, metaetiquetas, enlaces, imágenes, datos estructurados
- Enriquecer: Obtiene robots.txt y sitemap una vez por auditoría
- Renderizar (si CWV está habilitado): Captura el DOM renderizado mediante Playwright para análisis de renderizado JS
- Rastrear (si está habilitado): Descubre y obtiene páginas enlazadas
- Analizar: Ejecuta 251 reglas de auditoría contra cada página
- Puntuar: Calcula las puntuaciones ponderadas por categoría y general
- Informar: Genera salida en el formato solicitado
Los resultados se almacenan en ~/.seomator/ para su recuperación posterior con seomator report.
Recursos
- Referencia completa de reglas: Consulta
docs/SEO-AUDIT-RULES.mdpara las 251 reglas - Arquitectura de almacenamiento: Consulta
docs/STORAGE-ARCHITECTURE.mdpara detalles de la base de datos - Ayuda de CLI:
seomator --helpyseomator <comando> --help