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 read • Q2BSTUDIO Team

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.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat