Por qué existe

Los navegadores con IA tienen todos la misma forma: instalas un navegador nuevo con un asistente dentro — Aside, Comet, Dia. Esa forma cuesta tres cosas:

Nosotros tomamos el arreglo opuesto. Ningún navegador que instalar y nada que migrar: maneja el Chrome que ya tienes, en una ventana que tú también ves y usas. Ves aterrizar cada clic, y esos clics ocurren en una pestaña que el agente abrió para sí mismo. Nada que migrar, nada que entregar.

🔵 Para que quede exacto lo que eso significa y lo que no: el agente nunca toma la pestaña que estás leyendo ni trae la ventana al frente, así que puedes seguir trabajando a su lado. Pero no se detiene porque muevas el ratón: no es que lo interrumpas y te ceda el paso, es que nunca compartisteis pestaña. Cuando sí quieras que trabaje en la página que estás viendo, se la entregas tú con ./wb take <#>.

Esa decisión es también la razón de que funcione en Windows, macOS, Linux y WSL: no tuvimos que construir un navegador para cada uno, así que no había plataforma que elegir.

¿Lo necesitas? Constrúyelo.

Esa es la idea completa. No un producto que espera la hoja de ruta de otro, sino una herramienta pequeña que es tuya, en la máquina que ya usas, dentro del navegador en el que iniciaste sesión tú mismo. Unas 2.600 líneas entre JavaScript, Python y shell — se leen en una tarde. Léela, cámbiala, hazla tuya.

Wbrowser apunta a Windows, macOS, Linux y WSL. Medido en macOS, Linux nativo, WSL2 y Windows nativo — aunque no todas las comprobaciones se ejecutaron en todas las plataformas (ver tabla). Porque "¿qué sistema operativo usas?" nunca debería ser la razón por la que no puedes automatizar tu propio navegador.

¿Qué es esto?

La mayoría de las herramientas de automatización le dan a tu IA un navegador nuevo y vacío. Así que no puede ver tu correo, tus paneles, ni nada que esté detrás de un inicio de sesión — a menos que entregues contraseñas o configures integraciones de API para cada servicio.

Wbrowser hace lo contrario: inicias sesión una vez, a mano, en una ventana normal de Chrome. Después, tu terminal (o tu asistente de IA) controla esa misma ventana — ya autenticada, en todas partes.

./wb go https://mail.example.com   # se abre en TU sesión iniciada
./wb read                          # te dice qué hay en pantalla
./wb click '#compose'              # hace clic

Wbrowser nunca ve tus contraseñas. Tú las escribes — en Chrome, o una vez en una bóveda local cifrada que lee el motor (wb login, opcional; AES-256-GCM con clave derivada por scrypt, solo lectura del propietario 0600). En cualquier caso la IA nunca las recibe; Wbrowser solo controla la ventana que ya está abierta.

No se copia nada — es tu cuenta, en vivo

Conviene ser preciso aquí, porque es lo que separa esto de la mayoría de herramientas parecidas.

Wbrowser no guarda ninguna copia de tus datos. La carpeta de perfil contiene cookies — la prueba de que iniciaste sesión — y nada más. Tu correo, tus archivos, tus paneles siguen en los servidores del proveedor, igual que para tu teléfono. El agente los ve del mismo modo: presentando esa prueba y preguntando.

Servidores de Google      tu cuenta, tus datos
        |
        +-- Chrome del portátil    una sesión
        +-- tu teléfono            una sesión
        +-- Wbrowser               una sesión   <- la creaste al iniciar sesión

Dos consecuencias, y conviene sostener ambas:

• 🔵 Sin copias desactualizadas, sin sincronización, sin un segundo sitio que proteger. Cierra sesión desde Google y todas las sesiones terminan, incluida esta. Nada queda en una carpeta esperando a ser robado.
• 🔴 Es la cuenta real, no un entorno aislado. Cuando el agente abre tu correo, es tu correo. El acceso es exactamente el tuyo — ni más, ni menos.

