El SEO para JavaScript es el trabajo que garantiza que los buscadores rastreen, ejecuten e indexen correctamente los sitios que generan su contenido o sus enlaces con JavaScript. En un sitio creado con frameworks como React, Vue o Angular, todo puede verse perfecto en su navegador; pero Googlebot procesa la misma página en otras condiciones y en dos fases. Por eso, "en mi equipo funciona" no basta. En este artículo abordamos cómo procesa Google el JavaScript, qué riesgos implica cada arquitectura y qué debe revisar en la práctica.
¿Qué es el SEO para JavaScript?
En una página web clásica, el servidor envía el contenido directamente como HTML. En los sitios con mucho JavaScript, en cambio, el servidor suele enviar un esqueleto vacío y un paquete de scripts; el contenido real aparece en el navegador, después de ejecutar el script. Desde el punto de vista del buscador, surge la pregunta: ¿el bot puede ejecutar el script y ver el contenido final, cuándo y con qué fiabilidad?
Hoy Google puede ejecutar JavaScript; el problema es que esa capacidad no es incondicional ni inmediata. Las siguientes secciones muestran dónde se produce la diferencia.
¿Cómo procesa Google el JavaScript?
En la documentación de Google, el proceso se describe en tres fases:
- Rastreo (crawling): Googlebot solicita la dirección, recibe la respuesta HTML y comprueba las reglas de
robots.txt. - Procesamiento (rendering): la página se ejecuta con una versión actualizada de Chromium y se ve el contenido final generado por JavaScript. Esta fase entra en una cola, así que puede no ser inmediata.
- Indexación: el texto y los enlaces de la página procesada se añaden al índice; los nuevos enlaces se incorporan a la cola de rastreo.
Consecuencia práctica: lo que está en el HTML inicial se ve antes y con mayor fiabilidad. El contenido añadido solo con JavaScript espera en la cola de procesamiento y conlleva un riesgo adicional: si el script produce un error, agota el tiempo de espera o está bloqueado, el contenido puede no llegar a verse nunca.
Importante: los buscadores distintos de Google y algunos bots de inteligencia artificial pueden no ejecutar JavaScript tan bien como Google. Servir el contenido crítico en el HTML inicial es también la vía más segura para esos bots.
CSR, SSR y generación estática
| Método | ¿Cómo funciona? | Desde el punto de vista del SEO |
|---|---|---|
| CSR (renderizado en el cliente) | El navegador recibe el esqueleto vacío y el script genera el contenido | La opción más arriesgada; el contenido depende de la fase de procesamiento |
| SSR (renderizado en el servidor) | El servidor genera el HTML completo en cada petición y después el script toma el control en el navegador | El contenido llega en la respuesta inicial; una opción sólida para la mayoría de sitios de contenido |
| SSG (generación estática) | Las páginas se generan como HTML antes de la publicación | Rápido y fiable; ideal para contenido que no cambia con frecuencia |
| Híbrido | Combinación de SSR, SSG o CSR según la página | Enfoque habitual en los frameworks modernos; las páginas críticas deben usar SSR o SSG |
Google ya no recomienda como solución permanente el "renderizado dinámico" (servir HTML distinto a los bots), que antes se propuso; lo describe como una solución temporal. Si empieza un proyecto nuevo, elegir SSR o SSG también reduce la carga de mantenimiento. Consulte en la documentación de su framework (por ejemplo, Next.js, Nuxt o Astro) cómo ofrece estas opciones.
Problemas de SEO con JavaScript más frecuentes
- Contenido crítico que llega solo con JS: si el título, la descripción del producto, el precio o el texto principal no están en el HTML inicial, hay riesgo.
- Archivos JS/CSS bloqueados por robots.txt: el bot no puede procesar bien la página. No bloquee los scripts importantes; para aprender estas reglas, consulte nuestra guía de robots.txt.
- Navegación que no son enlaces reales: los elementos que funcionan solo con un evento de clic no son enlaces rastreables.
- Contenido que se carga al desplazarse o al hacer clic: Googlebot no se desplaza ni hace clic en la página; el contenido que está tras el botón "mostrar más" puede no verse.
- Direcciones con almohadilla (#): el identificador de fragmento (
#/urunler) no se considera una página distinta. - Contenido que se carga tarde o con errores: respuestas de API muy lentas, tiempos de espera o errores de script dejan el contenido vacío durante el procesamiento.
- Gestión incorrecta de las etiquetas meta: title, description y canonical que no se generan correctamente para cada página.
Enlaces y estructura de URL
Para descubrir enlaces, Google se fija en el atributo href del elemento <a>. Los dos ejemplos
siguientes hacen lo mismo visualmente, pero solo el primero es rastreable:
<!-- Rastreable -->
<a href="https://hitbot.org/urunler/ayakkabi">Zapatos</a>
<!-- No rastreable: sin href, solo un detector de eventos -->
<span onclick="git('/urunler/ayakkabi')">Zapatos</span>
En las aplicaciones de una sola página (SPA), para la transición entre páginas use la API de historial del navegador (History API) y cree para cada vista una dirección real y única. Cada dirección debe mostrar el mismo contenido también cuando se abre directamente (al recargar o desde un enlace compartido). Para la lógica general de los enlaces internos, puede consultar nuestro artículo sobre la estrategia de enlazado interno.
Códigos de estado, noindex y canonical
Este es el punto que más se pasa por alto en las aplicaciones JavaScript:
- Páginas de error: en una SPA, una dirección inexistente puede mostrar el texto "Página no encontrada" y responder con HTTP 200. Eso es un soft 404. Haga que el servidor devuelva un 404 real o añada noindex en la vista de error. Para más detalles, consulte nuestro artículo sobre errores 404 y SEO.
- Noindex y JavaScript: si el HTML original contiene
noindex, Google puede omitir el procesamiento de la página; en ese caso, intentar quitar el noindex con JavaScript no sirve de nada. En las páginas que quiera indexar, no debe haber noindex en el HTML inicial. - Canonical: si es posible, escríbalo en el HTML inicial. Puede añadirse con JavaScript, pero dos canonical contradictorios (uno en el HTML y otro en el script) confunden a Google. Para la lógica del canonical, consulte nuestra guía de canonical.
- Redirecciones: prefiera la redirección HTTP del lado del servidor a la redirección con JavaScript; las diferencias las explicamos en nuestro artículo sobre 301 y 302.
Comprobar lo que ve Google
- Compare el código fuente: compare en el navegador "Ver código fuente de la página" (HTML sin procesar) con la vista Elements (DOM procesado) de las herramientas para desarrolladores. Si el texto principal solo aparece en la segunda, el contenido depende de JS.
- Inspección de URL: en Search Console, inspeccione la dirección, pulse "Probar URL en directo" y revise, con "Ver la página probada", el HTML procesado por Google y la captura de pantalla.
- Prueba sin JavaScript: desactive JavaScript en el navegador y abra la página. Si no se ve nada, el bot también la verá vacía en la primera fase.
- Recursos no cargados: en la inspección de URL, compruebe si hay scripts o llamadas a API bloqueados o que no se cargaron.
- Comprobación del índice: busque entre comillas en
site:sudominio.comuna frase de la página y compruebe si el contenido está indexado.
Si las páginas no se indexan, puede acotar la causa comparando los estados de Search Console con nuestra guía de problemas de indexación.
Lista de comprobación antes de publicar
Si trabaja con un equipo de desarrollo, marque cada uno de los siguientes puntos como "sí / no" antes de cada publicación importante:
- ¿El título, el texto principal y la imagen principal de la página están en la respuesta HTML inicial?
- ¿Cada página tiene un title, una description y una etiqueta canonical únicos que apuntan a su propia dirección?
- ¿Los enlaces del menú y de la paginación son
<a href>reales? - ¿Las direcciones inexistentes devuelven un 404 real?
- ¿Los archivos JS y CSS importantes no están bloqueados por robots.txt?
- ¿La página muestra al menos el contenido principal con JavaScript desactivado?
- Si hay un error de script o la API va lenta, ¿la página queda vacía o muestra un contenido de reserva razonable?
- ¿Al añadir una nueva vista (ruta), entra en el mapa del sitio?
Esta lista sirve tanto para un sitio nuevo como para la renovación del diseño o de la infraestructura de un sitio existente. Si la persona responsable del SEO la comparte al inicio del desarrollo, el coste de corrección es mucho menor, porque cambiar el método de renderizado una vez tomada la decisión arquitectónica es lo más caro.
Rendimiento y JavaScript
Los paquetes de JavaScript pesados son una carga no solo para el bot, sino también para el usuario. Los scripts grandes pueden empeorar el retardo de interacción (INP) y el tiempo de carga (LCP). Dividir el código (code splitting), eliminar el código que no se usa, limitar los scripts de terceros y aplazar los scripts no críticos son pasos básicos. Para las métricas, consulte nuestra guía de Core Web Vitals; para trabajos generales de velocidad, puede revisar los métodos para aumentar la velocidad de la página. Para la explicación oficial de Google, consulte el documento sobre los fundamentos del SEO para JavaScript.
Preguntas frecuentes
¿Google entiende completamente JavaScript?
En gran medida, sí, lo ejecuta; pero el procesamiento implica una cola adicional y un retraso. Servir el contenido crítico en el HTML inicial es la vía más segura.
¿React o Vue son malos para el SEO?
No. El problema no es el framework, sino la forma en que se entrega el contenido. Con SSR o generación estática se puede hacer un SEO sólido con estos frameworks.
¿Debo usar renderizado dinámico?
Google no lo recomienda como solución a largo plazo. En proyectos nuevos, SSR o SSG es la opción más adecuada.
¿El lazy loading perjudica al SEO?
No, si se hace bien. Use la carga nativa del navegador y no exija interacción del usuario para que aparezca el contenido; Googlebot no hace clic ni se desplaza.
Conclusión
La esencia del SEO para JavaScript es que todo lo que quiera que Google vea esté accesible en el momento en que el bot solicite la página. Entregue el contenido en el HTML inicial, use enlaces y direcciones reales, devuelva los códigos de estado correctos, no bloquee los scripts importantes y verifique periódicamente la página procesada con la inspección de URL. Si incorpora estos hábitos a su lista de control de SEO técnico, la mayoría de los problemas se detectarán antes de publicar.