Communitygithub.com

AndresOrozcoDev/website

Audita sitios web para SEO, aspectos técnicos, contenido, seguridad, renderizado JS y preparación para IA usando la CLI de SEOmator. Devuelve informes optimizados para LLM con puntuaciones de salud en 251 reglas y 20 categorías. Úsalo al analizar sitios web, depurar problemas de SEO o verificar el estado del sitio.

¿Qué es website?

Esta habilidad permite a agentes de IA auditar sitios web utilizando la CLI de SEOmator, analizando la estructura y el contenido en 251 reglas distribuidas en 20 categorías como SEO básico, rendimiento, enlaces, imágenes, seguridad, SEO técnico, rastreabilidad, datos estructurados, renderizado JavaScript, accesibilidad, contenido, E-E-A-T, preparación para IA/GEO, entre otras. Es útil para diagnosticar problemas de SEO, verificar enlaces rotos, validar metadatos y datos estructurados, auditar seguridad y accesibilidad, y generar informes detallados con puntuaciones de salud (0-100) y recomendaciones de corrección. Soporta formatos de salida como JSON, HTML, Markdown y un formato LLM optimizado para agentes, reduciendo el consumo de tokens entre un 50-70%. La herramienta puede rastrear múltiples páginas, forzar actualizaciones, reanudar auditorías interrumpidas y enfocarse en categorías específicas mediante opciones de línea de comandos flexibles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

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:

  1. Prefiere sitios web en vivo sobre servidores de desarrollo locales para obtener datos precisos de rendimiento y renderizado
  2. Usa --no-cwv para auditorías más rápidas cuando no sean necesarias las comprobaciones de Core Web Vitals y renderizado JS
  3. Delimita correcciones como tareas concurrentes al implementar múltiples correcciones
  4. 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:

  1. Verifica las configuraciones del servidor de desarrollo local (scripts en package.json, archivos .env)
  2. Busca enlaces de proyectos de Vercel/Netlify
  3. Verifica las variables de entorno para URLs de despliegue
  4. 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ónAliasDescripciónValor predeterminado
--format <fmt>-fFormato de salida: console, json, html, markdown, llmconsole
--max-pages <n>-mNúmero máximo de páginas a rastrear10
--crawlHabilitar rastreo de múltiples páginasfalse
--categories <list>-cLista separada por comas de categorías a auditarTodas
--refresh-rIgnorar caché, obtener datos frescosfalse
--resumeReanudar rastreo interrumpidofalse
--no-cwvOmitir Core Web Vitals + renderizado JSfalse
--verbose-vMostrar progresofalse
--output <path>-oRuta del archivo de salida
--config <path>Ruta del archivo de configuración
--saveGuardar en ~/.seomatorfalse

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

FormatoBanderínMejor para
console--format consoleSalida de terminal para humanos (predeterminado)
json--format jsonCI/CD, procesamiento programático
html--format htmlInformes independientes, compartir
markdown--format markdownDocumentación, GitHub
llm--format llmAgentes 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ónCalificaciónSignificado
90-100AExcelente - Solo optimizaciones menores
80-89BBueno - Abordar advertencias
70-79CNecesita trabajo - Correcciones prioritarias requeridas
50-69DPobre - Múltiples problemas críticos
0-49FCrítico - Problemas importantes que resolver

Orden de prioridad (por peso de categoría)

Corrige los problemas en este orden para máximo impacto:

  1. Básico (12%) - Metaetiquetas, canónicas, H1, indexación
  2. Rendimiento (12%) - Core Web Vitals + optimización
  3. Enlaces (8%) - Estructura de enlaces internos
  4. Imágenes (8%) - Rendimiento + accesibilidad
  5. Seguridad (8%) - Señales de confianza, SSL
  6. SEO Técnico (7%) - Base de rastreo
  7. Rastreabilidad (5%) - Indexabilidad, paginación
  8. Datos Estructurados (5%) - Fragmentos enriquecidos
  9. Renderizado JavaScript (5%) - DOM renderizado, SSR
  10. Contenido (5%) - Calidad de texto + duplicados
  11. Accesibilidad (4%) - Cumplimiento WCAG
  12. Social (3%) - Compartir en redes sociales
  13. E-E-A-T (3%) - Confianza, experiencia
  14. Estructura URL (3%) - Higiene de URL
  15. Redirecciones (3%) - Cadenas de redirección
  16. Móvil (2%) - Viewport, fuentes
  17. Internacionalización (2%) - Hreflang
  18. Validación HTML (2%) - Estructura del documento
  19. Preparación para IA/GEO (2%) - HTML semántico, bots de IA
  20. Cumplimiento Legal (1%) - Consentimiento de cookies

Corregir por gravedad

  1. Fallos (status: "fail") - Debes corregir de inmediato
  2. Advertencias (status: "warn") - Debes corregir pronto
  3. 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:

  1. Instala Chrome, Chromium o Edge
  2. Ejecuta seomator self doctor para verificar la detección del navegador
  3. Usa --no-cwv para 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 --verbose para ver el progreso
  • Limita las páginas con -m 20 para obtener resultados más rápidos
  • Usa --no-cwv para 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

  1. Obtener: Descarga el HTML de la página y mide el tiempo de respuesta
  2. Analizar: Extrae DOM, metaetiquetas, enlaces, imágenes, datos estructurados
  3. Enriquecer: Obtiene robots.txt y sitemap una vez por auditoría
  4. Renderizar (si CWV está habilitado): Captura el DOM renderizado mediante Playwright para análisis de renderizado JS
  5. Rastrear (si está habilitado): Descubre y obtiene páginas enlazadas
  6. Analizar: Ejecuta 251 reglas de auditoría contra cada página
  7. Puntuar: Calcula las puntuaciones ponderadas por categoría y general
  8. 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.md para las 251 reglas
  • Arquitectura de almacenamiento: Consulta docs/STORAGE-ARCHITECTURE.md para detalles de la base de datos
  • Ayuda de CLI: seomator --help y seomator <comando> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

Skills relacionados