Kitesurf en Browser Run: el reemplazo de Chromium aún es parcial

Para probar Kitesurf en Cloudflare Browser Run, conserva primero una ejecución con Chromium como referencia y añade browser=kitesurf solo a la Quick Action o a la conexión CDP que quieras evaluar. El cambio de configuración es pequeño, pero el reemplazo sigue siendo parcial: Kitesurf está en beta y no reproduce todas las capacidades ni la fidelidad visual de Chromium.

Usa Quick Actions para operaciones independientes, como extraer HTML, generar un PDF o tomar una captura; elige una sesión controlada cuando necesites navegación programada, eventos o varios pasos. Kitesurf resulta adecuado para tareas breves, aisladas y verificables, mientras que Chromium debe seguir como referencia para vídeo, WebGL, autenticación prolongada y pruebas visuales exigentes.

1. Elige el modelo de ejecución antes que el motor

Browser Run ofrece dos niveles de control. Las Quick Actions resuelven tareas sin estado mediante una solicitud y no requieren desplegar código; las Browser Sessions permiten controlar el navegador con Puppeteer, Playwright, CDP o Stagehand. La documentación de Browser Run sitúa ambos modelos en los planes Workers Free y Paid.

• Quick Actions: convienen cuando cada entrada produce una salida independiente, como HTML, enlaces, datos estructurados, una captura o un PDF.
• Browser Sessions: son preferibles si el flujo abre varias páginas, espera eventos, modifica el DOM o conserva estado durante una secuencia.
• Chromium: sigue siendo la base adecuada cuando el resultado debe representar con fidelidad el comportamiento o los píxeles de un navegador completo.

No elijas Kitesurf únicamente porque tu cliente se conecte mediante CDP. El protocolo proporciona una interfaz de control común, pero no garantiza que dos motores admitan las mismas API web, ejecuten todos los comandos o produzcan el mismo renderizado.

2. Prueba reproducible con una Quick Action

La comprobación mínima necesita el identificador de la cuenta y un token de API válido para Browser Run. Empieza con una solicitud POST al endpoint /client/v4/accounts/ACCOUNT_ID/browser-run/screenshot, sin seleccionar otro motor, y envía la URL de prueba en el cuerpo JSON. Puedes sustituir screenshot por la acción que represente tu carga real, como contenido o PDF.

Conserva la primera salida y repite exactamente la misma entrada añadiendo ?browser=kitesurf. Las instrucciones oficiales de Kitesurf documentan ese selector para cualquier Quick Action y para el endpoint CDP; también identifican el producto como una beta gratuita sujeta a límites por cuenta.

1. Escoge una página representativa, con el JavaScript, las fuentes y los componentes que realmente consume tu proceso.
2. Ejecuta la acción con el motor predeterminado y guarda la salida esperada.
3. Repite la solicitud con Kitesurf, sin modificar la URL, los tiempos de espera ni los datos de entrada.
4. Compara el contenido que utiliza tu aplicación: valores, selectores, dimensiones, PDF o captura.
5. Activa Kitesurf solo para las entradas que superen esa comparación y conserva una ruta de retorno a Chromium.

Una respuesta satisfactoria no demuestra por sí sola que la página haya quedado completa. La ausencia de un elemento puede ser irrelevante para extraer un título, pero invalidar un PDF contractual o una captura destinada a revisar el diseño.

3. Conecta una sesión mediante CDP

Para un flujo de varios pasos, abre una conexión WebSocket a /client/v4/accounts/ACCOUNT_ID/browser-run/devtools/browser?browser=kitesurf y envía el token en el encabezado de autorización. La misma selección del motor funciona con clientes que se conectan al endpoint mediante CDP.

La matriz de compatibilidad debe interpretarse con estas reservas:

• CDP: es la interfaz directa de Kitesurf, pero el motor implementa un subconjunto del protocolo.
• Puppeteer: puede conectarse al endpoint CDP existente; debes validar cada comando, evento y API web que utilice el flujo.
• Playwright: puede conectarse mediante CDP, aunque esa conectividad no implica paridad con su ejecución sobre Chromium.
• Stagehand: Browser Run lo admite como método de sesión, pero la documentación de Kitesurf no establece una equivalencia completa para sus abstracciones. Mantén Chromium como referencia si el flujo depende de ellas.

Cierra explícitamente el navegador al finalizar, incluso si falla un paso. No diseñes Kitesurf como depósito de estado duradero: su caso de uso declarado son tareas efímeras y aisladas, no sesiones autenticadas largas que dependan de persistencia.

4. Comprueba la web real, no solo el protocolo

Kitesurf no es todavía la opción indicada para reproducir vídeo, renderizar WebGL, superar desafíos de bots que dependan de huellas TLS reales o sostener una sesión autenticada prolongada. Para esas cargas, el navegador predeterminado de Browser Run continúa basado en Chromium.

La conformidad con estándares tampoco basta para aprobar una migración. El análisis técnico de Cloudflare explica que Web Platform Tests mide conformidad, mientras que la compatibilidad con sitios reales requiere pruebas multietapa de Puppeteer y regresión visual frente a Chromium; la misma publicación confirma que Kitesurf todavía amplía su cobertura CDP y la fidelidad de capturas y PDF.

Prepara un conjunto pequeño que represente las dependencias reales del proceso: JavaScript, iframes, fuentes, SVG, descargas, selectores esenciales y autenticación si corresponde. Para extracción, compara valores y estructura; para navegación, valida cada transición; para resultados visuales, contrasta las capturas completas y no solo el código de respuesta.

5. Define la adopción y el retroceso por carga

Adopta Kitesurf cuando la tarea sea breve, aislada, repetible y su salida pueda validarse automáticamente. Un proceso que recibe una URL, extrae contenido estructurado y descarta el estado es un candidato razonable después de comprobar la compatibilidad del sitio.

Conserva Chromium para pruebas funcionales o visuales que representen un navegador completo, flujos autenticados prolongados y páginas dependientes de vídeo, WebGL o controles avanzados contra automatización. Una aplicación puede dirigir a Kitesurf las tareas compatibles y reservar Chromium para las que exijan mayor cobertura, sin imponer un único motor a todas las cargas.

El retroceso debe activarse ante un comando CDP no admitido, contenido esencial ausente, una diferencia visual fuera de tolerancia o la pérdida prematura de estado. De ese modo, Kitesurf funciona como una alternativa comprobada dentro de Browser Run, no como una sustitución general de Chromium.