Scalebrowser

Scalebrowser ejecuta perfiles de navegador persistentes en tus propias máquinas para que los agentes de IA permanezcan conectados, superen la verificación y completen trabajo real.

Documentación

Scalebrowser

Scalebrowser MCP

¿Tu agente se bloqueó, se detuvo en un inicio de sesión o se rindió ante un captcha? Scalebrowser le da a cada agente de IA su propio navegador aislado con una identidad persistente, que se ejecuta en tu propia máquina en lugar de en la nube de un proveedor. Permanece conectado, maneja el captcha, escribe como un humano y puedes tomar el control cuando quieras.

Este repositorio conecta ese navegador a tu agente a través de MCP: configuraciones listas para copiar y pegar para cada cliente que cubre la documentación, un pequeño puente stdio y ejemplos ejecutables del SDK.

Antes de comenzar

  • Windows 10 u 11, de 64 bits, con una GPU real. Scalebrowser es una aplicación de escritorio que se ejecuta en tu máquina. No existe un modo alojado.
  • Una cuenta de Scalebrowser con un plan activo. La forma de acceso es una prueba de 7 días con un navegador. Se requiere un método de pago por adelantado. Planes y precios

Gratis, sin necesidad de cuenta: scalebrowser.net/check mide cómo se ve tu navegador actual desde el exterior, y scalebrowser.net/ai-agent-check mide lo que tu herramienta de automatización hace con él. Apunta tu agente al segundo y observa lo que un sitio web puede saber.

Pruébalo en cinco minutos

  1. Inicia sesión en scalebrowser.net, abre Descargar y ejecuta el instalador. Se instala para el usuario actual y no solicita derechos de administrador. SmartScreen advierte en el primer inicio: elige Más información y luego Ejecutar de todos modos.

  2. Inicia la aplicación y presiona Iniciar sesión. La aplicación luego descarga y verifica el motor del navegador, lo cual debe terminar antes de que pueda iniciarse cualquier perfil.

  3. Copia tu token de API desde Configuración, General, Conectar un agente.

  4. Conecta tu agente. Para Claude Code es un solo comando:

    claude mcp add --transport http scalebrowser http://127.0.0.1:8787/v1/mcp \
      --header "Authorization: Bearer $SCALEBROWSER_TOKEN"
    
  5. Pídele algo:

    Abre news.ycombinator.com en un perfil de Scalebrowser, lee la portada y dime las tres historias con más comentarios.

El agente toma un arrendamiento, que reserva un perfil e inicia su navegador, abre la página, lee un mapa de texto de la misma y responde. Luego pídele que libere el perfil.

Conecta tu cliente

Cada archivo a continuación es la configuración de la documentación oficial, lista para copiar. Reemplaza <token> con tu token de API y <you> con tu nombre de usuario de Windows. Dónde va cada archivo, y las dos grafías que fallan sin error, está en clients/README.md.

ClienteConfiguración
Claude Codeclaude-code.mcp.json, el comando anterior, o el plugin
Aplicación de escritorio de Claudeclaude-desktop.json
Cursorcursor.mcp.json
Codexcodex.config.toml
GitHub Copilot en VS Codegithub-copilot.mcp.json
Antigravityantigravity.mcp_config.json
Claude Code dentro de WSLwsl-claude-code.json
Claude en la web, Grok, ChatGPT y otros servicios de chat en la nubeSin archivo: llegan a tu máquina a través del acceso remoto

Lo que obtiene tu agente

El agente trabaja a partir de un mapa de texto de la página y se dirige a los elementos por referencia. Mira la página una vez y luego solo lo que se movió. En más de 75 pasos en la misma página, eso gasta 11 veces menos en tokens de modelo que Playwright MCP.

  • Inicio de sesión: credential_fill inicia sesión con un inicio de sesión almacenado en el perfil, y credential_new se registra con una contraseña que Scalebrowser genera y almacena. El agente nunca ve el valor.
  • Códigos de confirmación: read_inbox lee los códigos enviados a la dirección vinculada al perfil, y inbox_open_link abre un enlace de un mensaje.
  • Desafíos: press_and_hold, click y cuatro herramientas de medición funcionan a través de desafíos de verificación con la misma entrada humana. El estado medido por tipo de desafío indica qué pasa y qué no.
  • Prueba del trabajo: record y video convierten una ejecución en una película, y cada llamada de herramienta se convierte en un paso en el rastro de la ejecución.

