Unlighthouse
Unlighthouse es una herramienta de código abierto diseñada para desarrolladores web, especialistas en SEO técnico y equipos de QA que necesitan auditar sitios web completos de forma automatizada. A diferencia de Lighthouse estándar, esta solución rastrea dominios enteros, descubre rutas mediante sitemaps o crawling y genera informes agregados de Core Web Vitals. Es ideal para monitorizar el rendimiento, la accesibilidad y el SEO en ecosistemas digitales extensos mediante un panel interactivo.
Análisis de Tendencia
Evolución del interés y popularidad en el mercado.
1007550250
may 25
ago 25
nov 25
feb 26
may 26
Qué y para quién es
Unlighthouse es una herramienta de código abierto diseñada para escanear sitios web completos utilizando Google Lighthouse de forma automatizada. A diferencia de la herramienta estándar de Lighthouse que audita páginas individuales, Unlighthouse rastrea todo un dominio, descubre sus rutas y genera informes agregados. Está dirigida a desarrolladores web, especialistas en SEO técnico y equipos de QA que necesitan monitorizar la salud de Core Web Vitals y el rendimiento en todo un ecosistema digital y no solo en la página de inicio.
Principal ventaja profesional
La capacidad de ejecutar auditorías masivas en segundos con un solo comando, proporcionando un panel de control interactivo en tiempo real que identifica automáticamente los problemas de rendimiento comunes en cientos de páginas mediante el muestreo inteligente.
Para quién no es
No es adecuado para profesionales que buscan auditorías rápidas de una sola URL (donde las DevTools de Chrome son suficientes) ni para aquellos que no tienen acceso a un entorno de ejecución Node.js o familiaridad básica con la línea de comandos (CLI).
funcionalidades clave
- Escaneo masivo: descubrimiento automático de páginas mediante sitemaps, robots.txt o rastreo (crawling).
- Panel de control interactivo: interfaz local para visualizar puntuaciones de rendimiento, accesibilidad, SEO y mejores prácticas conforme se completan.
- Muestreo dinámico: identifica plantillas similares (como posts de un blog) y solo audita una muestra para ahorrar tiempo y recursos.
- Ejecución en paralelo: utiliza múltiples instancias de Chrome simultáneamente para acelerar el proceso de auditoría.
- Simulación de dispositivos: permite alternar fácilmente entre auditorías para escritorio y móvil.
- Persistencia de datos: almacenamiento en caché de informes para comparar resultados entre ejecuciones.
Precios
La herramienta es completamente gratuita y de código abierto.
- Versión gratuita: Open source bajo licencia MIT, funcionalidad completa sin restricciones de uso por número de páginas o sitios.
- Coste de infraestructura: Al ser autohospedado, el único coste asociado es el consumo de recursos (CPU/RAM) del equipo o servidor donde se ejecute.
Perfil del usuario
- Agencias de marketing digital y SEO que auditan sitios de clientes.
- Departamentos de IT y Desarrollo Web que mantienen grandes catálogos de e-commerce o portales de noticias.
- Responsables de Producto que necesitan asegurar estándares de accesibilidad en toda la plataforma.
- Desarrolladores Frontend (Vite, Nuxt, React, Vue) que integran auditorías en sus flujos de trabajo locales.
Nivel técnico requerido
- Nivel técnico de uso: Medio. Requiere manejo de la terminal de comandos.
- Nivel técnico de instalación: Bajo-Medio. Requiere tener instalado Node.js (versión 20+) y un navegador basado en Chromium.
- Necesidades de soporte: Mínimas, habitualmente gestionadas por el propio equipo de desarrollo.
- Competencias necesarias: Conocimiento básico de NPM/NPX y comprensión de las métricas de Lighthouse (LCP, CLS, INP).
Ejemplos de uso profesional
- Auditoría pre-lanzamiento: Verificar que ninguna sección nueva del sitio web degrada la puntuación de rendimiento global.
- Monitorización en CI/CD: Bloquear despliegues en producción si la puntuación de accesibilidad o SEO cae por debajo de un umbral definido.
- Reporte periódico a clientes: Generar informes agregados del estado de salud técnico mensual de un sitio web completo.
- Identificación de cuellos de botella: Detectar patrones de errores (ej. imágenes sin dimensiones) que se repiten en miles de páginas de producto.
Uso y distribución
- Versión web: Dispone de un dashboard local interactivo que se abre automáticamente en el navegador tras ejecutar el comando.
- Versión escritorio: Ejecutable en Windows (incluyendo WSL), macOS y Linux.
- CLI: Herramienta principal basada en línea de comandos para ejecuciones locales o en servidores.
Open source
Licencia MIT, repositorio disponible bajo la organización de harlan-zw en GitHub.
Integraciones
- Facilidad de integración: No code para uso básico, full code para configuraciones avanzadas mediante
unlighthouse.config.ts. - API propia: Dispone de una API programática para construir integraciones personalizadas y extender funcionalidades.
- Integraciones nativas: Soporte directo para frameworks y herramientas modernas como Vite, Nuxt y Webpack.
- CI/CD: Plugins específicos para GitHub Actions y otros entornos de integración continua para automatizar auditorías en cada commit.
Notas finales
información legal, licencias, contratos
- El software se distribuye "tal cual" bajo licencia MIT, lo que permite su uso comercial, modificación y distribución privada sin coste. No existe un contrato de nivel de servicio (SLA) al ser una herramienta de la comunidad.
Otros
- Unlighthouse utiliza Puppeteer-cluster para la gestión de la concurrencia, lo que optimiza el uso de los núcleos de la CPU durante los escaneos intensivos.
Para más información:
- Sitio web oficial: https://unlighthouse.dev
- Github: https://github.com/harlan-zw/unlighthouse
- Discord: https://discord.gg/275MBUBvgP
- Documentación técnica: https://unlighthouse.dev/guide/getting-started/installation
Aplicación profesional
- Tipo de empresa: Agencias de desarrollo web, consultoras de SEO técnico, departamentos de IT internos y equipos de QA que gestionen sitios de mediana y gran escala (+50 URLs).
- Presupuesto: Herramienta gratuita (Open Source). El coste principal deriva del tiempo de análisis de los perfiles técnicos y el consumo de recursos de computación (CPU/RAM).
- Puntos clave: Automatización de Core Web Vitals, detección de errores recurrentes en plantillas de diseño y auditoría de accesibilidad masiva.
Madurez digital requerida
- Usuarios: Familiaridad con la línea de comandos (CLI), manejo de Node.js y capacidad de interpretación de métricas de rendimiento web (LCP, FID, CLS).
- Empresa: Necesidad de procesos de control de calidad (QA) o mantenimiento proactivo de la salud técnica del sitio web.
Plan orientativo de implantación
Pasos necesarios y estimaciones
- Tiempos estimados de despliegue: Entre 30 y 60 minutos para la configuración inicial y el primer escaneo completo.
- Evaluación inicial: Identificación de los dominios críticos a auditar y verificación de la existencia de sitemaps válidos para facilitar el rastreo inteligente.
- Implantación inicial: Instalación de la dependencia mediante NPM/NPX y ejecución de un escaneo de prueba limitado a una subsección del sitio.
- Configuración y personalización: Creación del archivo
unlighthouse.config.tspara definir umbrales de puntuación, rutas excluidas y simulación de dispositivos (Mobile vs Desktop). - Formación y adaptación: Sesión técnica para alinear criterios sobre qué métricas Lighthouse impactan en los objetivos de negocio.
Necesidades de formación del equipo
- Uso de la interfaz local para filtrar resultados y exportar informes.
- Configuración de Puppeteer para sitios que requieren autenticación o manejo de cookies.
- Interpretación de los diagnósticos de Lighthouse para convertirlos en tickets de desarrollo.
Perfiles necesarios
- Perfiles técnicos necesarios: Desarrollador Frontend o Especialista en SEO Técnico.
- Personal externo recomendado: No es estrictamente necesario, salvo consultoría puntual para la optimización de los hallazgos.
- Otros: Administrador de sistemas si se desea integrar en tuberías de CI/CD (GitHub Actions, Jenkins).
Retorno de la inversión
- Tiempos: Ahorro drástico de horas de trabajo frente al análisis manual página por página. Una auditoría de 500 páginas puede completarse en minutos.
- KPI: Puntuaciones medias de Lighthouse por categoría, número de páginas con puntuación inferior a 90, reducción de errores de accesibilidad y mejora en el posicionamiento orgánico derivado de mejores Core Web Vitals.
Otros
- Eficiencia de hardware: Unlighthouse utiliza Puppeteer-cluster para la gestión de concurrencia, lo que permite aprovechar todos los núcleos de la CPU para ejecutar auditorías en paralelo.
- Muestreo inteligente: La herramienta agrupa automáticamente URLs con estructuras similares para evitar auditorías redundantes y ahorrar recursos.
- Persistencia: Los informes se guardan localmente en formato JSON y HTML, lo que permite realizar comparativas históricas sin necesidad de re-escanear todo el sitio.
Princiaples recomendaciones
- Evaluar el impacto en el rendimiento de los servidores antes de realizar un escaneo masivo, ya que el rastreo (crawling) intensivo puede ser interpretado como un ataque de denegación de servicio (DoS).
- Configurar correctamente el archivo
.gitignorepara evitar la subida de informes técnicos (.unlighthouse) a repositorios públicos, lo que podría exponer rutas internas o vulnerabilidades del sitio. - Asegurar que el entorno de ejecución (Node.js) esté actualizado y bajo control de la empresa para evitar la ejecución de código no verificado de paquetes de terceros (dependencias).
- Al ser una herramienta basada en la comunidad sin Contrato de Nivel de Servicio (SLA), se debe disponer de un plan de contingencia técnico interno en caso de fallos en auditorías críticas.
Privacidad y protección de datos
- Responsabilidades: La empresa usuaria es la única responsable del tratamiento de los datos. Al ejecutarse de forma local (self-hosted) o en servidores propios, la herramienta no transfiere datos de rastreo a terceros fuera del control del usuario.
- Ubicación de los datos: Los datos e informes generados se almacenan localmente en la máquina o servidor donde se ejecuta la herramienta (por defecto en la carpeta
.unlighthouse). - Transferencia internacional: No se identifican transferencias internacionales de datos automáticas por el uso de la herramienta, ya que es un software de ejecución local. No obstante, al utilizar el motor de Google Lighthouse, se deben revisar las políticas de telemetría de Google si se utilizan servicios en la nube de dicho proveedor.
- Derechos ARCO: Al no recopilar datos de carácter personal de forma proactiva, la gestión de estos derechos recae sobre la política general de la empresa respecto a sus registros de auditoría y logs de servidores.
Propiedad intelectual
- Propiedad de datos: Los datos obtenidos de las auditorías pertenecen íntegramente a la empresa que ejecuta el software.
- Propiedad del resultado: El software se distribuye bajo Licencia MIT, lo que otorga permiso para usar, copiar, modificar y distribuir el software sin restricciones, siempre que se incluya el aviso de copyright original.
- Responsabilidad: El software se entrega "tal cual", sin garantías de ningún tipo. El autor original no es responsable de reclamaciones o daños derivados del uso del software.
Usos y prohibiciones
- Usos admitidos: Auditorías técnicas de rendimiento, accesibilidad y SEO en entornos de desarrollo, pre-producción y producción. Uso comercial y privado permitido.
- Usos prohibidos: No debe utilizarse para realizar rastreos malintencionados en sitios web de terceros sin autorización expresa, lo cual podría vulnerar normativas de ciberseguridad y protección de servicios digitales.
Seguridad y certificaciones
- Seguridad: La herramienta utiliza Chromium y Puppeteer. Es crítico mantener estas dependencias actualizadas para corregir vulnerabilidades del motor del navegador.
- Certificaciones: Al ser un proyecto de código abierto comunitario, no dispone de certificaciones ISO o esquemas de seguridad auditados formalmente. La seguridad depende del endurecimiento (hardening) del entorno donde la empresa decida alojarlo.
Otros
- Impacto legal: Bajo. El riesgo principal es técnico (disponibilidad del sitio auditado) más que legal, siempre que se limite a activos digitales propios.
- Naturaleza de la herramienta: Se clasifica como software de infraestructura y diagnóstico técnico. No procesa datos personales de clientes finales de forma predeterminada.
Fuentes consultada:
Preguntas frecuentes sobre Unlighthouse
Q.¿Qué es Unlighthouse y en qué se diferencia del Google Lighthouse estándar?
Unlighthouse es una herramienta de código abierto que automatiza el escaneo de sitios web completos utilizando el motor de Google Lighthouse. Mientras que la herramienta estándar audita páginas individuales de forma manual, Unlighthouse rastrea todo un dominio, descubre sus rutas automáticamente y genera informes agregados de rendimiento, accesibilidad y SEO para todo el sitio.
Q.¿Para qué tipo de perfiles profesionales está recomendada esta herramienta?
Está diseñada específicamente para desarrolladores web, especialistas en SEO técnico, ingenieros de QA y responsables de producto. Es especialmente útil para quienes gestionan ecosistemas digitales extensos, como e-commerce o portales de noticias, donde auditar página por página resulta ineficiente.
Q.¿Cuánto cuesta utilizar Unlighthouse?
La herramienta es completamente gratuita y no tiene costes de licencia. Se distribuye como software de código abierto bajo la licencia MIT, lo que permite un uso ilimitado en cuanto a número de sitios o páginas escaneadas. Los únicos costes asociados son los recursos de infraestructura (CPU y RAM) del ordenador o servidor donde se ejecute.
Q.¿Es Open Source y dónde puede descargarse?
Sí, es un proyecto de código abierto. El código fuente, la documentación y los paquetes de instalación están disponibles públicamente en su repositorio de GitHub bajo la organización harlan-zw. Se puede instalar y ejecutar fácilmente mediante comandos de NPM o NPX.
Q.¿Qué requisitos técnicos mínimos se necesitan para su instalación?
Requiere un entorno de ejecución con Node.js (versión 20 o superior) y tener instalado un navegador basado en Chromium. No requiere una configuración de servidor compleja, pero sí familiaridad básica con la interfaz de línea de comandos (CLI) y el ecosistema de paquetes de JavaScript.
Q.¿Cómo aborda Unlighthouse la privacidad y seguridad de los datos?
Al ser una herramienta autohospedada que se ejecuta localmente o en servidores privados del usuario, los datos de las auditorías no se envían a servidores externos de terceros. El usuario mantiene el control total sobre la persistencia y distribución de los informes generados.
Q.¿Es posible integrar Unlighthouse en flujos de trabajo profesionales como CI/CD?
Sí, ofrece una API programática y plugins específicos para entornos de integración continua como GitHub Actions. Esto permite automatizar auditorías en cada despliegue, bloqueando versiones que no cumplan con los umbrales mínimos de rendimiento o accesibilidad definidos por el equipo.
Q.¿Cómo optimiza el tiempo de escaneo en sitios con miles de URLs?
La herramienta utiliza dos estrategias principales: la ejecución en paralelo mediante Puppeteer-cluster, que aprovecha múltiples núcleos de la CPU, y el muestreo dinámico, que identifica plantillas repetitivas (como fichas de producto similares) y solo audita una muestra representativa para ahorrar tiempo y recursos.
Q.¿Cumple con la normativa española y estándares europeos de accesibilidad?
Unlighthouse utiliza las auditorías de Lighthouse, que se basan en los estándares WCAG (Web Content Accessibility Guidelines). Estas métricas son la referencia técnica utilizada para evaluar el cumplimiento de las normativas de accesibilidad digital exigidas tanto en España como en la Unión Europea para sitios web públicos y privados.
Q.¿Qué nivel de soporte ofrece en caso de fallos técnicos?
Al ser un proyecto comunitario de código abierto, no cuenta con un contrato de nivel de servicio (SLA) ni soporte técnico oficial garantizado. El soporte se gestiona a través de la comunidad en GitHub (mediante 'Issues') y canales de comunicación como Discord, donde los desarrolladores y usuarios comparten soluciones.