browser-ipc-cdp weekly downloads statistics

browser-ipc-cdp

Control remoto de navegadores Chromium (Brave, Chrome, Edge) via IPC con CDP dinamico. Abre tu navegador real con todas tus sesiones, detecta o asigna puerto automaticamente, configura portproxy/firewall para WSL, y actualiza el MCP de Claude Code. Sin puertos fijos, sin hacks de registry, sin configuracion manual.

Despues /mcp en Claude Code y listo. El wrapper resuelve el puerto dinamico solo, no hay que reescribir .mcp.json cuando cambia.

Novedades

v3.15.0 — el navegador ya no se queda "sin internet"

Si alguna vez, usando el MCP, una pestaña se quedaba a medio cargar (sin error en consola, sin nada en el log) y parecia que Brave habia perdido internet: eso era un bug, y esta arreglado. Actualiza con:

Eran dos causas, las dos en la intercepcion de requests (setup_request_interception, mock_api, block_resources, capture_payloads, add_auth_header, redirect_to_local, throttle_api):

1. Requests pausadas que nadie reanudaba. Al activar la intercepcion, el navegador puede mandar la confirmacion y la primera rafaga de requests pausadas juntas; el manejador todavia no estaba escuchando y esas requests se quedaban esperando para siempre. Era intermitente porque dependia del timing de la red local. → El manejador ahora se registra antes de activar la intercepcion.

2. Cerrar el MCP dejaba la intercepcion puesta. Si el MCP moria (cerrar Claude Code, reiniciar la sesion) con la intercepcion activa, nunca se desactivaba en el navegador. → Ahora hay una limpieza que corre al salir por cualquier via y revierte todo lo que los tools hayan dejado puesto: intercepcion, stealth, monitores y el overlay.

Si te vuelve a pasar con una version anterior, el remedio manual es llamar clear_request_interception o cerrar la pestaña.

Detalle tecnico completo: docs/ARQUITECTURA-MVC.md seccion 13.

Instalacion

browser-ipc-cdp se puede usar de tres formas. Elige la que prefieras.

1. npm — Claude Code (via npx)

Luego /mcp en Claude Code para conectar el server brave. El instalador detecta/abre el navegador y configura el .mcp.json solo.

1. Plugin de Claude Code (desde git, sin npm)

Instalable directo desde este repo:

Reinicia Claude Code (o corre /reload-plugins) para que cargue el MCP del plugin. La primera llamada baja chrome-devtools-mcp con npx una sola vez (despues queda cacheado).

Funciona tanto en el CLI de Claude Code como en la app de escritorio (Ajustes -> Plugins -> Agregar marketplace, con alexis14kl/browser-ipc-cdp o la URL de git). Nota: el hosting de plugins de claude.ai rechaza un directorio bin/ de nivel superior en la raiz del plugin (sus ejecutables entrarian al PATH sin aparecer en la superficie de aprobacion de admin), por eso el CLI vive en cli.js en la raiz y no en bin/.

1. Claude Desktop — extension .mcpb (un clic)

1. Descarga browser-ipc-cdp.mcpb desde Releases. 2. En Claude Desktop: Ajustes -> Extensiones -> arrastra el archivo (o doble clic). 3. Configura el puerto del proxy (9333) y el overlay del cursor, y activa la extension.

Trae chrome-devtools-mcp incluido (no necesita npm ni npx) y usa el Node que trae Claude Desktop.

Nota: no corras las tres a la vez contra el mismo navegador — todas usan el proxy en el puerto 9333 y colisionarian. Elige una por entorno (o cambia el puerto en la config del bundle/plugin).

Por que usarlo

• Mantiene tus sesiones reales: cookies, 2FA, extensiones, tabs abiertas — nada se pierde • Pasa Cloudflare sin captcha: usa tu cookie cf_clearance ya validada, no parece bot • Cross-browser: Brave, Chrome, Edge, Chromium • Puerto dinamico: cero conflictos, OS asigna puerto libre via DevToolsActivePort IPC • Auto-config WSL: portproxy + firewall + .mcp.json sin pasos manuales • DevTools completo: Network, Console, Performance, Lighthouse, Coverage, Heap snapshots

Acceso completo a Red (CDP)

browser-ipc-cdp expone el subsistema Network del navegador. Cualquier request HTTP/HTTPS, WebSocket, XHR o fetch se puede observar, interceptar, modificar o bloquear.

| Capacidad | Metodo CDP |

| Listar requests | Network.requestWillBeSent | | Leer body response | Network.getResponseBody | | Modificar headers | Network.setExtraHTTPHeaders | | Bloquear URLs (ads/tracking) | Network.setBlockedURLs | | Mock responses | Fetch.fulfillRequest | | Interceptar requests | Fetch.requestPaused | | Throttling (3G/offline) | Network.emulateNetworkConditions | | Cookies CRUD | Network.getCookies / setCookie / deleteCookies | | Espiar WebSockets | Network.webSocketFrameSent/Received | | Auth challenge | Fetch.authRequired |

📖 Documentacion completa de Network + ejemplos

⚠️ Uso responsable

Esta herramienta esta destinada a testing personal, automatizacion propia y desarrollo. El usuario es responsable de:

• Usarla solo en navegadores y cuentas que le pertenecen • Cumplir con los Terms of Service de los sitios que automatice • Respetar leyes locales sobre privacidad y acceso a sistemas

NO se autoriza el uso para:

• Acceso no autorizado a sistemas ajenos • Scraping que viole ToS de un servicio • Bypass de protecciones de seguridad sin permiso del owner • Automatizacion de cuentas de terceros sin consentimiento

Distribuida bajo licencia MIT — el autor (Alexis Malambo) no se hace responsable del mal uso por terceros (clausula AS IS, WITHOUT WARRANTY OF ANY KIND).

💖 Apoya el proyecto

Cree browser-ipc-cdp como solucion de IA para mantener tus sesiones reales activas y que un asistente (Claude Code) pueda controlar tu navegador via el MCP de Brave — sin perder cookies, 2FA ni extensiones.

Es software libre (MIT) y lo mantengo en mi tiempo. Si te sirvio o te ahorro trabajo, podes invitarme un cafe:

👉 paypal.com/donate → rapalexism@gmail.com

Cualquier aporte ayuda a seguir mejorando el proyecto. Gracias! 🙌

Documentacion

Que es esto?…