Repolode
keon

keon/browser-control

Una pequeña CLI en Rust que controla un navegador Chrome real mediante Chrome DevTools Protocol, diseñada para agentes de programación que trabajan desde la shell.

Estrellas
3,152
Forks
210
Issues abiertos
1
Último commit
hace 2 meses

¿Qué es?

browser-control es una herramienta de línea de comandos escrita en Rust que expone el navegador como un conjunto de subcomandos de shell. Puede iniciar o conectarse a una instancia local de Chrome, tomar capturas de páginas que asignan referencias estables a los elementos, como @e1 y @e2, y luego hacer clic, rellenar campos, escribir, desplazarse o subir archivos usando esas referencias. También acepta selectores CSS y coordenadas x,y como objetivos.

La herramienta está pensada para agentes de programación que ya ejecutan comandos de shell. Las operaciones que no se pueden expresar con los comandos de alto nivel están disponibles mediante los comandos raw eval y cdp. Un daemon en segundo plano conserva en memoria el historial de eventos, red y consola, y los comandos que fallan guardan archivos de trazas compactos en un directorio del espacio de trabajo para ayudar a diagnosticar problemas.

Además de Chrome local, puede iniciar y detener sesiones remotas en Browser Use, Steel, Hyperbrowser y Browserbase, así como en cualquier otro proveedor compatible con CDP configurado mediante variables de entorno. Se puede instalar con cargo install, mediante binarios precompilados o compilándolo desde el código fuente.

Funciones clave

  • 01Las capturas devuelven referencias estables a los elementos, que se pueden usar directamente en acciones como hacer clic o rellenar campos.
  • 02Cada funcionalidad está disponible como subcomando de shell que imprime texto compacto o JSON.
  • 03El acceso directo a CDP mediante los comandos eval y cdp permite realizar operaciones que no están incluidas en las funciones auxiliares.
  • 04Un daemon en segundo plano conserva los eventos, las solicitudes de red y los mensajes de consola recientes.
  • 05Los comandos que fallan guardan trazas de diagnóstico en el directorio del espacio de trabajo.
  • 06Compatible con Chrome local y proveedores de navegadores en la nube mediante los mismos comandos.

Casos de uso

  • Permitir que un agente de programación inspeccione e interactúe con una página web desde la shell.
  • Automatizar pasos repetibles en el navegador, como iniciar sesión o rellenar formularios, dentro de una canalización de shell.
  • Ejecutar desde la línea de comandos una sesión de navegador en un proveedor en la nube como Browser Use o Steel.
  • Depurar un flujo de automatización del navegador revisando las trazas de errores guardadas.

Inicio rápido

  1. 1

    Instala la CLI desde crates.io

    cargo install browser-control-cli
  2. 2

    Crea el espacio de trabajo e inicia Chrome en una página de ejemplo

    browser-control init && browser-control launch https://example.com
  3. 3

    Toma una instantánea de la página para enumerar las referencias de los elementos interactivos

    browser-control snapshot

Antes de usarlo

  • Necesitas una compilación local de Chrome o Chromium, o una clave de API de un proveedor de nube de pago para las sesiones remotas.
  • El crate se llama browser-control-cli porque el nombre más corto ya estaba ocupado.

En colecciones

Temas

Preguntas frecuentes

¿Qué es browser-control?
Una pequeña CLI en Rust que controla un navegador Chrome real mediante Chrome DevTools Protocol, diseñada para agentes de programación que trabajan desde la shell. browser-control es una herramienta de línea de comandos escrita en Rust que expone el navegador como un conjunto de subcomandos de shell. Puede iniciar o conectarse a una instancia local de Chrome, tomar capturas de páginas que asignan referencias estables a los elementos, como @e1 y @e2, y luego hacer clic, rellenar campos, escribir, desplazarse o subir archivos usando esas referencias. También acepta selectores CSS y coordenadas x,y como objetivos.
¿browser-control es gratuito? ¿Qué licencia tiene?
browser-control es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿browser-control sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de browser-control fue el 27 ago 2026.
¿Para qué puedo usar browser-control?
Permitir que un agente de programación inspeccione e interactúe con una página web desde la shell. Automatizar pasos repetibles en el navegador, como iniciar sesión o rellenar formularios, dentro de una canalización de shell. Ejecutar desde la línea de comandos una sesión de navegador en un proveedor en la nube como Browser Use o Steel. Depurar un flujo de automatización del navegador revisando las trazas de errores guardadas.
¿Cómo se instala browser-control?
Instala la CLI desde crates.io: cargo install browser-control-cli Crea el espacio de trabajo e inicia Chrome en una página de ejemplo: browser-control init && browser-control launch https://example.com Toma una instantánea de la página para enumerar las referencias de los elementos interactivos: browser-control snapshot
¿Dónde consigo browser-control?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/keon/browser-control

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados