BYOB: conecta tu agente con una sesión de Chrome existente

Consulta e interactúa con pestañas que ya tienes abiertas mediante una extensión y un servidor MCP local.

✓ 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

Claude

ChatGPT

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.

Dificultad: intermedio
Proyecto: https://github.com/wxtsky/byob (licencia MIT)
Guía completa: https://lab.wisd.ai/hub/byob-bring-your-own-browser

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

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

Pasos de configuración

Paso 1: prepara la instalación

Comprueba que tienes Node.js ≥20 y Chrome, Edge o Brave disponibles, además de un cliente MCP. El asistente puede instalar Bun si falta. En Windows abre Git Bash o MSYS2.

El instalador oficial es:

curl -fsSL https://raw.githubusercontent.com/wxtsky/byob/main/install.sh | bash

Paso 2: completa el asistente

Revisa los requisitos y selecciona solo los clientes necesarios. Carga la extensión descomprimida desde ~/byob/packages/extension/output/chrome-mv3 (o el directorio elegido) en chrome://extensions, con el modo de desarrollador activo. Cierra completamente Chrome y vuelve a abrirlo para que lea el registro de comunicación con el proceso local. Usa inicialmente un perfil de prueba.

Comprobación

Comprueba que el cliente ve una pestaña de prueba y puede leer su título. Verifica el perfil conectado antes de usar una página con sesión iniciada.

Si algo falla

Si no hay comunicación, revisa el registro del proceso local de conexión y la extensión configurada por el asistente. Si falta una herramienta en el cliente, comprueba MCP y recarga la sesión.

Qué es

BYOB, Bring Your Own Browser, conecta un agente con un navegador real mediante una extensión. El servidor MCP local sirve de puente para controlar pestañas que ya tienen tus sesiones abiertas.

Para qué te sirve

Cuando necesitas leer un panel privado sin iniciar otra sesión en un navegador alojado.
Cuando quieres inspeccionar una página en la misma pestaña que estás usando.
Cuando una tarea requiere rellenar un formulario y revisar el resultado antes de enviarlo.

Cómo funciona

La extensión se comunica con un host local y el servidor publica herramientas MCP al cliente. La instalación prepara la extensión y el registro necesario para que el navegador hable con el proceso local. El proyecto evita depender de abrir un puerto de depuración de Chrome.

Eso no reduce el alcance de las cuentas abiertas en las pestañas: el agente actúa dentro de tu sesión real. Separa los primeros ensayos de los perfiles y aplicaciones que contienen información importante.

Antes de empezar

El README pide Node.js 20 o posterior, Bun, un navegador compatible y un cliente MCP. El asistente comprueba requisitos, construye la extensión y configura las integraciones elegidas. En Windows documenta Git Bash o MSYS2 para el instalador.

Límites y alternativas

Las herramientas pueden acceder a contenido autenticado y provocar acciones con efecto real. Configura solo el perfil necesario y revisa formularios antes de enviarlos. Para automatización independiente de tus sesiones personales, un navegador separado puede ofrecer un alcance más claro.

Recursos

Repositorio y README - 144 estrellas; licencia detectada por GitHub: MIT.
Licencia - Consulta sus condiciones antes de reutilizar el proyecto.