Arachne MCP Server

🕷️ 9 ferramentas MCP para web scraping, automação de navegador, visão, transcrição e consulta RAG

Documentação

🕷️ Arachne MCP Server

🌐 Inglês · 🇧🇷 Português

49 ferramentas MCP para raspagem de web, automação de navegador, visão computacional, transcrição de áudio, RAG, Pesquisa de Sentimento Social e Teste de Regressão Visual (VRT) — o Oito Olhos (Spider's Eight Eyes) — tudo através da API Arachne.

Desenvolvido por Arachne. Funciona com Claude Desktop, Cursor, Codex CLI, Hermes e qualquer cliente MCP.

✨ Ferramentas (49)

🔍 Web e Dados

Ferramenta	O que faz	Melhor para
`arachne_search`	Pesquisa na web via DuckDuckGo	Pesquisa, coleta de leads
`arachne_scrape`	Markdown limpo de URLs	Páginas estáticas, blogs, docs
`arachne_extract`	Extrai QUALQUER formato (áudio, vídeo, PDF, YouTube)	Canivete suíço
`arachne_browser_extract`	Navegador real com evasão de Cloudflare/CAPTCHA	Sites que bloqueiam scrapers
`arachne_browser_run`	Ações de navegador (clique, digitar, login)	Automação de formulários
`arachne_screenshot`	Captura de tela de uma URL (página inteira ou viewport)	Evidência visual
`arachne_record`	Grava um screencast de uma página (.webm)	Interações, demonstrações
`arachne_torrent_extract`	Extrai links magnet de sites de torrent BR	Aquisição de torrents
`arachne_download`	Download universal (URL, repo, PyPI, npm)	Buscar qualquer artefato
`arachne_query`	Pergunte à sua base de conhecimento RAG	Chatbot com seus dados

🔍 Pesquisa de Sentimento Social

Ferramenta	O que faz	Melhor para
`arachne_social_research`	Pesquisa o que as pessoas REALMENTE dizem (HN/Reddit/YouTube, últimos N dias) + juiz de IA via VLM local	Hype vs realidade, reclamações, sentimento de mercado

👁️ Visão e Áudio

Ferramenta	O que faz	Melhor para
`arachne_vision`	Análise de imagem: OCR, cores, rostos, descrição por IA	Extração de texto de fotos
`arachne_screenshot_vision`	Captura de tela + pipeline completo de visão	Inspeção visual de páginas
`arachne_pdf_vision`	Extrai imagens de PDF + análise de visão	PDFs escaneados
`arachne_analyze_video`	Metadados de vídeo: cores, OCR, geometria, VQA, áudio	Compreensão de vídeo
`arachne_transcribe`	Transcrição de áudio/vídeo/YouTube com Whisper	Podcast, reunião, vídeo

🕷️ Oito Olhos — Teste de Regressão Visual (VRT)

Ferramenta	O que faz	Melhor para
`arachne_visual_snapshot`	Captura URL → cria baseline (1ª vez) ou compara	Testes visuais idempotentes
`arachne_visual_diff`	Compara com baseline → diff + veredito semântico	Verificação pós-implantação
`arachne_visual_gates`	Auditoria determinística: overflow, colisão de texto, erros de JS	Sem chave, sem baseline
`arachne_visual_report`	Suíte de testes → HTML lado a lado	Revisão consolidada
`arachne_visual_approve`	Promove atual → novo baseline	Aceitar uma mudança esperada
`arachne_visual_list`	Lista baselines + status	Monitorar o que existe
`arachne_visual_video`	VRT de vídeo: grava screencast + compara (animações)	Hover, carrosséis, transições
`arachne_visual_video_report`	Suíte de vídeo → relatório HTML interativo	Revisão de regressão de animações

🤖 Desktop e Agêntico

Ferramenta	O que faz	Melhor para
`arachne_desktop`	Controle de desktop (janelas, digitar, tecla, clique)	Automação de SO
`arachne_desktop_os`	Desktop agêntico com "olho" VLM (captura de tela + descrever)	Ver antes de agir
`arachne_observe`	Captura de tela + caixas delimitadoras numeradas clicáveis	Navegação de agente GUI

📦 GitHub / GitLab / Pacotes

Ferramenta	O que faz
`arachne_repo_download`	Baixar repositório GitHub como zip (branch/token)
`arachne_repo_fork`	Fazer fork de um repositório GitHub
`arachne_repo_forks`	Listar forks por estrelas
`arachne_repo_index`	Baixar + indexar repositório no RAG
`arachne_releases`	Listar releases do GitHub com assets
`arachne_release_download`	Baixar um asset de release
`arachne_pypi_download`	Baixar pacote PyPI (sdist/wheel)
`arachne_npm_download`	Baixar tarball de pacote npm
`arachne_gitlab_download`	Baixar arquivo de projeto GitLab
`arachne_github_trending`	Repositórios em alta no GitHub + desenvolvedores (período/idioma, custo zero)
`arachne_github_user_prs`	PRs criados por um usuário (filtros desde/até)
`arachne_github_user_activity`	Atividade mensal + tipos de evento para um usuário
`arachne_github_repo_metadata`	Metadados completos do repositório (estrelas/forks/issues/licença)

🧠 Grafo de Conhecimento de Código

Ferramenta	O que faz
`code_graph`	Explorar estrutura de código: estatísticas, busca, rotas, arquivos, dependências
`kg_context`	Contexto de código BFS ranqueado (~2K tokens)
`kg_communities`	Detecção de comunidades (Leiden/guloso)
`kg_god_nodes`	Entidades de código mais influentes (PageRank)
`kg_watch`	Observador Git — detecção incremental de mudanças

🧭 Utilitários

Ferramenta	O que faz
`arachne_capabilities`	Descobrir capacidades automaticamente
`arachne_ping`	Verificação de saúde
`arachne_metrics`	Métricas do servidor (CPU, RAM, disco)
`arachne_plan`	Análise de objetivo → sugestão de cadeia de ferramentas
`arachne_calc`	Calculadora matemática segura (sandbox AST)
`arachne_format_converter`	Conversor universal (65+ formatos)
`arachne_sandbox_status`	Verificar disponibilidade do sandbox ai-jail

VRT com LLM local: Oito Olhos usa diff de pixels + pareamento de DOM + triagem semântica CLIP + VLM local (Qwen2.5-VL via Douglas, fallback de espelho Samuel) — classificando mudanças como regression | expected | noise, com sugestão de correção (CORRECAO:) quando detecta um bug. Nenhuma chave de API de terceiros para o veredito.

Pesquisa Social com juiz de IA local: arachne_social_research pesquisa Hacker News (Algolia), Reddit (API JSON + fallback browser_agent/Camoufox) e YouTube (yt-dlp) nos últimos N dias, pontua por engajamento real (upvotes/pontos/visualizações) e sintetiza um relatório de hype vs realidade com um VLM local (sem chaves de API de terceiros).

🚀 Início Rápido

1. Obtenha uma chave de API

Crie uma em arachne.seu.pet/dev (Plano gratuito: 500 req/mês).

2. Configure no Claude Desktop

{
  "mcpServers": {
    "arachne": {
      "command": "python3",
      "args": ["-m", "arachne_mcp"],
      "env": {
        "ARACHNE_API_KEY": "arn_your_key_here",
        "ARACHNE_API_URL": "https://arachne.seu.pet"
      }
    }
  }
}

3. Ou execute diretamente

pip install arachne-mcp
export ARACHNE_API_KEY="arn_your_key_here"
python3 -m arachne_mcp

🪟 Instalação no Windows (funciona de imediato)

arachne-mcp é um cliente Python puro (apenas httpx) — sem dependências exclusivas do Linux, sem necessidade de WSL. Instale-o no Windows com:

pip install arachne-mcp

Em seguida, configure-o em qualquer cliente MCP usando o ponto de entrada do console-script (arachne-mcp está no seu PATH após a instalação):

{
  "mcpServers": {
    "arachne": {
      "command": "arachne-mcp",
      "args": [],
      "env": {
        "ARACHNE_API_KEY": "arn_your_key_here",
        "ARACHNE_API_URL": "https://arachne.seu.pet"
      }
    }
  }
}

⚠️ Não aponte command para um caminho Linux (ex.: /home/user/.../venv/bin/arachne-mcp) — isso só existe na máquina onde o servidor Arachne roda. No Windows (e em qualquer outra máquina cliente) use o pacote pip + chave de API: o servidor faz todo o trabalho pesado (navegador, VLM, visão, RAG) por trás de https://arachne.seu.pet.

📡 Arquitetura

O servidor MCP é um proxy fino: ele encaminha cada chamada de ferramenta para a API Arachne (POST /api/mcp/proxy), que executa a ferramenta no lado do servidor e retorna o resultado. Isso mantém o cliente leve (apenas httpx), enquanto todo o trabalho pesado — navegador, VLM, visão, RAG — roda no servidor Arachne.

Claude Desktop / Cursor / Codex
        │  MCP (stdio)
        ▼
arachne-mcp (thin proxy, 49 tools)
        │  HTTP + X-API-Key
        ▼
Arachne API (arachne.seu.pet) → executes tool → returns JSON

🔐 Segurança

Autenticação por chave de API: cada requisição carrega X-API-Key (crie em /dev)
Limites de taxa aplicados no lado do servidor por plano
Nenhum código é executado no lado do cliente — o proxy apenas encaminha argumentos