Anchor Browser

Anchor Browser (https://anchorbrowser.io) é uma infraestrutura segura para agentes de uso de computador — navegadores em nuvem furtivos, autenticação, bypass de captcha e um servidor MCP hospedado para Cursor, Claude e Windsurf.

Documentação

MCP Logo

Servidor MCP do Navegador

Um servidor Model Context Protocol (MCP) que fornece capacidades de automação de navegador usando o serviço de navegador remoto do Anchor Browser com Playwright. Este servidor permite que LLMs interajam com páginas da web através dos navegadores baseados em nuvem da Anchor, com proxies integrados, recursos de stealth e capacidades avançadas.

Principais Recursos

  • Execução Remota do Navegador: Usa a infraestrutura em nuvem do Anchor Browser em vez de navegadores locais
  • Proxies Integrados: Rotação automática de proxy residencial e segmentação geográfica
  • Stealth e Anti-Detecção: Impressão digital avançada do navegador e detecção anti-bot
  • Rápido e leve: Usa a árvore de acessibilidade do Playwright, não entrada baseada em pixels
  • Amigável para LLMs: Não precisa de modelos de visão, opera puramente em dados estruturados
  • Aplicação determinística de ferramentas: Evita ambiguidades comuns em abordagens baseadas em capturas de tela

Requisitos

  • Node.js 18 ou mais recente
  • Chave de API do Anchor Browser (Obtenha uma aqui)
  • VS Code, Cursor, Windsurf, Claude Desktop, Goose ou qualquer outro cliente MCP

Começando

1. Clone e Compile

Como este é um servidor MCP de navegador personalizado, você precisa compilá-lo localmente:

# Clone the repository
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# Install dependencies and build
npm install
npm run build

2. Obtenha Sua Chave de API da Anchor

  1. Cadastre-se em anchorbrowser.io
  2. Obtenha sua chave de API no painel
  3. Copie sua chave de API (começa com sk-)

3. Configure o Cliente MCP

Cursor

Adicione ao seu ~/.cursor/mcp.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

VS Code

Adicione à sua configuração MCP:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

4. Reinicie Seu Cliente MCP

Após atualizar a configuração, reinicie seu cliente MCP (Cursor, VS Code, etc.) para carregar o novo servidor.

Opções de Configuração

O servidor MCP do navegador suporta apenas opções de configuração essenciais:

node cli.js --help

Opções Disponíveis:

  • --host <host> - Host para vincular o servidor (padrão: localhost, use 0.0.0.0 para todas as interfaces)
  • --port <port> - Porta para escutar no transporte HTTP (modo Docker/servidor)

Exemplo com Opções:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js",
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Modo Servidor HTTP (Docker):

Para ambientes Docker ou servidor headless:

# Run as HTTP server
ANCHOR_API_KEY="sk-your-key" node cli.js --port 8931 --host 0.0.0.0

Em seguida, configure seu cliente MCP para usar o endpoint HTTP:

{
  "mcpServers": {
    "anchor-browser": {
      "url": "http://localhost:8931/mcp"
    }
  }
}

Por Que Tão Poucas Opções?

Como o Anchor Browser lida com todo o gerenciamento complexo do navegador remotamente, a maioria das opções tradicionais de navegador é desnecessária:

  • Sem seleção de navegador - A Anchor usa navegadores remotos otimizados
  • Sem configuração de proxy - A Anchor fornece rotação de proxy integrada
  • Sem gerenciamento de perfil de navegador - Tratado pela infraestrutura da Anchor
  • Sem filtragem de rede - Use o painel da Anchor para controles avançados
  • Sem opções de viewport/dispositivo - Configure-as através da API do Anchor Browser

Isso mantém o servidor MCP simples e focado no que importa: conectar-se ao serviço de navegador remoto da Anchor.

Como Funciona

  1. Criação de Sessão do Navegador: Quando você usa ferramentas de navegador, o servidor MCP chama a API da Anchor para criar uma sessão de navegador remota
  2. Conexão Remota: Conecta-se ao navegador remoto via WebSocket usando o Chrome DevTools Protocol (CDP)
  3. Execução de Ferramentas: Toda a automação do navegador acontece na infraestrutura em nuvem da Anchor
  4. Proxy e Stealth: Rotação automática de proxy residencial e recursos avançados de anti-detecção
  5. Gerenciamento de Sessão: Cada sessão é isolada e pode ser visualizada ao vivo pelo painel da Anchor

Benefícios em Relação aos Navegadores Locais

🌐 Rede Global de Proxies

  • Rotação automática de proxy residencial
  • Segmentação geográfica para diferentes regiões
  • Nenhuma configuração de proxy necessária

🛡️ Stealth Avançado

  • Proteção de impressão digital do navegador
  • Contorno de detecção anti-bot
  • Ambientes reais de navegador

☁️ Infraestrutura em Nuvem

  • Sem dependências locais de navegador
  • Versões consistentes de navegador
  • Execução escalável

📊 Monitoramento e Depuração

  • Visualização ao vivo das sessões do navegador
  • Gravações e rastreamentos de sessão
  • Registro de solicitações de rede

Ferramentas Disponíveis

O servidor MCP do navegador fornece todas as ferramentas padrão de automação de navegador:

Automação Principal

  • anchor_navigate - Navegar para URLs
  • anchor_click - Clicar em elementos
  • browser_type - Digitar texto em campos de entrada
  • browser_snapshot - Obter árvore de acessibilidade da página
  • browser_take_screenshot - Tirar capturas de tela
  • browser_evaluate - Executar JavaScript
  • browser_wait_for - Aguardar condições

Gerenciamento de Abas

  • browser_tab_new - Abrir novas abas
  • browser_tab_list - Listar abas abertas
  • browser_tab_select - Alternar entre abas
  • browser_tab_close - Fechar abas

Recursos Avançados

  • browser_file_upload - Enviar arquivos
  • browser_handle_dialog - Lidar com alertas/confirmações
  • browser_network_requests - Visualizar tráfego de rede
  • browser_pdf_save - Gerar PDFs (com --caps=pdf)

Solução de Problemas

Chave de API Inválida

Error: Missing ANCHOR_API_KEY environment variable

Solução: Certifique-se de que sua chave de API esteja configurada corretamente na configuração do MCP.

Erros de Compilação

npm run build

Solução: Certifique-se de ter Node.js 18+ e execute npm install primeiro.

Problemas de Conexão

Verifique os logs do MCP para respostas da API da Anchor e status da conexão WebSocket.

Limites de Sessão

Cada chave de API da Anchor tem limites de sessão. Verifique seu painel em anchorbrowser.io para uso.

Desenvolvimento

Para modificar ou estender o servidor MCP do navegador:

# Make changes to TypeScript files in src/
# Then rebuild
npm run build

# Test your changes
node cli.js --help

O servidor usará automaticamente os navegadores remotos da Anchor para todas as operações, fornecendo os benefícios da automação de navegador baseada em nuvem com recursos avançados de proxy e stealth.

Licença

Este projeto é licenciado sob a Apache License 2.0 - consulte o arquivo LICENSE para obter detalhes.

Suporte