lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio claude-codecodexhermesbrowser

BrowserSkill: conecta un agente a una ventana de navegador

Trabaja con tus sesiones de Chrome o Edge desde una ventana visible para el agente. Revisa páginas, formularios y evidencias sin perder el control del recorrido.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: sigue la instalación oficial

Comprueba que usas una plataforma admitida (macOS Intel/Apple Silicon, Linux x64/ARM64 o Windows x64) y Chrome o Edge con Chromium ≥125. Esta ruta es local, con agente y navegador en el mismo equipo. Lee AGENT_INSTALL.md y prepara la CLI y la extensión para tu sistema. Revisa el script oficial antes de ejecutarlo. Para macOS/Linux, con curl y un shell disponibles, el instalador oficial se ejecuta así:

curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
export PATH="${BSK_INSTALL_DIR:-$HOME/.local/bin}:$PATH"

Instala la extensión desde Chrome Web Store o Edge Add-ons. Abre su ventana emergente, habilita la conexión y comprueba que el puerto corresponde al daemon local antes de continuar.

Paso 2: comprueba y registra la skill

bsk --version
bsk install-skill
bsk doctor

Confirma que la skill se instaló para el arnés previsto y que este descubre browser-skill; si conserva el inventario anterior, abre una conversación nueva. doctor por sí solo no comprueba ese descubrimiento.

Paso 3: prueba una sesión

Pide al agente abrir https://example.com, resumir la página y terminar la sesión. Comprueba que utiliza la ventana del agente y no una pestaña privada.

Comprobación

Confirma que doctor detecta la conexión, que la ventana visible contiene la página solicitada y que la sesión termina al finalizar. Para tareas con formularios añade una revisión antes del envío.

Si algo falla

Si doctor no detecta el navegador, revisa la extensión y el perfil seleccionado. Si un sitio exige verificación humana, toma el control y continúa después según la guía oficial.

Consulta el README oficial para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

BrowserSkill conecta agentes con un navegador real mediante una CLI y una extensión. El agente puede operar en una ventana propia y utilizar sesiones existentes para tareas web.

Para qué te sirve

  • Cuando un flujo requiere entrar en una aplicación donde ya tienes sesión.
  • Cuando quieres inspeccionar una petición fallida junto con el estado de la página.
  • Cuando necesitas revisar de forma visible las acciones del agente.

Cómo funciona

La herramienta bsk administra sesiones y comunica observaciones y acciones al navegador. Una Agent Window concentra el trabajo; también se puede prestar una pestaña expresamente. La documentación cubre capturas, extracción, depuración e historial de actividad.

Antes de empezar

Necesitas Chrome o Microsoft Edge basados en Chromium ≥125, una plataforma admitida por la CLI (macOS Intel/Apple Silicon, Linux x64/ARM64 o Windows x64) y completar la instalación de CLI y extensión. El README ofrece scripts para Unix y Windows y una guía AGENT_INSTALL.md. El agente debe poder ejecutar comandos de shell; los modelos y sus cuentas se preparan por separado.

Límites y alternativas

Reutilizar sesiones concede acceso a información y acciones de las cuentas abiertas. Utiliza un perfil de ensayo y revisa formularios antes de enviar. La ventana separada facilita supervisión, pero no limita por sí sola lo autorizado por una cuenta. Para tests reproducibles sin sesión personal puedes usar otro perfil con Playwright.

Recursos