Tutorial de Linkinator: Encuentra Enlaces Rotos en Next.js

Aprende a usar Linkinator para encontrar y arreglar enlaces rotos en tu sitio Next.js. Integración en CI/CD, flags clave y trucos para evitar falsos positivos.

21 jun 2026 • 3 min de lectura • Equipo Q2BSTUDIO

Automatiza la detección de enlaces caídos en Next.js

En el desarrollo web moderno, especialmente en frameworks como Next.js, la integridad de los enlaces internos y externos es un factor crítico tanto para la experiencia de usuario como para el posicionamiento SEO. Un enlace roto no solo genera una página 404 que frustra al visitante, sino que además envía señales negativas a los motores de búsqueda sobre la consistencia del sitio. Sin embargo, mantener una revisión manual de todos los enlaces es inviable en proyectos con decenas o cientos de páginas. Aquí es donde entra Linkinator, una herramienta ligera y potente que permite auditar de forma automatizada la salud de los enlaces de cualquier sitio web, incluyendo aplicaciones generadas con Next.js.

Linkinator se ejecuta directamente desde la terminal mediante npx, sin necesidad de instalación previa. Su funcionamiento es sencillo: dado un punto de partida, recorre todas las etiquetas <a>, <link> e <img> de la página, y verifica que cada URL responda con un código HTTP exitoso. Para sitios con múltiples páginas, el flag --recurse permite que la herramienta navegue por todas las rutas internas, construyendo una cola de verificación. Combinado con --silent, se elimina el ruido de las respuestas correctas y solo se muestran los fallos, ideal para entornos de integración continua. Además, parámetros como --timeout, --retry y --concurrency ofrecen control fino sobre la velocidad y la tolerancia a errores de servidores lentos o con límites de tasa.

Una de las funcionalidades más valiosas para proyectos Next.js es el URL rewriting. Durante el desarrollo local, las rutas internas suelen apuntar al dominio de producción, pero el servidor local corre en localhost. Con los flags --url-rewrite-search y --url-rewrite-replace, Linkinator sustituye el dominio de producción por el local antes de hacer las peticiones, permitiendo detectar enlaces rotos antes de desplegar. Esto se convierte en un guardián del deploy: si la verificación falla, el despliegue se detiene. Integrarlo en un pipeline de CI/CD con GitHub Actions es directo, y puede combinarse con herramientas como wait-on para asegurar que el servidor esté listo antes del escaneo.

Sin embargo, no todos los fallos son reales. Las redes sociales como LinkedIn, Twitter o Facebook bloquean peticiones automatizadas, generando falsos positivos. La solución es utilizar --skip con expresiones regulares para excluir esos dominios. También es recomendable manejar los límites de tasa de GitHub mediante --retry y, si es necesario, autenticación vía --header. Para rutas protegidas con autenticación, basta con omitirlas. Linkinator tampoco verifica el contenido semántico de los enlaces (por ejemplo, que un texto descriptivo lleve realmente al destino esperado) ni detecta enlaces renderizados dinámicamente con JavaScript. Para eso haría falta una herramienta como Playwright, pero como barrera de calidad básica, Linkinator es suficiente.

En Q2BSTUDIO, entendemos que la calidad del software no es un accidente, sino el resultado de procesos bien definidos. Por eso, al desarrollar aplicaciones a medida y software a medida, integramos este tipo de verificaciones automáticas en nuestros pipelines. La automatización de procesos de control de calidad, como la detección de enlaces rotos, se complementa con otras prácticas que ofrecemos: inteligencia artificial y agentes IA para optimizar flujos de trabajo, servicios cloud AWS y Azure para infraestructura escalable, ciberseguridad en auditorías de código, y servicios inteligencia de negocio con Power BI para convertir datos en decisiones. La combinación de estas capacidades permite a nuestros clientes lanzar proyectos robustos desde el primer día.

El verdadero valor de Linkinator no está solo en corregir enlaces, sino en cambiar la mentalidad del equipo: pasar de esperar que los usuarios reporten problemas a prevenirlos activamente. Configurar esta herramienta lleva menos de quince minutos, y el retorno de inversión en términos de SEO, confianza del usuario y eficiencia del desarrollo es inmediato. Si tu proyecto Next.js necesita una revisión profunda de su arquitectura técnica y de calidad, en Q2BSTUDIO ofrecemos consultoría y desarrollo que abarca desde el MVP hasta la puesta en producción con CI/CD sólido. Contáctanos para llevar tu sitio al siguiente nivel.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat