Scalebrowser

O Scalebrowser executa perfis de navegador persistentes nas suas próprias máquinas, para que agentes de IA permaneçam conectados, passem na verificação e concluam trabalhos reais.

Documentação

Scalebrowser

Scalebrowser MCP

Seu agente foi bloqueado, parou em um login ou desistiu de um captcha? O Scalebrowser dá a cada agente de IA seu próprio navegador isolado com identidade persistente, rodando na sua própria máquina em vez de na nuvem de um fornecedor. Ele permanece conectado, lida com o captcha, digita como um humano, e você pode assumir o controle quando quiser.

Este repositório conecta esse navegador ao seu agente via MCP: configurações prontas para copiar para cada cliente que a documentação cobre, uma pequena ponte stdio e exemplos executáveis de SDK.

Antes de começar

  • Windows 10 ou 11, 64 bits, com GPU real. O Scalebrowser é um aplicativo de desktop que roda na sua máquina. Não há modo hospedado.
  • Uma conta Scalebrowser com plano ativo. A forma de entrada é um teste de 7 dias com um navegador. Um método de pagamento é exigido antecipadamente. Planos e preços

Grátis, sem conta necessária: scalebrowser.net/check mede como seu navegador atual parece de fora, e scalebrowser.net/ai-agent-check mede o que sua ferramenta de automação faz com ele. Aponte seu agente para o segundo e veja o que um site pode descobrir.

Experimente em cinco minutos

  1. Entre em scalebrowser.net, abra Download e execute o instalador. Ele instala para o usuário atual e não pede direitos de administrador. O SmartScreen avisa no primeiro uso: escolha Mais informações e depois Executar mesmo assim.

  2. Inicie o aplicativo e pressione Entrar. O aplicativo então baixa e verifica o mecanismo do navegador, o que precisa terminar antes que qualquer perfil possa iniciar.

  3. Copie seu token de API em Configurações, Geral, Conectar um agente.

  4. Conecte seu agente. Para o Claude Code, é um único comando:

    claude mcp add --transport http scalebrowser http://127.0.0.1:8787/v1/mcp \
      --header "Authorization: Bearer $SCALEBROWSER_TOKEN"
    
  5. Peça algo a ele:

    Abra news.ycombinator.com em um perfil Scalebrowser, leia a página inicial e me diga as três histórias com mais comentários.

O agente obtém uma concessão, que reserva um perfil e inicia seu navegador, abre a página, lê um mapa de texto dela e responde. Depois peça a ele para liberar o perfil.

Conecte seu cliente

Cada arquivo abaixo é a configuração da documentação oficial, pronta para copiar. Substitua <token> pelo seu token de API e <you> pelo seu nome de usuário do Windows. Onde cada arquivo vai, e as duas grafias que falham sem erro, está em clients/README.md.

ClienteConfiguração
Claude Codeclaude-code.mcp.json, o comando acima ou o plugin
Aplicativo de desktop Claudeclaude-desktop.json
Cursorcursor.mcp.json
Codexcodex.config.toml
GitHub Copilot no VS Codegithub-copilot.mcp.json
Antigravityantigravity.mcp_config.json
Claude Code dentro do WSLwsl-claude-code.json
Claude na web, Grok, ChatGPT e outros serviços de chat em nuvemSem arquivo: eles alcançam sua máquina por meio de acesso remoto

O que seu agente recebe

O agente trabalha a partir de um mapa de texto da página e endereça elementos por referência. Ele olha a página uma vez e depois apenas o que mudou. Em mais de 75 etapas na mesma página, isso gasta 11x menos em tokens de modelo do que o Playwright MCP.

  • Entrando: credential_fill entra com um login armazenado no perfil, e credential_new cria uma conta com uma senha que o Scalebrowser gera e armazena. O agente nunca vê o valor.
  • Códigos de confirmação: read_inbox lê os códigos enviados ao endereço vinculado ao perfil, e inbox_open_link abre um link de uma mensagem.
  • Desafios: press_and_hold, click e quatro ferramentas de medição funcionam com desafios de verificação com a mesma entrada humana. O status medido por tipo de desafio diz o que passa e o que não passa.
  • Prova do trabalho: record e video transformam uma execução em um filme, e cada chamada de ferramenta vira uma etapa no rastro da execução.

