01 Qué es y en qué se diferencia
Browser Harness es una herramienta de código abierto del equipo de browser-use que conecta un agente de IA directamente a tu navegador real mediante el protocolo de depuración de Chrome (CDP). No abre un navegador vacío: usa tu Chrome, con tus cookies y tus sesiones, así que puede trabajar en paneles donde ya has iniciado sesión.
Su idea central es que el agente mejora con el uso. Trae un conjunto de funciones básicas protegidas y un espacio de trabajo donde el propio agente escribe las funciones auxiliares que le faltan (subir un archivo, leer una tabla concreta, recorrer una paginación). La próxima tarea parecida ya las tiene.
Úsalo cuando…
La tarea requiere clics, escribir o navegar; necesitas tu sesión iniciada; la página se genera con JavaScript o tiene protección contra bots.
No lo uses cuando…
Basta con leer una página pública o una API. Un fetch normal es más rápido, más barato y no toca tu navegador.
Frente a otros agentes de navegador
Algunas alternativas se centran en gastar menos tokens al describir la página. Browser Harness prioriza trabajar en tu navegador real y acumular capacidades con cada tarea.
02 Instalación paso a paso
-
1
Instala la herramienta con uv
Se instala como herramienta de línea de comandos con Python 3.12. Las opciones --upgrade y --force sustituyen cualquier versión anterior.
-
2
Registra la skill en Claude Code
El comando browser-harness skill imprime las instrucciones de la skill. Guárdalas como SKILL.md en una carpeta browser-harness dentro de tus skills de Claude Code.
-
3
Permite la depuración remota en Chrome
Abre chrome://inspect/#remote-debugging y marca la casilla que permite la depuración remota para esa instancia. Es un paso manual que solo se hace una vez.
-
4
Prueba la conexión
Ejecuta page_info() a través de browser-harness. Si imprime datos de la pestaña, está conectado. En macOS puede aparecer una ventana de permiso por conexión: browser-harness mac-approve la gestiona.
-
5
Decide si quieres grabaciones
La herramienta puede guardar capturas y trazas de lo que hace en tu equipo. Por defecto es no; actívalo solo si te compensa, porque pueden contener datos sensibles.
uv tool install --python 3.12 --upgrade --force browser-harness
mkdir -p ~/.claude/skills/browser-harness
browser-harness skill > ~/.claude/skills/browser-harness/SKILL.md
# Prueba de conexión con tu Chrome
browser-harness <<'PY'
print(page_info())
PY
# Si algo falla
browser-harness --doctor03 Cómo aprende: funciones auxiliares y skills por web
Todo el estado vive por defecto en ~/.config/browser-harness: el espacio de trabajo del agente, los registros y las capturas. Ahí está agent_helpers.py, el archivo donde el agente añade sus propias funciones. El núcleo de la herramienta queda protegido para que una función mal escrita no lo rompa.
Además existen skills de dominio: notas por sitio web con los pasos y trucos para tareas concretas, escritas por agentes y aportadas por la comunidad al repositorio. Están desactivadas por defecto; con la variable BH_DOMAIN_SKILLS=1 el agente las consulta antes de improvisar en una web conocida.
export BH_DOMAIN_SKILLS=104 Prompts para empezar
Usa browser-harness. Abre en una pestaña nueva las webs de estos tres competidores: [URL 1], [URL 2], [URL 3]. Para cada uno, anota los servicios que ofrecen, si publican precios, qué llamada a la acción usan en la portada y si tienen chat o formulario. Devuélveme una tabla comparativa y cierra las pestañas que hayas abierto.Usa browser-harness con mi sesión de Chrome. Entra en el panel de [herramienta], ve al informe de pedidos del último mes y extrae fecha, cliente, importe y estado de cada pedido a un CSV en esta carpeta. Solo lectura: no pulses ningún botón que modifique datos. Si necesitas una función nueva para recorrer la paginación, guárdala para reutilizarla.Acabamos de descargar las facturas del portal del proveedor. Revisa qué pasos han funcionado y deja documentado en el espacio de trabajo de browser-harness el procedimiento para repetirlo el mes que viene, incluidos los problemas que has encontrado y cómo los resolviste.05 Seguridad y buenas prácticas
- ✓No dejes a un agente navegando sin supervisión por webs que no conoces: una página puede contener instrucciones ocultas.
- ✓Revisa de vez en cuando agent_helpers.py: es código que ha escrito el agente y se ejecutará en tu equipo.
- ✓Respeta los términos de uso de cada web; automatizar algunas plataformas puede suponer el bloqueo de la cuenta.
- ✓Si no usas la telemetría, puedes desactivarla con browser-harness telemetry disable.
- ✓Actualiza con browser-harness --update -y cuando el diagnóstico avise de una versión nueva.
06 Ejecutarlo sin tu ordenador
En local, el agente necesita tu Chrome abierto. Si quieres tareas continuas, el mismo equipo publica bux, un instalador que monta Claude Code con navegador en un servidor Ubuntu propio y te permite darle órdenes por Telegram. Requiere una clave de su servicio en la nube, así que valora antes el coste y dónde quedan tus datos. También hay navegadores remotos opcionales para tareas en paralelo, que se activan con browser-harness auth login.
Preguntas frecuentes
Sí, la herramienta es de código abierto y el uso con tu Chrome local no necesita clave de API. Solo pagas tu plan de Claude. Los navegadores en la nube de browser-use son un servicio opcional de pago.
Sí. Está pensado para Claude Code y Codex, y además ofrece un servidor MCP (browser-harness-mcp) para clientes compatibles con MCP como Cursor.
No. Trabaja en segundo plano: abre y usa pestañas sin cambiar la que estás viendo, salvo que le pidas expresamente que te la muestre.
Comprueba que Chrome está abierto y que marcaste la casilla de depuración remota en chrome://inspect/#remote-debugging. Después ejecuta browser-harness --doctor, que te dice qué comprobación falla.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.