Guía
¿Cómo hacer SEO en un sitio con JavaScript para que Google lo lea?
Laurank es una empresa de AEO en español: ayudamos a que ChatGPT, Gemini, Perplexity y los AI Overviews de Google citen a tu marca, empezando por entender por qué hoy no lo hacen. Conoce a Laurank.
Puntos clave
- Google procesa JavaScript en tres fases: rastreo, renderizado e indexación. Una página puede esperar en la cola entre el rastreo y el renderizado.
- Los enlaces deben ser elementos <a> con atributo href. Las rutas con # (fragmentos) no son fiables: usa la History API.
- Google no interactúa con la página: el contenido que solo aparece tras un clic, un desplazamiento o un permiso no está garantizado en el índice.
- Google describe el renderizado en el servidor, el estático o la hidratación como la solución recomendada; el renderizado dinámico quedó como parche.
- Comprueba siempre el HTML renderizado con la Inspección de URLs de Search Console o la Prueba de resultados enriquecidos, y el HTML inicial con curl.
- Los asistentes de IA son otro caso: sus páginas oficiales revisadas no documentan si ejecutan JavaScript, así que el texto clave debe ir en el HTML inicial.
¿Google puede leer un sitio hecho en JavaScript?
Sí: Google ejecuta JavaScript con una versión actualizada de Chromium y puede indexar el contenido que ese código genera, pero con condiciones. Su documentación, actualizada por última vez en marzo de 2026, dice que hay “algunas cosas que puedes optimizar”. Las condiciones se resumen así: la página no debe estar bloqueada, los enlaces deben ser enlaces reales, el contenido debe aparecer sin que nadie haga clic y el servidor debe responder con códigos de estado correctos.
Por eso la pregunta útil no es “¿Google lee JavaScript?”, sino “¿qué parte de mi contenido depende de algo que Google no hace?”. Un sitio en React, Vue o Angular puede estar perfectamente indexado, y otro igual de moderno puede tener páginas internas que nunca aparecen. La diferencia casi siempre está en los detalles de esta guía.
Esta pieza trata solo lo que cambia cuando el contenido lo genera JavaScript. Para el rastreo general (qué es un crawler, presupuesto de rastreo, robots.txt) lee qué es un crawler, y para el concepto de índice, qué es la indexación.
¿Cómo procesa Google una página con JavaScript?
Google procesa una aplicación en JavaScript en tres fases: rastreo, renderizado e indexación, y entre las dos primeras la página puede esperar en una cola. La documentación de Google (Search Central, consultada el 23 de octubre de 2026) describe el flujo así.
| Fase | Qué hace Googlebot | Qué significa para tu sitio |
|---|---|---|
| Rastreo | Toma la URL de la cola, comprueba robots.txt y pide el HTML por HTTP. Si la URL está bloqueada, no hace la petición | Si bloqueas archivos JavaScript o páginas en robots.txt, Google no renderiza ese JavaScript |
| Extracción de enlaces | Lee el atributo href de los enlaces del HTML recibido y añade las URL a la cola |
Los enlaces que solo existen tras ejecutar código se descubren más tarde, en el renderizado |
| Cola de renderizado | Las páginas con respuesta 200 esperan su turno; la espera puede ser de unos segundos o más | El texto que solo existe tras ejecutar JavaScript se incorpora más tarde que el que ya está en el HTML |
| Renderizado | Un Chromium sin interfaz ejecuta el JavaScript y genera el HTML final | Lo que no aparece en ese HTML renderizado no se indexa |
| Indexación | Google usa el HTML renderizado para indexar y busca otra vez enlaces en él | El índice refleja el HTML renderizado, no el código fuente que ves con “ver código fuente” |
Dos matices que Google documenta. Primero, envía a la cola de renderizado todas las páginas con respuesta 200, tengan o no JavaScript; si la respuesta no es 200 (por ejemplo, un 404), el renderizado puede omitirse. Segundo, si la página lleva una etiqueta noindex en el HTML original, Google puede omitir el renderizado, de modo que quitarla con JavaScript puede no funcionar.
Esto último provoca un error frecuente: una plantilla sale con noindex en el HTML inicial “mientras se carga” y el código la retira después. Google avisa de que, si quieres la página indexada, no pongas noindex en el código original.
¿Por qué mi sitio en JavaScript no aparece en Google?
Casi siempre es una de seis causas: enlaces sin href, rutas con #, contenido que exige una interacción, recursos bloqueados, errores de JavaScript o respuestas 200 en páginas que no existen. Esta tabla asocia cada síntoma con su causa más probable y su arreglo, según la guía de problemas de JavaScript de Google.
| Si ves esto | Causa probable | Qué hacer |
|---|---|---|
| Solo la página de inicio está indexada; las internas no | Menú con <button> o <div onclick> en lugar de <a href> |
Usa enlaces <a href="/ruta"> reales |
Las URL del sitio tienen #/productos |
Rutas con fragmentos | Pasa a rutas con la History API |
| Las páginas existen pero Google ve el cuerpo vacío | Recursos JavaScript bloqueados en robots.txt, errores al ejecutar o API que Googlebot no puede usar | Desbloquea los archivos; revisa errores en la Inspección de URLs |
| Falta el texto de pestañas, “ver más” o listas largas | El contenido se carga solo tras un clic o un desplazamiento | Que cargue sin interacción o tenga su propia URL |
| Aparecen páginas de error indexadas | La aplicación responde 200 en páginas inexistentes | Devuelve un 404 real o añade noindex en esas vistas |
| La ficha cambia entre visitas | El contenido depende de cookies o almacenamiento local | No dependas de datos persistentes: Google los borra entre cargas |
Si tu caso no encaja, el diagnóstico general de por qué Google no indexa tu página cubre las causas que no tienen que ver con JavaScript, como el noindex explícito, la calidad o los bloqueos de servidor.
¿Cómo deben ser los enlaces y las URL de una aplicación de una sola página?
Los enlaces deben ser elementos <a> con atributo href, y cada vista debe tener una URL propia creada con la History API, no con fragmentos (#). Google lo dice así: solo puede descubrir tus enlaces si son elementos <a> con atributo href. Para las aplicaciones de una sola página con enrutamiento en el cliente, indica usar la History API.
Sobre los fragmentos, la guía de problemas de JavaScript añade que el esquema de rastreo AJAX está obsoleto desde 2015, así que no puedes confiar en que https://ejemplo.com/#/productos funcione con Googlebot. Que el enlace se inserte con JavaScript no es un problema: Google lo acepta mientras cumpla las prácticas de enlaces rastreables.
| Patrón | ¿Lo puede seguir Google? |
|---|---|
<a href="/productos">Productos</a> |
Sí |
<a href="#/productos">Productos</a> |
No de forma fiable |
<span onclick="irA('/productos')">Productos</span> |
No es un enlace con href |
<a href="/productos" onclick="..."> con enrutador del cliente |
Sí: el href real es el que cuenta |
En React, Vue y Angular, el enrutador suele ofrecer un modo con History API y otro con hash. Revisa en la documentación de tu enrutador cuál usa tu proyecto, y mira el HTML renderizado para confirmar que los enlaces tienen href.
¿Qué pasa con el contenido que solo aparece al hacer clic o desplazarse?
Google no interactúa con la página, así que el contenido que exige un clic, un desplazamiento o un permiso del usuario no está garantizado en el índice. La guía de contenido con carga diferida (lazy loading) lo explica: los métodos recomendados, como el atributo nativo de imágenes e iframes o la API IntersectionObserver, no dependen de acciones del usuario, y eso es importante porque “Google Search no interactúa con tu página”.
Para el desplazamiento infinito, Google pide paginación con URL propias: cada fragmento de contenido debe tener una URL única y persistente, con números de página absolutos (por ejemplo ?page=12) y no relativos como ?date=yesterday. Las páginas deben enlazarse entre sí en secuencia y la URL visible debe actualizarse con la History API cuando el usuario se desplaza.
Otros comportamientos que Google documenta como límites:
- Googlebot rechaza las solicitudes de permisos (cámara, ubicación). Si el contenido exige aceptarlas, no lo verá.
- No conserva estado entre cargas: almacenamiento local, de sesión y cookies se borran.
- Solo usa conexiones HTTP; no admite WebSockets ni WebRTC. Si tu contenido llega por ahí, necesita una alternativa HTTP.
- Si usas un muro de pago en JavaScript, el contenido completo no debería estar en la respuesta del servidor para ocultarlo después.
Las pestañas y los acordeones merecen una prueba. Criterio de Laurank: distingue el texto que ya viene en el HTML y solo se oculta con estilos del que se descarga al hacer clic; el segundo es el que arriesgas. La Inspección de URLs te dice cuál es el tuyo.
¿Qué opción de renderizado conviene: SSR, SSG o prerender?
Google recomienda renderizar en el servidor (SSR), renderizado estático (SSG) o hidratación; el renderizado dinámico es un parche, y el renderizado solo en el cliente es válido únicamente cuando todo lo demás está bien resuelto. En la guía básica de Google se lee que “el renderizado en el servidor o el prerenderizado sigue siendo una gran idea” porque acelera el sitio para usuarios y rastreadores y porque no todos los bots pueden ejecutar JavaScript.
| Opción | Cuándo se genera el HTML | Cuándo conviene | Límite |
|---|---|---|---|
| Solo en el cliente (CSR) | En el navegador, tras descargar y ejecutar el JavaScript | Paneles internos, aplicaciones tras inicio de sesión | Nuxt advierte que indexar y actualizar contenido es más lento que con HTML renderizado en el servidor |
| Renderizado en el servidor (SSR) | En el servidor, en cada solicitud o con caché | Contenido que cambia (catálogo, precios, noticias) | Requiere un servidor activo |
| Estático (SSG) o prerender | Al construir el sitio, un archivo HTML por ruta | Páginas de servicio, blog, fichas que cambian poco | Hay que reconstruir al cambiar el contenido |
| Renderizado dinámico | Un servidor aparte entrega HTML a los bots y JavaScript a las personas | Solo como solución temporal | Google lo califica de parche, no recomendado a largo plazo |
Criterio de Laurank: para una pyme con páginas de servicio, blog y fichas, el renderizado estático o en el servidor casi siempre alcanza, y deja el HTML completo en la primera respuesta. El cliente puro lo reservaríamos para lo que no necesita indexarse.
Sobre el renderizado dinámico, la documentación de Google dice que lo recomendable es SSR, renderizado estático o hidratación, y que el dinámico “creaba complejidad y requisitos de recursos adicionales”. Si tu proveedor te ofrece un “prerender para bots”, pregunta si el sitio podría generarse así de origen.
¿Cómo lo resuelven Next.js y Nuxt?
Ambos entregan HTML ya renderizado por defecto, sin que tengas que configurarlo; el riesgo aparece cuando lo desactivas o mueves todo a componentes de cliente. Estas son las descripciones de su propia documentación (consultada el 23 de octubre de 2026).
- Next.js (React). En su documentación, las páginas y los diseños son componentes de servidor por defecto, y el servidor usa el resultado para prerenderizar HTML. Los componentes de cliente se marcan con
"use client"y sirven para la interactividad. También ofrece una exportación estática (output: 'export') que genera un archivo HTML por ruta. - Nuxt (Vue). Usa renderizado universal por defecto: ejecuta el código Vue en el servidor y devuelve una página HTML completa, que luego el navegador “hidrata”. Nuxt afirma que así los rastreadores pueden indexar el contenido sin esfuerzo adicional, y que
ssr: falselo convierte en renderizado solo en el cliente. - Angular. No tomamos una afirmación de su documentación para esta guía. Si usas Angular, confirma en su documentación oficial cómo habilitar el renderizado en el servidor y verifica el resultado con las pruebas de la sección siguiente.
- Constructores sin código. Revisa en su ayuda si publican HTML renderizado o una aplicación de cliente. Si no lo dicen, la prueba con
curllo resuelve en un minuto.
Ten presente la diferencia entre “el framework puede renderizar en el servidor” y “mi sitio lo hace”. Un proyecto Next.js que llama a los datos desde componentes de cliente puede entregar un HTML casi vacío. La prueba es el HTML que recibes, no el nombre de la tecnología.
¿Cómo compruebo el HTML renderizado de mi página?
Haz dos comprobaciones: el HTML inicial con curl (lo que ve un bot que no ejecuta JavaScript) y el HTML renderizado con la Inspección de URLs de Search Console (lo que ve Google). La diferencia entre ambos te dice cuánto de tu contenido depende de JavaScript.
- Descarga el HTML inicial. Ejecuta
curl -s https://tudominio.com/tu-pagina | grep -c "una frase exacta de tu página". Un resultado0significa que esa frase no viene en la respuesta del servidor. - Abre la Inspección de URLs. En Search Console, pega la URL. Google indica que con esta herramienta o con la Prueba de resultados enriquecidos puedes ver los recursos cargados, la salida de la consola de JavaScript, las excepciones y el DOM renderizado.
- Pide una prueba en vivo y mira el HTML renderizado. Busca ahí tu frase, tus enlaces con
hrefy tus títulos. Si la frase aparece aquí pero no en el paso 1, tu contenido depende del renderizado de Google. - Revisa los recursos y errores. Si falta contenido, mira si hay archivos bloqueados o excepciones de JavaScript en el detalle de la prueba.
- Repite en una muestra de plantillas. Una página de inicio, una de servicio, una ficha y un artículo bastan. Los problemas suelen repetirse por plantilla, no por página.
- Vigila el informe de estadísticas de rastreo. Google lo recomienda para seguir la actividad de Googlebot y de su servicio de renderizado en tu sitio, porque los análisis del lado del cliente pueden no reflejarla con exactitud.
Ejemplo ilustrativo (datos ficticios): una tienda de repuestos en Bogotá tiene su catálogo en React. El paso 1 devuelve 0 coincidencias para la descripción del producto, pero el paso 3 la muestra en el HTML renderizado. Conclusión: Google puede ver la descripción, aunque llegue tarde a la cola; un bot que no ejecute JavaScript, no. Si además el menú de categorías usa <button>, el hallazgo más urgente es ese, porque afecta al descubrimiento de todas las fichas.
Esta comprobación mide el acceso técnico y no garantiza posiciones ni citas. Para el resto de las pruebas de acceso de los bots de IA, ve a cómo saber si tu sitio es legible para la IA.
¿Qué pasa con los errores 404 y las etiquetas en una aplicación de una sola página?
Una aplicación que responde 200 en una página inexistente genera “404 blandos”; Google propone redirigir a una URL que devuelva un 404 real o añadir noindex en la vista de error. Es el tipo de fallo que una aplicación de cliente produce con más facilidad, porque el enrutador decide en el navegador y el servidor responde 200 a todo.
Las dos soluciones que documenta Google son una redirección con JavaScript a una URL que el servidor responda con 404 (por ejemplo /no-encontrado) o inyectar <meta name="robots" content="noindex"> en las vistas de error. Con renderizado en el servidor el problema desaparece, porque el servidor puede enviar el código de estado correcto. Para el concepto y las consecuencias, consulta el error 404.
Con las etiquetas pasa algo parecido. Google permite fijar el título, la meta descripción y el rel="canonical" con JavaScript, pero recomienda poner el canonical en el HTML y, si usas JavaScript, que coincida con el del HTML original y que sea el único de la página. Los detalles de esa etiqueta están en qué es la etiqueta canonical.
¿Y los bots de IA como los de ChatGPT, Perplexity o Claude?
No se puede dar por hecho que ejecuten JavaScript, porque las páginas oficiales revisadas no lo documentan. Google sí lo documenta para su buscador, y aun así recomienda el renderizado en el servidor porque “no todos los bots pueden ejecutar JavaScript”. Lo que Google dice de su propia Búsqueda no se puede trasladar a los asistentes de otras empresas.
La consecuencia práctica es de prudencia, no de dato: criterio de Laurank, pon en el HTML inicial lo que quieres que se lea y se cite. Qué bots existen y cómo identificarlos está en bots de IA que rastrean tu sitio, y la prueba de acceso, en cómo saber si tu sitio es legible para la IA.
¿Qué errores comunes debo evitar?
Los errores más repetidos son confiar en lo que se ve en el navegador, bloquear recursos y cambiar cosas críticas solo con JavaScript. Esta lista se deriva de la documentación de Google citada arriba.
- Probar el sitio solo en tu navegador, que ejecuta todo, en lugar de en la Inspección de URLs.
- Bloquear en robots.txt carpetas con archivos
.jso.css: Google no renderiza JavaScript de archivos bloqueados. - Usar
noindexen el HTML inicial y retirarlo con JavaScript. - Dejar el modo hash (
#/) del enrutador. - Cargar contenido clave solo al hacer clic o desplazarse, sin URL propia.
- Confiar en el almacenamiento local o las cookies para mostrar contenido: Googlebot las borra entre cargas.
- Cambiar el nombre de los archivos sin huella de contenido: Google guarda en caché con intensidad y su servicio de renderizado puede ignorar las cabeceras de caché y usar recursos viejos. Nombrarlos con una huella (como
main.2bb85551.js) lo evita. - Dejar el contenido en un componente web que no usa
<slot>: Google solo ve lo que aparece en el HTML renderizado.
Si además tu sitio tarda en cargar por el peso del JavaScript, eso es otro tema, el de la experiencia de página: está en Core Web Vitals. Para ordenar todo esto dentro de una revisión completa, usa la auditoría SEO.
¿Cuándo conviene pedir ayuda externa?
Conviene cuando ya aplicaste las comprobaciones y sigues sin saber por qué ni Google ni los asistentes de IA muestran tu marca. Un problema de renderizado es una causa posible, no la única: también cuentan las preguntas sin responder, la competencia ya instalada o que la marca no se reconozca.
El diagnóstico de Laurank revisa, entre otras causas, si los bots pueden leer tu sitio. Si quieres que lo miremos, escríbenos por WhatsApp (+1 415 202 4369) con el nombre de tu marca y tu sector. Los resultados dependen de tu sector y de tu competencia, y no prometemos posiciones ni citas.
Preguntas frecuentes
¿Google indexa los sitios hechos en React, Angular o Vue?
Sí, puede hacerlo, porque Google ejecuta JavaScript con una versión actualizada de Chromium. El resultado depende de la implementación: enlaces con href, contenido visible sin interacción, páginas no bloqueadas en robots.txt y códigos de estado correctos. Verifica cada plantilla con la Inspección de URLs.
¿Hay que usar renderizado del lado del servidor para posicionar?
No es obligatorio, pero Google lo recomienda. Su guía dice que el renderizado en el servidor o el prerenderizado sigue siendo una gran idea porque hace el sitio más rápido para usuarios y rastreadores, y porque no todos los bots pueden ejecutar JavaScript. Un sitio renderizado solo en el cliente puede indexarse si todo lo anterior está bien.
¿Cuánto tarda Google en renderizar mi página con JavaScript?
Google no da una cifra. Dice que la página puede quedar en la cola de renderizado unos segundos, pero que puede tardar más, según los recursos disponibles. No se puede fijar ni acelerar con una etiqueta; lo que sí controlas es que el contenido esté ya en el HTML inicial.
¿Puedo usar # en las URLs de mi aplicación de una sola página?
No es recomendable. Google indica que el esquema de rastreo AJAX está obsoleto desde 2015 y que no se puede confiar en que los fragmentos de URL funcionen con Googlebot. Usa la History API para que cada vista tenga una URL real, como /productos.
¿El renderizado dinámico sigue siendo una opción?
Google lo describe como un parche y no como una solución a largo plazo, porque añade complejidad y consume recursos. Recomienda renderizado en el servidor, renderizado estático o hidratación.
¿Los bots de ChatGPT, Perplexity o Claude ejecutan JavaScript?
Las páginas oficiales de sus bots que revisamos no lo documentan, así que no se puede afirmar ni negar. La precaución razonable es que el texto importante esté en el HTML que entrega el servidor.
Fuentes
- Google Search Central — Understand the JavaScript SEO basics
- Google Search Central — Fix Search-related JavaScript problems
- Google Search Central — Fix lazy-loaded content
- Google Search Central — Dynamic rendering as a workaround
- Next.js — Server and Client Components
- Next.js — Static exports
- Nuxt — Rendering modes
¿Quieres que la IA cite a tu marca?
Cuéntanos tu caso por WhatsApp y te decimos por dónde empezar.
Escríbenos por WhatsAppArtículos relacionados
¿Qué es la indexación en Google y qué significa estar indexado?
La indexación es la fase en la que Google procesa el contenido de una página que ya encontró y lo guarda en su índice, una gran base de datos. Una página indexada puede aparecer en los resultados de búsqueda, pero Google no garantiza que lo haga ni en qué posición.
¿Qué es la etiqueta canonical y cuándo usarla?
La etiqueta canonical es un elemento link rel="canonical" en el head de una página que indica a Google cuál es la URL preferida cuando el mismo contenido está en varias direcciones. Es una sugerencia, no una regla: Google puede elegir otra. Se combina con redirecciones y sitemap, y se comprueba en Search Console.
¿Qué es el error 404, afecta al SEO y cómo se soluciona?
El error 404 es el código HTTP con que un servidor indica que no encontró la página pedida. Según Google, que algunas URLs devuelvan 404 no te perjudica por sí solo. Corrige los 404 de páginas que te importan: redirige con 301 si se movieron, restaura si fue un error, o deja el 404 si ya no existe.