A lista completa está na referência de ferramentas. O que um agente pode fazer é decidido pelo aplicativo, não pelo cliente.

A ponte

bridge/scalebrowser-mcp.mjs é um servidor MCP stdio sem dependências. Com o aplicativo Scalebrowser rodando na mesma máquina Windows, ele retransmite cada mensagem para o endpoint MCP do próprio aplicativo, usando o endereço e o token que o aplicativo mantém em %LOCALAPPDATA%\Scalebrowser. Sem o aplicativo, ele responde com a lista de ferramentas e instruções de instalação. Esse segundo modo é o que os diretórios MCP veem quando constroem este repositório.

Clientes que falam HTTP não precisam dele: use as configurações acima. Para um cliente que só inicia servidores via stdio:

node bridge/scalebrowser-mcp.mjs

Ele precisa do Node 22 ou mais recente. --data-dir aponta para outro diretório de dados, e SCALEBROWSER_TOKEN substitui o arquivo de token.

Como extensão do desktop Claude

Cada versão carrega a ponte como um MCP Bundle, scalebrowser-<version>.mcpb. Baixe-o na máquina Windows onde o aplicativo roda e abra-o com o aplicativo de desktop Claude, ou escolha Configurações, Extensões, Instalar Extensão lá. Ele não precisa de configuração: encontra o aplicativo e seu token sozinho.

A ponte também está listada no MCP Registry como net.scalebrowser/mcp.

Como plugin do Claude Code

Este repositório também é um plugin do Claude Code. No Claude Code na máquina Windows onde o aplicativo roda:

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

O plugin inicia a ponte, então precisa do Node 22 ou mais recente e de nenhum token em qualquer arquivo. Ele também adiciona uma habilidade que ensina o agente o ciclo de concessão, leitura, ação e liberação, a olhar antes de repetir uma ação falha e a entrar com logins armazenados em vez de pedir uma senha.

Exemplos de SDK

A mesma pequena tarefa em ambos os SDKs: abrir o Hacker News em um perfil e imprimir as três principais histórias. Execute-os na máquina Windows onde o aplicativo roda, com seu token em 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 usam os SDKs publicados, @scalebrowser/sdk no npm e scalebrowser no PyPI. A documentação do SDK cobre toda a superfície.

Política de Privacidade

A ponte não coleta nada, não armazena nada e não envia nada para nós ou para qualquer outra pessoa.

  • O que ela lê: o endereço e o token de API que o aplicativo Scalebrowser mantém em seu diretório de dados na sua máquina, %LOCALAPPDATA%\Scalebrowser a menos que você passe --data-dir.
  • Para onde as mensagens vão: apenas para o aplicativo Scalebrowser na mesma máquina. Ela recusa qualquer endereço que não seja o endereço de loopback da própria máquina, então o token e as mensagens do seu agente nunca saem do computador pela ponte.
  • O que ela mantém: nada. Ela mantém a sessão com o aplicativo em memória e a encerra quando seu cliente desconecta. Ela não escreve arquivos nem logs além das linhas de status que imprime no erro padrão.
  • Terceiros: nenhum. A ponte não tem dependências, nem telemetria, nem acesso à rede próprio além da conexão de loopback com o aplicativo.

O próprio aplicativo Scalebrowser, a conta e o site são cobertos pela política de privacidade do Scalebrowser. Perguntas sobre privacidade vão para support@scalebrowser.net.

Perguntas e suporte

Escreva para support@scalebrowser.net. As issues estão desativadas neste repositório; CONTRIBUTING.md explica o porquê.

Links

Licença

Tudo neste repositório é licenciado sob MIT. O aplicativo Scalebrowser e seu mecanismo de navegador são um produto separado e licenciado.