Pegás un solo prompt y Claude instala Browser Harness solo. Desde ese momento podés pedirle “sacame los precios top 10 de auriculares en Amazon” o “mostrame los anuncios activos de mi competencia en Facebook” y abre tu Chrome real con tus sesiones logueadas. La primera vez tarda y te muestra el paso a paso. La segunda ya sabe cómo hacerlo y va directo. Y el catálogo de la comunidad ya tiene LinkedIn, Facebook Ads Library, Amazon, YouTube, Shopify y otros 90 sitios listos.
Mapa rápido · saltá al paso que te interese
Paso 1 · instalar
Con un mensaje en Claude Code
Pegás 1 prompt, Claude lee install.md y lo instala solo. Activás Chrome con debugging port y listo.
Paso 2 · skills
Cómo aprende cada sitio
Cada tarea queda guardada como .md. Y la comunidad ya subió skills para 95+ sitios — Amazon, LinkedIn, Facebook, Shopify, GitHub.
Paso 3 · automatizar
3 caminos para correrlo solo
Local en tu Mac con launchd, dentro de Cowork con Scheduled Tasks, o bux 24/7 en un VPS de $5 controlado por Telegram.
Browser Harness · skill MIT del equipo browser-use
Tu Chrome real · 95 sitios listos · automatizable de 3 formas distintas
Esta entrada cubre Browser Harness desde cero, en lenguaje de cinco años: qué es y por qué cambia 3 cosas, cómo lo instalás con un solo mensaje en Claude Code, cómo funcionan las skills que se autoescriben + el catálogo comunitario de 95 sitios pre-escritos (con un CTA honesto para sumar Instagram y Mercado Libre que faltan), 4 búsquedas copy-paste para arrancar el primer día (Amazon · Facebook Ads Library · LinkedIn · Mercado Libre), 3 caminos honestos para automatizarlo (local en tu Mac · Cowork sandbox · bux 24/7 en VPS) con tabla comparativa, y los 5 gotchas que te van a aparecer.
Qué es
Imaginate que Claude pudiera abrir tu Chrome — el de verdad, el que ya tiene tu sesión de Amazon, tu LinkedIn logueado, tu Facebook Ads Manager abierto — y hacer click, escribir, scrollear y leer páginas como si fuera vos. Eso es Browser Harness. Es una skill que el equipo de browser-use (los mismos que hicieron el agente más popular de web automation) regala gratis con licencia MIT. La instalás una vez, la conectás a tu Chrome con un comando, y ya está: cualquier carpeta de Claude Code la puede usar.
Le pedís “sacame los precios top 10 de auriculares en Amazon” → la primera vez Browser Harness explora la página, prueba selectores, falla, retoma, y termina con los precios. Cuando termina, escribe automáticamente un archivo amazon/product-search.md que dice exactamente cómo hacer esa búsqueda. La segunda vez que pidas algo similar, Claude lee la skill y va directo — sin explorar.
El repo trae 95 skills pre-escritas para los sitios más usados — Amazon, LinkedIn, Facebook (groups + pages + ads-library), YouTube, Shopify Admin, Gmail, GitHub, X, TikTok, Reddit, Walmart, Etsy, Zillow, Salesforce, SEC EDGAR. Las activás con un flag (BH_DOMAIN_SKILLS=1) y desde el primer prompt Claude ya sabe cómo moverse en ese sitio.
No tenés que clonar a mano, no tenés que pip install, no tenés que editar configs. Le pegás un prompt a Claude Code, Claude lee el install.md del repo y lo hace todo solo — clona, instala con uv, agrega la skill a tu ~/.claude/CLAUDE.md global. Tarda 1-2 minutos. No tocás nada.
No te confundas con el otro proyecto
Si te suena parecido a vercel-labs/agent-browser que ya tenemos cubierto en la bóveda, son herramientas distintas que resuelven problemas solapados. Agent Browser de Vercel (Apache 2.0, Rust) optimiza el costo en tokens cuando navegás — numera cada botón y te ahorra hasta 10× en tokens. Browser Harness (MIT, Python, browser-use) optimiza la repetibilidad — aprende cómo se hace cada tarea por sitio y guarda lo aprendido como skill para que la próxima vez no explore. Si querés bajar costo de tokens al navegar, agent-browser. Si querés que Claude se vuelva más rápido y consistente cada vez que repetís una búsqueda en el mismo sitio, browser-harness.
Instalar · 1 prompt + 1 paso en Chrome
El truco es que Browser Harness sabe leer su propio install.md. Vos no clonás, no editás configs, no instalás dependencias a mano — solo pegás un prompt en Claude Code y mirás. Después abrís Chrome con un puerto de debugging para que la skill se pueda enchufar. Y verificás con un comando que todo quedó bien.
Paso 1 · pegá esto en Claude Code
Abrí cualquier carpeta de tu Mac con el comando `claude` y pegá esto en el chat. Claude se va al repo de browser-use, lee install.md, clona, instala con uv, y agrega la skill a tu ~/.claude/CLAUDE.md global para que esté disponible en todas tus carpetas. Tarda 1-2 minutos. No toques la terminal.
Set up https://github.com/browser-use/browser-harness for me. Read `install.md` and follow the steps to install browser-harness and connect it to my browser.
Paso 2 · habilitá remote debugging en tu Chrome
Cerrá Chrome completamente. Volvé a abrirlo desde una terminal con este comando — le dice a Chrome que escuche en el puerto 9222, que es donde Browser Harness se enchufa. Si abrís Chrome a mano (haciendo clic en el ícono), el puerto no está abierto y la skill no se conecta.
Mac · abrí Chrome con remote debugging port (paso obligatorio)
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222Paso 3 · chequeá que todo esté OK
Con Chrome ya abierto desde terminal, corré el doctor. Te imprime una lista de checks verdes si todo quedó bien. Si hay un ✗, casi siempre es porque Chrome no está corriendo con el puerto de debugging — cerralo y abrilo de nuevo con el comando del paso 2.
Verificación · ¿quedó todo bien instalado?
browser-harness --doctor⚠ Disclosure honesto
El sandbox de Cowork no ejecuta este paso — Browser Harness se instala en tu Mac local. La sección de Automatizar más abajo cubre cómo correrlo desde Cowork con sus propios trade-offs.
Cómo aprende · catálogo comunitario
Una skill es un archivo .md chiquito que vive en ~/Developer/browser-harness/agent-workspace/domain-skills/{sitio}/{tarea}.md. Tiene 3 cosas adentro: el selector CSS o XPath de los botones que importan, el orden de los pasos, y un par de gotchas que aprendió la primera vez. Browser Harness las escribe sola — vos NO tocás esos archivos, dejás que el agente los maneje.
Fuente 1 · interaction-skills
17 mecánicas genéricas que Browser Harness usa siempre — wait_for_load, click_robust, scroll_until_visible, read_table, extract_pricing, etc. No las tocás, vienen built-in.
Fuente 2 · domain-skills
95 archivos para sitios reales escritos por la comunidad. Vienen apagadas por default — las activás con un flag de entorno una sola vez:
Activar las 95 skills de sitios pre-escritas
export BH_DOMAIN_SKILLS=1Algunos de los 95 sitios ya cubiertos
+ 65 sitios más (Twitch, Quora, GitLab, BambooHR, Mailchimp, Calendly, Discord, Vercel, AWS, Azure y otros).
🎯 CTA · sumá una skill al catálogo
Faltan algunos sitios populares en español. Instagram, Mercado Libre, Tienda Nube, Despegar y Rappi todavía nadie las subió al catálogo. Si las usás todos los días, sos la persona indicada para escribir la primera. Browser Harness lo hace solo — vos pedís 3-4 tareas en Instagram a Claude, él aprende, escribe los .md, y mandás un Pull Request al repo. Tu nombre queda en la skill que va a usar el resto de la comunidad latam.
Tus primeras 4 búsquedas · copy-paste
Abrí Claude Code en cualquier carpeta y asegurate de estar logueado en cada sitio en tu Chrome — Browser Harness usa tus sesiones, no las inventa. Pegá el prompt que quieras y mirá la terminal. Reemplazá los {CORCHETES} por tus valores reales antes de mandar.
Reemplazá {NICHO} por la categoría real (ej: 'auriculares bluetooth bajo 50 USD'). Tu Chrome ya tiene que estar logueado en Amazon.
Abrí Amazon y hacé esto:
1. Buscá "{NICHO}".
2. Sacá los 10 productos más vendidos del Best Sellers.
3. Para cada uno: nombre, precio, rating, número de reviews, y vendedor.
4. Devolveme una tabla en Markdown ordenada por número de reviews descendente.
5. Al final, identificá patrones de pricing — ej: "8 de 10 están entre $30 y $40" o "los top 3 son todos del mismo seller".Reemplazá {COMPETIDOR} por el nombre exacto de la página de Facebook. Esta búsqueda es pública — no necesitás estar logueado.
Andá a https://www.facebook.com/ads/library/.
1. Buscá la página "{COMPETIDOR}".
2. Filtrá por país: Argentina, Mexico, Colombia, Spain.
3. Sacá todos los anuncios activos de los últimos 30 días.
4. Para cada uno: copy del primer párrafo, tipo de creativo (imagen / video / carousel), CTA, fecha de inicio.
5. Agrupá por copy similar y devolveme: cuántos anuncios totales corre, cuántos copies distintos prueban, cuál es el copy que más repite (señal de winner ad).Útil para sales prospecting o research de candidatos. Tu Chrome tiene que estar logueado en LinkedIn — sin login no funciona.
Andá a LinkedIn.
1. Buscá "{PUESTO}" en "{CIUDAD}" — por ejemplo "CMO en Buenos Aires" o "Head of Growth en Mexico City".
2. Sacá los primeros 25 resultados.
3. Para cada perfil: nombre, empresa actual, headline, años en el rol actual, link al perfil.
4. Devolveme tabla ordenada por años en rol descendente — los más senior primero.
5. Marcá con ⭐ los que tienen 3+ años en el mismo rol Y trabajan en empresas de más de 100 empleados.Funciona con Mercado Libre Argentina, Mexico, Chile, Colombia. Cambiá el dominio según el país.
Abrí mercadolibre.com.ar (o el dominio del país que uses).
1. Andá a Ofertas del Día → categoría "{CATEGORIA}".
2. Sacá los 20 productos con mayor descuento (más de 30%).
3. Para cada uno: título, precio actual, precio original, % descuento, vendedor, MercadoLíder yes/no, envío full yes/no.
4. Devolveme tabla ordenada por % descuento.
5. Subrayá los que sean MercadoLíder Y envío full — esa es la señal de seller serio que suele moverse rápido.⏱ Cómo se siente la primera vez vs la segunda
La PRIMERA vez que corrés un prompt nuevo tarda 30-90 segundos porque Browser Harness explora la página. Mirá la terminal — vas a ver el “lo aprendí” cuando termine y escriba la skill nueva. La SEGUNDA vez que pidas algo similar al mismo sitio tarda 5-15 segundos. Esa es la magia.
Automatizar · 3 caminos honestos
El script de Instagram dice “automatizá con Cowork para que todos los días tengas listas nuevas”. Es verdad, pero con asterisco honesto: Cowork puede usar Browser Harness como herramienta, pero no llega a tu Chrome local con tus sesiones de LinkedIn o Facebook Ads Manager. Hay 3 caminos según qué tan automático lo querés y qué sitios necesitás.
Lo más simple para empezar — corre con tu Chrome real y tus sesiones.
Mac OS tiene launchd que dispara comandos a horarios. Hacés un launchd plist que cada mañana a las 8 abre una terminal, navega a tu carpeta de Claude Code, y le pasa el prompt como archivo. Funciona perfecto si tu Mac queda prendida (o en sleep con el power adapter conectado). Si la cerrás y la guardás en la mochila, no corre. Es el camino más simple para validar la idea antes de pagar infra.
El comando que dispara desde launchd a las 8 AM
cd ~/Code/browser-harness-runs && claude --no-tui --prompt-file daily-amazon.mdCorre 24/7 sin tu Mac, pero el sandbox arranca limpio cada vez.
Cowork puede instalar Browser Harness en su sandbox y correrlo en su propio Chromium headless. Lo bueno: corre 24/7 sin que tu Mac esté prendida. Lo no-tan-bueno: el sandbox arranca limpio cada vez, no tiene tu sesión de LinkedIn ni de Facebook Ads Manager. Funciona perfecto para sitios públicos sin login (Amazon search público, Mercado Libre, Wikipedia, SEC EDGAR, biblioteca pública de Facebook Ads que NO requiere login). NO funciona para feed personalizado de LinkedIn ni para tu Facebook Ads Manager privado. Setup: en tu Cowork Project, agregás Browser Harness al setup script. Después en Scheduled Tasks ponés el horario y el prompt. Cowork lo corre solo y deja el resultado en el chat del Project para que lo veas cuando despertás.
Setup script del Project en Cowork (pegalo en la pestaña Setup)
pip install browser-use && playwright install chromium && git clone https://github.com/browser-use/browser-harness ~/bhEl sibling oficial de browser-use — Telegram + Chrome real + 24/7.
El equipo de browser-use hizo otro proyecto que se llama bux exactamente para esto: “A 24/7 Claude Code agent with Browser Harness, on any box you own”. Lo instalás en un VPS de DigitalOcean / Hetzner / Linode de $5/mes con un solo curl, lo controlás por Telegram desde el celular. Le hacés login una vez vía VNC en sus sites importantes y queda con la sesión real corriendo 24/7. Te manda los resultados a Telegram cuando termina cada tarea. Es el setup que un usuario serio termina queriendo cuando ya validó la idea con el camino 1 o 2.
Instalar bux en tu VPS · correlo como sudo con tu API key
curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh | sudo BROWSER_USE_API_KEY=bu_xxx bashTabla rápida · elegí según qué necesitás
| Campo | Local Mac | Cowork | bux VPS |
|---|---|---|---|
| Sesión real LinkedIn / Facebook | Sí | No | Sí |
| Corre con Mac apagada | No | Sí | Sí |
| Costo extra | $0 | Plan Cowork | $5 / mes VPS |
| Trigger del horario | launchd / cron | Scheduled Tasks | Telegram + cron |
| Ideal para | Empezar | Scrap público | Producción real |
5 trampas que te van a aparecer
Browser Harness funciona muy bien cuando entendés sus reglas. Estas 5 cosas te van a aparecer en la primera semana — si las conocés desde el día 1, no te van a frustrar.
Browser Harness NO te hace login — usa la sesión que ya tenés abierta. Si te deslogueás de LinkedIn, los prompts de LinkedIn van a fallar. Solución: dejá tu Chrome con las sesiones que usás más activas y solo deslogueate de las que no querés que toque.
30-90 segundos de exploración + skill writing. Mirá la terminal: está pensando, no está colgado. Vas a ver mensajes tipo “probando selector .product-card · falló · probando otro · OK”. Cuando termine, escribe la skill y la próxima corrida en ese sitio te tarda 5-15 segundos.
LinkedIn Premium y todo lo protegido por Cloudflare a veces te tiran un captcha o te bajan throughput. Solución 1: bajá la frecuencia (no hagas 50 búsquedas seguidas en el mismo sitio). Solución 2: el cloud free tier de browser-use trae proxies + CAPTCHA solver de regalo (3 browsers concurrentes, sin tarjeta).
Si desde dos carpetas distintas pedís cosas diferentes en Amazon, Browser Harness puede sobrescribir una skill con otra porque por default todas viven en ~/Developer/browser-harness/agent-workspace/domain-skills/amazon/. Solución: usá la env var BH_WORKSPACE para tener workspaces separados por proyecto.
El README es explícito: “Skills are written by the harness, not by you. Please don't hand-author skill files; agent-generated ones reflect what actually works in the browser.” Si querés mejorar una skill, la corrés con un prompt mejor — Browser Harness la reescribe sola. Tocarla a mano rompe la convergencia.
Guía de la comunidad
Esta entrada destila Browser Harness — la skill de browser-use que deja a Claude Code abrir tu Chrome real, ejecutar tareas web y guardar lo aprendido como archivo .md por sitio. Es parte de la bóveda de tododeia, una colección libre de recursos para quienes usan Claude todos los días.
Cierre personal
“Yo uso Browser Harness todos los días para sacar precios de los productos que vendo, ver qué anuncios corren mis competidores en Facebook, y leer noticias de mi sector antes de empezar a trabajar. Antes hacía todo eso a mano y me llevaba 2 horas cada mañana. Ahora le digo a Claude lo que necesito y mientras desayuno me deja la lista lista. Perdele el miedo. Si elegís 3 búsquedas que repetís a mano todos los días y se las pasás a Claude con Browser Harness, en 1 semana ya no vas a querer volver a hacerlo manual.”
browser-use/browser-harness · repo principal
El repo MIT con instalador, 17 interaction skills y 95 domain skills pre-escritas para los sitios más usados.
browser-harness.com · homepage oficial
Sitio oficial con demos, blog y showcase de lo que la comunidad armó con la skill.
browser-use/bux · sibling para 24/7 en VPS
El proyecto hermano: Claude Code + Browser Harness corriendo 24/7 en cualquier VPS, controlado por Telegram.
Browser Use Cloud · free tier con proxies y CAPTCHA solver
3 browsers concurrentes gratis sin tarjeta — útil cuando algún site te empieza a tirar captcha.
Guías hermanas que cruzan con Browser Harness
Claude Chat, Cowork y Code
Cómo funcionan los 3 modos y dónde encaja Browser Harness — sobre todo el flow de Scheduled Tasks de Cowork.
Qué es una skill
Las skills son los enchufes que dan a Claude capacidades nuevas — Browser Harness es una de ellas.
Crea tus propias skills
Cuando una skill empaquetada ya no alcanza y necesitás escribir una para tu sitio favorito en español.
Agent View · sesiones paralelas
Para correr 3+ búsquedas de Browser Harness en paralelo sin saltar entre terminales.
Cuál plan de Claude
Browser Harness es gratis pero corre con tu Claude Code — chequeá qué plan necesitás.
Agent Browser de Vercel
El otro proyecto que se confunde con éste — el de Vercel optimiza tokens, Browser Harness optimiza repetibilidad.
Por dónde empezar si recién instalás Claude Code
Si recién instalás Claude Code, empezá por la guía Instalar Claude Code y después volvé acá. Si ya lo tenés, abrí cualquier carpeta y pegá el prompt único de la sección Instalar — eso es todo lo que tenés que hacer la primera vez.
Para quién no aplica esta página
Si nunca abriste Claude Code y no querés tocar terminal, esta guía no es por dónde empezar — andá primero a Claude Chat, Cowork y Code que cubre los 3 modos sin terminal. Si no usás Chrome (sos heavy de Safari o Firefox), Browser Harness solo soporta Chromium — Brave y Edge funcionan, Safari no.