🕷️ Arachne MCP Server

9 MCP tools para web scraping, browser automation, visão computacional, transcrição de áudio e RAG — tudo via API.

Conecta no Arachne como backend. Funciona com Claude Desktop, Cursor, Codex CLI, e qualquer cliente MCP.

✨ Tools

🚀 Quick Start

1. Pegue uma API Key

Crie em [arachne.seu.pet/dev](https://arachne.seu.pet/dev) (plano Free: 500 req/mês).

2. Configure no Claude Desktop

{
  "mcpServers": {
    "arachne": {
      "command": "python3",
      "args": ["-m", "arachne_mcp"],
      "env": {
        "ARACHNE_API_KEY": "sua_chave_aqui"
      }
    }
  }
}

3. Ou teste direto

export ARACHNE_API_KEY="sua_chave"
python3 arachne_mcp.py

Precisa de httpx: pip install httpx

📦 Como funciona

O MCP server é um cliente HTTP que chama a API pública do Arachne. Zero dependência de infra local — roda de qualquer lugar.

Seu agente AI → MCP stdio → arachne_mcp.py → HTTP → Arachne API → resultado

🔧 Exemplos

# Via arachne-sdk (pip install arachne-sdk)
from arachne_sdk import Arachne
client = Arachne(api_key="sua_chave")

# Busca na web
results = client.search("preço iPhone 16 Brasil")
for r in results:
    print(f"{r.title}: {r.url}")

# Extrair página
content = client.scrape("https://exemplo.com")
print(content[:500])

# Analisar imagem
vision = client.vision("https://exemplo.com/foto.jpg")
print(vision.ocr.text)

# Perguntar ao RAG
answer = client.query("Qual a diferença do Arachne pro Firecrawl?")
print(answer)

📊 Planos

🏗️ Stack

• Backend: FastAPI + Crawl4AI + Whisper + Tesseract + SQLite
• Engines: Trafilatura → Crawl4AI SDK → Sidecar Docker → Camoufox
• MCP Transport: stdio (compatível com Claude Desktop, Cursor, Codex)

🔗 Links

• Arachne Platform
• Developer Portal
• API Docs
• Python SDK (PyPI)
• GitHub

🕷️ Built with the Arachne engine. Open source MCP server.