La lista completa está en la referencia de herramientas. Lo que un agente puede hacer lo decide la aplicación, no el cliente.

El puente

bridge/scalebrowser-mcp.mjs es un servidor MCP stdio sin dependencias. Con la aplicación Scalebrowser ejecutándose en la misma máquina Windows, retransmite cada mensaje al propio endpoint MCP de la aplicación, usando la dirección y el token que la aplicación guarda en %LOCALAPPDATA%\Scalebrowser. Sin la aplicación, responde con la lista de herramientas e instrucciones de instalación. Ese segundo modo es lo que ven los directorios de MCP cuando construyen este repositorio.

Los clientes que hablan HTTP no lo necesitan: usa las configuraciones anteriores. Para un cliente que solo inicia servidores a través de stdio:

node bridge/scalebrowser-mcp.mjs

Necesita Node 22 o más reciente. --data-dir lo apunta a otro directorio de datos, y SCALEBROWSER_TOKEN anula el archivo de token.

Como extensión de escritorio de Claude

Cada versión incluye el puente como un MCP Bundle, scalebrowser-<version>.mcpb. Descárgalo en la máquina Windows donde se ejecuta la aplicación y ábrelo con la aplicación de escritorio de Claude, o elige Configuración, Extensiones, Instalar extensión allí. No necesita configuración: encuentra la aplicación y su token por sí mismo.

El puente también está listado en el MCP Registry como net.scalebrowser/mcp.

Como plugin de Claude Code

Este repositorio también es un plugin de Claude Code. En Claude Code en la máquina Windows donde se ejecuta la aplicación:

/plugin marketplace add blackdiamond-labs/scalebrowser-mcp
/plugin install scalebrowser@scalebrowser

El plugin inicia el puente, por lo que necesita Node 22 o más reciente y ningún token en ningún archivo. También agrega una habilidad que enseña al agente el ciclo de arrendamiento, lectura, acción y liberación, a mirar antes de repetir una acción fallida y a iniciar sesión con inicios de sesión almacenados en lugar de pedir una contraseña.

Ejemplos del SDK

La misma tarea pequeña en ambos SDK: abrir Hacker News en un perfil e imprimir las tres historias principales. Ejecútalos en la máquina Windows donde se ejecuta la aplicación, con tu token en SCALEBROWSER_TOKEN.

cd examples/node
npm ci
node top-stories.mjs
cd examples/python
pip install --require-hashes -r requirements.txt
python top_stories.py

Ambos usan los SDK publicados, @scalebrowser/sdk en npm y scalebrowser en PyPI. La documentación del SDK cubre toda la superficie.

Política de privacidad

El puente no recopila nada, no almacena nada y no envía nada a nosotros ni a nadie más.

  • Lo que lee: la dirección y el token de API que la aplicación Scalebrowser guarda en su directorio de datos en tu máquina, %LOCALAPPDATA%\Scalebrowser a menos que pases --data-dir.
  • A dónde van los mensajes: solo a la aplicación Scalebrowser en la misma máquina. Rechaza cualquier dirección que no sea la dirección de bucle local de esta máquina, por lo que el token y los mensajes de tu agente nunca salen de la computadora a través del puente.
  • Lo que conserva: nada. Mantiene la sesión con la aplicación en memoria y la termina cuando tu cliente se desconecta. No escribe archivos ni registros además de las líneas de estado que imprime en el error estándar.
  • Terceros: ninguno. El puente no tiene dependencias, ni telemetría, ni acceso a la red propio más allá de la conexión de bucle local con la aplicación.

La aplicación Scalebrowser en sí, la cuenta y el sitio web están cubiertos por la política de privacidad de Scalebrowser. Las preguntas sobre privacidad van a support@scalebrowser.net.

Preguntas y soporte

Escribe a support@scalebrowser.net. Los problemas están desactivados en este repositorio; CONTRIBUTING.md explica por qué.

Enlaces

Licencia

Todo en este repositorio tiene licencia MIT. La aplicación Scalebrowser y su motor de navegador son un producto separado con licencia.