ZennoBrowser MCP Server

Servidor MCP ZennoBrowser — Automação de Navegador Antidetecção para Agentes de IA

Servidor MCP (Model Context Protocol) para a API pública do ZennoBrowser. Expõe recursos de automação de navegador e gerenciamento de perfis para agentes de IA, como Claude Desktop, Cursor e clientes MCP do VS Code.

Por que usar o Servidor MCP ZennoBrowser

• Cobertura completa da API pública. 57 ferramentas para workspaces, perfis, pastas, proxies, threads, instâncias de navegador, predefinições, extensões e informações do produto.
• Feito para escala. Ferramentas em lote criam, atualizam, iniciam e param vários perfis, proxies, threads e instâncias de navegador em uma única chamada.
• Cookies e impressões digitais. Importe, exporte e copie cookies entre perfis, e leia detalhes completos da impressão digital de qualquer perfil.
• Funciona com seu cliente de IA. Executa como um servidor stdio local no Claude Desktop, Cursor e VS Code.
• Grátis para começar. O ZennoBrowser está disponível para Windows. O plano START inclui perfis locais ilimitados e 2 navegadores simultâneos.

Início rápido

1. Inicie o ZennoBrowser no seu computador e obtenha um token de API na sua conta pessoal no ZennoLab.
2. Adicione o servidor ao seu cliente MCP usando uma das configurações em Instalação.
3. Pergunte ao seu agente, por exemplo: "Crie um novo perfil chamado 'Test Profile' e depois inicie uma instância de navegador para ele."

Ferramentas como delete_profile, bulk_delete_profile e delete_proxy não podem ser desfeitas. Revise as ações do agente antes de aprovar chamadas destrutivas.

Requisitos

• Node.js 20+
• ZennoBrowser em execução localmente
• Um token de API válido do ZennoBrowser

Instalação

O pacote é publicado como @zennolab/zennobrowser-mcp-server. Versões até 1.0.0 foram publicadas como zennobrowser-mcp-server sem escopo, que não recebe mais atualizações — substitua por @zennolab/zennobrowser-mcp-server na configuração do seu cliente MCP.

npx (sem necessidade de instalação)

Claude Desktop — edite claude_desktop_config.json:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor — adicione às configurações do MCP (.cursor/mcp.json ou Configurações → MCP):

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

VS Code (com suporte ao MCP do GitHub Copilot) — adicione a .vscode/mcp.json:

{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Instalação global

npm install -g @zennolab/zennobrowser-mcp-server@latest

Em seguida, use zennobrowser-mcp-server como comando em vez de npx ... @zennolab/zennobrowser-mcp-server:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "zennobrowser-mcp-server",
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
ZB_API_TOKEN	Sim	—	Token de autenticação para a API pública do ZennoBrowser
ZB_API_BASE_URL	Não	http://localhost:8160	URL base da API pública do ZennoBrowser

Ferramentas

Workspaces

Ferramenta	Descrição
get_workspaces	Lista workspaces acessíveis

Perfis

Ferramenta	Descrição
get_profiles	Lista perfis com filtragem e ordenação
get_profile	Obtém um único perfil com detalhes completos da impressão digital
create_profile	Cria um novo perfil
bulk_create_profile	Cria vários perfis de uma vez
update_profile	Atualiza configurações do perfil
delete_profile	Exclui um perfil
bulk_delete_profile	Exclui vários perfis
move_profile	Move perfis para uma pasta
recover_profile	Recupera um perfil de um estado inválido
force_unlock_profile	Força o desbloqueio de um perfil bloqueado na nuvem
import_cookies	Importa cookies (formato JSON ou Netscape)
export_cookies	Exporta cookies como JSON
copy_cookies	Copia cookies de um perfil para outro
bulk_update_profile_preset	Atribui uma predefinição a vários perfis
bulk_update_profile_proxy	Atualiza o proxy de vários perfis
bulk_update_profile_tags	Atualiza tags de vários perfis
cleanup_profile	Limpa o cache do perfil

Pastas de Perfis

Ferramenta	Descrição
get_profile_folders	Lista pastas de perfis
create_profile_folder	Cria uma pasta de perfis
update_profile_folder	Renomeia uma pasta de perfis
delete_profile_folder	Exclui uma pasta de perfis

Proxies

Ferramenta	Descrição
get_proxies	Lista proxies
create_proxy	Cria um proxy
bulk_create_proxy	Cria vários proxies
update_proxy	Atualiza um proxy
delete_proxy	Exclui um proxy
bulk_delete_proxy	Exclui vários proxies
change_mobile_proxy_ip	Aciona a rotação de IP para um proxy móvel

Pastas de Proxies

Ferramenta	Descrição
get_proxy_folders	Lista pastas de proxies
create_proxy_folder	Cria uma pasta de proxies
update_proxy_folder	Renomeia uma pasta de proxies
delete_proxy_folder	Exclui uma pasta de proxies

Threads

Ferramenta	Descrição
get_threads	Lista threads
create_thread	Cria uma thread
bulk_create_thread	Cria várias threads
continue_use_thread	Estende o tempo de vida da thread
bulk_continue_use_thread	Estende o tempo de vida de várias threads
stop_thread	Para uma thread
bulk_stop_thread	Para várias threads

Instâncias de Navegador

Ferramenta	Descrição
get_browser_instances	Lista instâncias de navegador ativas
start_browser_instance	Inicia uma instância de navegador para um perfil
bulk_start_browser_instance	Inicia instâncias de navegador para vários perfis
stop_browser_instance	Para uma instância de navegador
bulk_stop_browser_instance	Para várias instâncias de navegador
set_browser_instance_visibility	Mostra ou oculta uma janela do navegador

Predefinições e Extensões

Ferramenta	Descrição
get_presets	Lista predefinições
create_preset	Cria uma predefinição
delete_preset	Exclui uma predefinição
get_extensions	Lista extensões
create_extension_from_web	Adiciona uma extensão da Chrome Web Store
create_extension_from_file	Adiciona uma extensão de um arquivo local .crx ou .zip
delete_extension	Remove uma extensão

Produto

Ferramenta	Descrição
get_product_version	Obtém a versão do ZennoBrowser
get_browser_version	Obtém a versão do mecanismo do navegador
get_limits	Obtém os limites de recursos do workspace
get_tariff	Obtém informações sobre a tarifa atual

Exemplos de Prompts

Criar um perfil e iniciar o navegador:

Crie um novo perfil chamado "Test Profile" e depois inicie uma instância de navegador para ele.

Fluxo completo de ponta a ponta:

Crie um perfil chamado "Scraper", crie um proxy com URI "socks5://user:pass@1.2.3.4:1080", atribua o proxy ao perfil, crie uma thread e depois inicie uma instância de navegador para o perfil usando essa thread.

Operações em lote:

Liste todos os perfis no meu workspace padrão e exclua qualquer um que não tenha sido usado nos últimos 30 dias.

Gerenciamento de cookies:

Exporte cookies do perfil "Session A" e importe-os para o perfil "Session B".

Solução de Problemas

Error: Missing required environment variable ZB_API_TOKEN Defina a variável de ambiente ZB_API_TOKEN com o token da API do ZennoBrowser.

Error: connect ECONNREFUSED 127.0.0.1:8160 O ZennoBrowser não está em execução ou a API pública não está funcionando. Se a API estiver em uma porta diferente, defina ZB_API_BASE_URL=http://localhost:<port>.

Tool calls return errors with "Unauthenticated" Seu token de API é inválido ou expirou. Gere um novo token na conta pessoal no ZennoLab.

npx baixa o pacote toda vez Instale globalmente com npm install -g @zennolab/zennobrowser-mcp-server@latest para evitar o re-download a cada inicialização.

Relacionados

• ZennoBrowser — o navegador antidetecção que este servidor controla
• Documentação do ZennoLab — guias do produto (em russo)
• Fórum da comunidade ZennoBrowser — perguntas, relatórios de bugs e solicitações de recursos
• zennoposter-mcp — servidores MCP para ZennoPoster e ZennoDroid

Licença

MIT