byob

Bring Your Own Browser (Trae tu propio navegador): permite que tu asistente de IA utilice el Chrome que ya tienes abierto.

Inglés · 中文

¿Qué puedo hacer con esto?

Puedes pedirle a Claude (o Cursor / Cline) que haga algo en la web. byob lo hace realidad en tu Chrome real, el mismo en el que ya has iniciado sesión en Twitter, GitHub, Gmail, tus herramientas de trabajo y todo lo demás.

Algunas cosas que la gente suele pedir:

"lee mi cronología de Twitter y dime cuáles son las 5 publicaciones principales"

byob abre una pestaña, se desplaza por ella y te devuelve el texto. Como es tu navegador real, tus tweets aparecen; no hay cuentas falsas, ni necesidad de copiar y pegar cookies, ni captchas.

"busca en google 'mcp protocol spec', haz clic en el primer resultado y lee la página"

byob va a google.com, escribe tu búsqueda, presiona Enter, espera los resultados, hace clic en el primer enlace y lo lee. Todo en una sola instrucción.

"dame mi cookie de sesión de github para poder usar curl en un script"

byob te entrega la cookie. Ahora curl https://github.com/... funciona exactamente como si hubieras iniciado sesión.

"toma una captura de pantalla de example.com"

byob guarda un PNG en el disco y le dice a Claude dónde está. (No vuelca base64 en el contexto de Claude, eso consumiría tus tokens rápidamente).

"abre mi pestaña de Gmail y dime cuántos correos no leídos tengo"

Los navegadores en la nube (headless) no pueden ver tu Gmail porque no han iniciado sesión. byob sí puede, porque ES tu navegador.

Related MCP server: agent-browser-mcp

¿Por qué no usar simplemente WebFetch o Puppeteer?

Instalación en 5 minutos

git clone https://github.com/<you>/byob ~/code/byob
cd ~/code/byob && bun install

# one command does everything: makes a key, builds the extension,
# tells Chrome about it
( cd packages/bridge && bun run dev:cli install --dev )

# load the extension in Chrome:
#   chrome://extensions  →  Developer mode  →  Load unpacked
#   pick: packages/extension/.output/chrome-mv3
# then fully quit Chrome (⌘Q) and open it again

# check it works
( cd packages/bridge && bun run dev:cli doctor )
# four green ✓ means you're good

# tell Claude Code about byob
claude mcp add byob -s user -- /Users/$USER/code/byob/packages/mcp-server/node_modules/.bin/tsx /Users/$USER/code/byob/packages/mcp-server/bin/byob-mcp.ts

Abre una sesión nueva de Claude Code y di "usa byob para...".

Las 10 cosas que byob puede hacer

Formas completas de entrada/salida: shared/src/schemas.ts.

Cómo funciona realmente

Claude Code  ─→  byob-mcp  ─→  byob-bridge  ─→  Chrome extension  ─→  your Chrome tab

Cuatro saltos, todo en tu portátil. Nada sale de tu máquina. Cierra Chrome y todo se detiene; no quedan procesos en segundo plano.

Cosas que debes saber sobre la seguridad

• 🔒 browser_eval (ejecutar JS) está desactivado por defecto; incluso Claude no ve que existe. Actívalo configurando BYOB_ALLOW_EVAL=1 cuando registres el MCP. Cuando está activado, cada llamada se registra y muestra una notificación de Chrome.

• 🚫 Algunos sitios están bloqueados por defecto; chrome://, file://, tus páginas de inicio de sesión de Google/Microsoft/Apple. Así que Claude no puede leer accidentalmente tu gestor de contraseñas o /etc/passwd.

• 🔑 Obtienes tu propia clave de extensión; cuando instalas, byob crea una clave solo para ti. Dos personas que ejecuten byob obtendrán dos IDs de extensión diferentes, sin conflictos.

• 📁 Los archivos son privados; los sockets son 0600, las carpetas son 0700. Otros usuarios en tu computadora no pueden leerlos.

• 📡 byob nunca envía datos a casa; sin analíticas, sin pings de actualización automática, sin informes de errores. Tráfico saliente cero.

• ⚠️ Chrome mostrará "byob está depurando esta pestaña" en la parte superior de la página. No hay forma de ocultarlo; es una medida de seguridad de Chrome, no un error de byob. Todas las herramientas que usan el depurador de Chrome tienen el mismo aviso.

Comandos diarios

byob install     # set everything up (or fix it after Chrome breaks)
byob doctor      # check what's working and what's not
byob bridges     # show me the running bridges
byob logs [-f]   # tail the log
byob uninstall   # nuke the launcher and manifests

¿Quieres saber más?

• Notas de diseño — cómo funciona byob internamente y por qué

• Registro de cambios — qué se ha hecho y qué está por venir

• Contribución — cómo enviar un PR

• Lista de verificación de pruebas — cosas que probar antes de cada lanzamiento

¿Sigues atascado? Ejecuta byob doctor: te dirá exactamente qué paso está fallando.

Licencia MIT. byob tiene mucho acceso a tu navegador; ejecútalo solo en máquinas y cuentas que te pertenezcan.