⚠️ Copiar la carpeta de perfil no funciona de todos modos. Lo probamos: 685 cookies quedaron en 3. Chrome invalida un perfil que no reconoce. Iniciar sesión a mano no es un rodeo para eso — es la única disposición que se sostiene.

Un inicio de sesión abre muchos sitios

Esta es la parte que hace que valga la pena configurarlo. Inicia sesión en Google una vez en esa ventana y:

Google en sí          google.com · youtube.com · tus apps de Workspace
Sitios con Google SSO  todo lo que alcance "Iniciar sesión con Google" —
                       sistemas internos, reservas, paneles de control
Todo lo demás         inicia sesión a mano una vez; se mantiene

Medido en un perfil real: un solo inicio de sesión de Google trajo consigo YouTube y dos sistemas internos en los que nunca se inició sesión por separado (usan Google SSO). El resto (GitHub, Reddit, etc.) se inició a mano una vez y sigue activo.

Así que el coste inicial es: un inicio de sesión de Google, más uno por cada sitio que no use Google. Después de eso, tu agente llega a todos.

🔴 La otra cara es el mismo hecho: quien pueda manejar este navegador puede actuar en todos esos sitios como tú. Consulta Seguridad.

Inicio rápido

macOS · Linux · WSL — una sola orden:

curl -fsSL https://raw.githubusercontent.com/w-partners/Wbrowser/main/setup.sh | bash

Comprueba lo que tienes, clona, instala, deja wb en tu PATH, instala la habilidad del agente y registra wbrowser como servidor MCP para que tu asistente lo vea en su lista de herramientas (junto a cualquier herramienta de navegador integrada), y abre la ventana del navegador. Luego inicias sesión en tus sitios en esa ventana — a mano, como siempre — y la instalación está hecha.

🔵 El registro MCP es stdio local — sin puerto, sin token, sin exposición de red; solo tu propio proceso de agente puede alcanzarlo. (Hay un modo HTTP autenticado aparte para manejarlo desde otra máquina; ese sí requiere token y no se configura aquí.) Con Claude CLI se registra solo; en cualquier otro runtime de agente, la instalación imprime el comando para añadirlo.

git clone https://github.com/w-partners/Wbrowser.git
cd Wbrowser
$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1; npm install
node launch.js          # inicia sesión en la ventana que se abre
node engine.js          # deja esto corriendo
node bin\wbrowser.js go https://github.com

git clone https://github.com/w-partners/Wbrowser.git
cd Wbrowser
# Wbrowser usa el Chrome *del sistema*, así que la descarga del navegador
# de Playwright es innecesaria — omítela y ahorra ~400MB:
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install

node launch.js       # 1. abre una ventana de Chrome dedicada
                     # 2. inicia sesión en tus sitios en esa ventana (¡a mano!)
node engine.js       # 3. inicia el motor de control
./wb go https://example.com

Si la instalación se detiene

No se queda a medias: se para y dice por qué. Las dos más frecuentes:

Si ./wb dice "Permission denied" — el bit de ejecución se perdió al clonar. Se arregla una sola vez:

chmod +x wb install.sh autostart.sh sync-session.sh

Servidores sin pantalla: si no hay $DISPLAY, Wbrowser lanza Chrome en modo headless automáticamente. Fuérzalo con WBROWSER_HEADLESS=1 o =0. 🔵 Sin pantalla no puedes iniciar sesión a mano — usa ./sync-session.sh export en un equipo de escritorio y luego import aquí.

¿Por qué una ventana de Chrome separada?

Desde Chrome 136 (marzo de 2025), --remote-debugging-port se ignora en el directorio de perfil predeterminado de Chrome. Google hizo este cambio porque los atacantes usaban la depuración remota para robar cookies.

Por eso ahora es obligatorio un --user-data-dir no predeterminado. Wbrowser crea uno en ~/.wbrowser e inicia Chrome allí.

Esto significa que tus sesiones actuales no se transfieren. Inicias sesión una vez en la ventana nueva y desde entonces se mantienen.

