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 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
-
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.
-
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.
-
Copie seu token de API em Configurações, Geral, Conectar um agente.
-
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" -
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.
| Cliente | Configuração |
|---|---|
| Claude Code | claude-code.mcp.json, o comando acima ou o plugin |
| Aplicativo de desktop Claude | claude-desktop.json |
| Cursor | cursor.mcp.json |
| Codex | codex.config.toml |
| GitHub Copilot no VS Code | github-copilot.mcp.json |
| Antigravity | antigravity.mcp_config.json |
| Claude Code dentro do WSL | wsl-claude-code.json |
| Claude na web, Grok, ChatGPT e outros serviços de chat em nuvem | Sem 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_fillentra com um login armazenado no perfil, ecredential_newcria uma conta com uma senha que o Scalebrowser gera e armazena. O agente nunca vê o valor. - Códigos de confirmação:
read_inboxlê os códigos enviados ao endereço vinculado ao perfil, einbox_open_linkabre um link de uma mensagem. - Desafios:
press_and_hold,clicke 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:
recordevideotransformam 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%\Scalebrowsera 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.