Guía
Qué puede hacer tu IA
Leer la web (scraping)
web_scrape | URL → Markdown limpio (o html, texto, enlaces y datos embebidos JSON-LD/__NEXT_DATA__). Motor auto: HTTP y si hay muro o SPA, Chrome real. |
web_extraer | Esquema de selectores CSS → JSON (como un spider de Scrapy). Ej.: {"items":{"selector":".card","multiple":true,"campos":{"nombre":"h3","precio":{"selector":".precio","tipo":"numero"}}}} |
web_mapa | Descubre las URLs de un sitio (sitemaps, robots.txt y enlaces). |
web_crawl | Recorre hasta 100 páginas del mismo dominio con filtros por ruta y las devuelve en Markdown. |
web_buscar | Busca en la web y devuelve título, URL y extracto. |
Navegar e interactuar
navegador_abrir | Abre una URL y devuelve un snapshot con refs @e1, @e2… de los elementos interactivos. |
navegador_click / navegador_escribir / navegador_seleccionar / navegador_tecla | Actúan sobre refs o selectores y devuelven el nuevo snapshot. |
navegador_snapshot / navegador_leer / navegador_captura | Ver la página actual: árbol con refs, Markdown, o imagen (anotada con números). |
navegador_esperar / navegador_scroll / navegador_navegar / navegador_pestanas | Esperas, scroll, atrás/adelante/recargar y pestañas. |
navegador_eval / navegador_comando | JavaScript en la página y cualquier comando avanzado de agent-browser (cookies, storage, red, consola, vitals, a11y…). |
Capturas, PDF y video (evidencia)
navegador_captura | Pantallazo (visible, página completa, un elemento o anotado con números). Lo devuelve para que la IA lo vea y lo guarda en la galería con enlace. |
navegador_pdf | Guarda la página actual como PDF en la galería. |
video_iniciar / video_detener | Graba en video todo lo que el agente hace en la sesión. Al detener devuelve una hoja de contactos (fotogramas clave con hora) y el enlace al video. |
captura_ver | Abre una captura; de un video entrega N fotogramas o los segundos exactos pedidos, para analizarlos. |
capturas_listar / captura_eliminar | Busca en la galería (por tipo, nombre, nota o URL) y elimina elementos. |
Cuentas, sesiones y perfiles
navegador_login | Inicia sesión con un acceso guardado (usuario, contraseña y 2FA cifrados). La IA nunca ve la contraseña. |
sesiones_listar / navegador_cerrar | Sesiones con nombre: conservan cookies/login. Cierra para liberar RAM o borra sus datos. |
perfiles_listar / perfil_guardar | Cómo se presenta el navegador: UA, idioma, zona horaria, viewport, stealth, con ventana, movimiento humano, bloqueo de recursos. |
accesos_listar | Qué accesos hay disponibles (sin contraseñas). |
Ejemplos de pedidos
- «Lee https://ejemplo.cl/precios y dame una tabla con los planes y precios.»
- «Extrae nombre, precio y link de todos los productos de esta categoría como JSON.»
- «Entra con mi acceso proveedores y descarga el listado de órdenes pendientes.»
- «Haz un crawl de /blog/ del sitio y resume los últimos 10 artículos.»
- «Graba en video cómo completas el checkout y dime en qué paso falla.»
- «Saca un pantallazo de la página completa del competidor y guárdalo con la nota “precios noviembre”.»
- «Crea un perfil “sigiloso” con ventana y movimiento humano y úsalo para abrir este sitio con Cloudflare.»
Anti-bot: qué hacer si aparece un muro
- El perfil predeterminado ya trae stealth: pasa la mayoría de desafíos JS (Cloudflare «Just a moment»).
- Si persiste: perfil con Chrome con ventana + movimiento humano.
- DataDome, PerimeterX y Akamai miran la IP: agrega un proxy residencial del país del sitio al perfil.
- Turnstile / reCAPTCHA / hCaptcha: el administrador puede configurar CapSolver o 2Captcha en el servidor.