⚠️ Copiar la carpeta de perfil de Chrome no funciona. Lo intentamos: 685 cookies quedaron en 3, y todas las cookies de sesión se perdieron. Chrome invalida los perfiles que no reconoce. Inicia sesión de nuevo — toma un minuto y sí funciona.

Comandos

./wb go <url>              abre una página y devuelve su estructura
./wb read                  resume la página actual
./wb click <selector>      hace clic en un elemento
./wb type <selector> <texto>   rellena un campo
./wb press Enter           pulsa una tecla
./wb eval '<js>'           ejecuta JavaScript en la página
./wb console [regex]       registros de consola + excepciones no capturadas
./wb network               peticiones fallidas (4xx/5xx, CORS, timeouts)
./wb shot [archivo.png]    captura de pantalla
./wb tabs                  pestañas numeradas — y quién conduce cada una
./wb take <n>              entrega al agente la pestaña que tienes delante
./wb release               recupérala
./wb close                 cierra solo las pestañas que tú abriste
./wb status                ¿todo funcionando? ¿qué perfil?
./wb show                  trae la ventana del navegador al frente

No adivines los selectores

./wb read devuelve los elementos reales de la página:

inputs(1):
  - #searchbox_input  (Buscar sin ser rastreado)
buttons(3): Buscar, Iniciar sesión, Ajustes

Copia de ahí.

Caso real: adivinamos input[name=q] para un campo de búsqueda y falló — era un textarea. read tenía la respuesta correcta desde el principio.

Úsalo desde un asistente de IA (MCP)

Wbrowser habla Model Context Protocol, así que cualquier asistente compatible con MCP puede controlar tu navegador.

Local (stdio):

{
  "mcpServers": {
    "wbrowser": {
      "command": "node",
      "args": ["/ruta/a/Wbrowser/mcp-server.js"]
    }
  }
}

Remoto (HTTP):

export WBROWSER_MCP_TOKEN=$(openssl rand -hex 32)
node mcp-server.js --http --port 7982 --host 127.0.0.1

Luego simplemente háblale a tu asistente:

"Abre mi panel y resume los números de hoy." "¿Qué hay en mi carrito de esa tienda?"

🔴 El servidor remoto se niega a arrancar sin un token. No es opcional — controla un navegador que contiene todas tus sesiones. Quien alcance ese puerto se convierte en ti.

Tareas programadas (cron)

Crea jobs/revision-matutina.json:

{
  "schedule": "0 9 * * 1-5",
  "tab": "morning",
  "steps": [
    { "goto": "https://dashboard.example.com", "wait": 2000 },
    { "eval": "document.querySelector('.total').innerText" },
    { "shot": true }
  ]
}

node cron.js list      qué está registrado
node cron.js next      cuándo se ejecuta cada tarea
node cron.js run <nombre>   ejecutar una vez, ahora
node cron.js daemon    ejecutar según el horario

0 9 * * 1-5 = minuto 0, hora 9, días laborables. Cron estándar de 5 campos: minuto hora día mes día-semana.

Las acciones irreversibles se bloquean por defecto

La automatización desatendida significa que nadie está mirando cuando algo sale mal. Por eso los pasos que parecen enviar / pagar / eliminar se rechazan:

⛔ paso 2 bloqueado — parece irreversible (click: #submit-payment)
   Si es intencional, añade "allowIrreversible": true al archivo de la tarea.

La autorización es por tarea, no global.

¿Quién está controlando? (indicador visual)

Cuando un agente controla el navegador, lo ves:

• Un borde translúcido con una etiqueta: 🤖 mi-agente en control
• El título de la pestaña lleva prefijo: [mi-agente] Panel

El borde se desvanece tras 6 segundos de inactividad, así que "en control" significa realmente ahora mismo. Los colores derivan del nombre del agente, de modo que varios agentes se distinguen de un vistazo.

El prefijo de la pestaña sobrevive a la navegación — un MutationObserver lo vuelve a aplicar cada vez que la página reescribe su propio título (algo que las SPA hacen constantemente).

Entregar una pestaña a mitad de tarea

Llevas tres páginas: filtraste una lista, rellenaste medio formulario, te metiste en un panel. Quedan otros veinte minutos y preferirías no hacerlos. Señala esa pestaña y deja que el agente siga:

./wb tabs
  #  driven by      title                                url
  1  — (yours)      Reservas — marzo                     https://…/bookings?from=03-01
  2  — (yours)      Factura 4417                         https://…/invoices/4417
  3  my-agent       [my-agent] GitHub                    https://github.com/…

./wb take 1          # el agente retoma la pestaña 1 justo donde la dejaste
./wb release         # la recuperas

Sin volver a entrar, sin rehacer la navegación, sin explicar lo que ya hiciste: el agente recibe la página en el estado que construiste.

🔴 Un agente nunca toma una pestaña por su cuenta. Abre las suyas y solo conduce esas; el único modo de que toque la tuya es que se la entregues por número. No es una política, es cómo funciona la búsqueda: un agente no tiene forma de nombrar una página que no abrió.

Antes de 0.2.0 no era así. La pestaña por defecto del agente adoptaba la página que ya estuviera abierta, que solía ser la que tú estabas leyendo — y a partir de ahí hacía clic y escribía en tu pestaña, y le cambiaba el título. Comprobar qué pestañas parecen "libres" no lo arregla: una pestaña que abriste a mano no la reclama nadie y parece libre en cualquier comprobación. Por eso se eliminó la adopción.

./wb release también quita la etiqueta [agente], para que la barra de pestañas deje de indicar que alguien conduce una pestaña que ya es tuya otra vez.

Varias cuentas

Abre varios perfiles de Chrome en la misma ventana y Wbrowser puede dirigirse a cada uno por separado:

./wb -a [email protected] go https://mail.example.com
./wb windows                    # lista los perfiles abiertos

O asigna sitios a cuentas en accounts.json:

{
  "sites": {
    "mail.example.com": { "account": "[email protected]" }
  }
}

🔴 Si nombras una cuenta que no está abierta, Wbrowser falla en lugar de adivinar. Enviar correo desde la cuenta equivocada es peor que un mensaje de error.

Notas de plataforma

Si la detección falla, usa WBROWSER_CHROME=/ruta/a/chrome.

Probado en hardware real (2026-08-24):

Plataforma	Chrome	Verificado por	Qué se midió allí
macOS 15	151	otro operador	arranque · motor · CLI · rutas de estado
Linux (nativo, sin pantalla)	148	otro operador	lo anterior + revisión de seguridad
WSL2 + Chrome de Windows	151	mantenedor	lo anterior
Windows 10 (nativo)	151	otro operador	lo anterior + prueba de extremo a extremo

🔵 No todas las comprobaciones se ejecutaron en todas las plataformas. La revisión de seguridad (rechazo sin token confirmado con ss, motor inalcanzable fuera de loopback) se hizo en Linux. La prueba de extremo a extremo (/health → /act → extracción real) se hizo en Windows. Las rutas UNC (\\wsl.localhost\...) también funcionan — medido, en contra de lo que esperábamos.

La revisión de seguridad se hizo en Linux, en otra máquina: sin token el servidor MCP HTTP termina y nunca abre un socket (verificado con ss); el motor escucha solo en 127.0.0.1 y no es alcanzable por la red interna.

Seguridad

Esta herramienta controla un navegador que contiene todas tus sesiones. Trátala en consecuencia.

• 🔴 127.0.0.1 no es una valla — significa "cualquier proceso que corra como tú entra". El puerto de depuración de Chrome (9222) no tiene autenticación. Cualquier proceso local de esa máquina — otra app, un hook de npm, un script suelto — puede conectarse y manejar todas las sesiones en las que iniciaste sesión. Medido: un proceso ajeno listó las pestañas abiertas vía GET http://127.0.0.1:9222/json/list sin credenciales. Úsalo solo en una máquina donde confíes en todo lo que corre como tu usuario.
• El motor escucha solo en 127.0.0.1. Nunca lo expongas directamente.
• 🔴 mcp-server.js --host 0.0.0.0 existe y se enlazará a todas las interfaces. El código imprime una advertencia, pero para entonces el puerto ya está abierto. Usa 127.0.0.1 salvo que estés en una red privada de confianza (VPN/tailnet), y siempre con token.
• El servidor MCP HTTP exige un token y se niega a arrancar sin él.
• ./wb type no registra lo que se escribió — podría ser una contraseña.
• Los valores de las cookies nunca se imprimen, registran ni devuelven.
• 🔴 No la uses para introducir contraseñas, números de tarjeta o documentos de identidad. Inicia sesión a mano; Wbrowser reutiliza esa sesión.

Copia de seguridad de la sesión

./sync-session.sh export   cookies → almacenamiento cifrado
./sync-session.sh import   restaurar en otra máquina
./sync-session.sh status   qué hay respaldado

🔴 Las cookies son tan sensibles como las contraseñas — son el inicio de sesión. El script se niega a escribir si el destino no está realmente cifrado.

Variables de entorno

Después de reiniciar

Con una orden vuelve todo:

cd /ruta/a/Wbrowser && ./wb up

Levanta Chrome y el motor, y deja en paz al que ya esté corriendo. Luego ./wb status te dice si tus sesiones siguen ahí — viven en el perfil del disco, así que normalmente sí.

Arrancar el motor automáticamente

# Linux / WSL (servicio de usuario systemd)
./install.sh
systemctl --user status wbrowser

Esto cubre solo el motor. El navegador hay que abrirlo — es un proceso de escritorio, y una herramienta que abre sola una ventana del navegador al iniciar sesión no es una herramienta que quieras. Así que tras reiniciar sigue siendo ./wb up, o abre Chrome tú y deja que el motor ya en marcha se conecte.

En macOS y Windows todavía no hay instalador equivalente: ejecuta ./wb up cuando lo necesites. (Un plist de launchd y un acceso directo en la carpeta de Inicio son ambos pequeños; no están escritos porque nadie los ha medido en una máquina real, y este README no afirma lo que no se ha ejecutado.)

🔴 No te hagas un acceso directo que lance Chrome con --remote-debugging-port sobre tu perfil normal. Desde Chrome 136 (marzo de 2025) ahí la opción se ignora: Chrome arranca, el puerto nunca se abre y nada explica por qué. launch.js pasa un --user-data-dir dedicado, que es lo único que Chrome sigue aceptando. Déjaselo a ./wb up.

Limitaciones conocidas

• No incluye un bucle de lenguaje natural. El agente elige los selectores; read le da los reales, así que no tiene que adivinar.
• Solo Chrome/Chromium. Firefox no tiene CDP.
• Un puerto CDP = un proceso de Chrome. Los perfiles abiertos desde esa ventana son visibles; un Chrome lanzado por separado no lo es.

Mantenerse al día

./wb version          # tu versión, y si existe una versión más reciente

wbrowser 0.4.0
🔵 A newer release is available: v0.5.0 (you have v0.4.0)

Actualizar:

git pull && npm install                                  # si lo clonaste
git pull https://github.com/w-partners/Wbrowser main     # si hiciste un fork

🔵 Un fork no sigue a este repositorio: GitHub nunca envía nuestros commits a tu copia. El segundo comando es cómo los traes cuando quieras.

🔴 Si no puede llegar a GitHub, lo dice. Nunca te dirá que estás al día cuando en realidad no pudo preguntar. Para omitir la comprobación de red por completo: WBROWSER_NO_UPDATE_CHECK=1 — en ningún caso bloquea el comando.

Para enterarte sin ejecutar nada, usa Watch → Releases only en la página del repositorio.

Contribuir · seguridad

• CONTRIBUTING.md — las reglas que dieron forma a este código y cómo probarlo
• SECURITY.md — 🔴 el modelo de amenazas. Léelo antes de usarlo en una máquina compartida: el puerto de depuración de Chrome no tiene autenticación, así que cualquier proceso local que corra como tú puede manejar tus sesiones.

¿Encontraste un problema de seguridad? Abre un aviso privado en vez de un issue público.

Licencia

MIT — consulta LICENSE.