Arachne MCP Server

🕷️ Arachne MCP Server

🌐 Inglés · 🇧🇷 Portugués

49 herramientas MCP para web scraping, automatización de navegador, visión por computadora, transcripción de audio, RAG, Investigación de Sentimiento Social y Pruebas de Regresión Visual (VRT) — los Oito Olhos (Ocho Ojos de la Araña) — todo a través de la API de Arachne.

Respaldado por Arachne. Funciona con Claude Desktop, Cursor, Codex CLI, Hermes y cualquier cliente MCP.

✨ Herramientas (49)

🔍 Web y Datos

Herramienta	Qué hace	Ideal para
arachne_search	Búsqueda web vía DuckDuckGo	Investigación, recopilación de prospectos
arachne_scrape	Markdown limpio desde URLs	Páginas estáticas, blogs, documentación
arachne_extract	Extrae CUALQUIER formato (audio, video, PDF, YouTube)	Navaja suiza
arachne_browser_extract	Navegador real con evasión de Cloudflare/CAPTCHA	Sitios que bloquean scrapers
arachne_browser_run	Acciones de navegador (clic, escribir, iniciar sesión)	Automatización de formularios
arachne_screenshot	Captura de pantalla de una URL (página completa o viewport)	Evidencia visual
arachne_record	Graba una screencast de una página (.webm)	Interacciones, demostraciones
arachne_torrent_extract	Extrae enlaces magnet de sitios torrent brasileños	Adquisición de torrents
arachne_download	Descarga universal (URL, repositorio, PyPI, npm)	Obtener cualquier artefacto
arachne_query	Consulta tu base de conocimiento RAG	Chatbot con tus datos

🔍 Investigación de Sentimiento Social

Herramienta	Qué hace	Ideal para
arachne_social_research	Busca lo que la gente REALMENTE dice (HN/Reddit/YouTube, últimos N días) + juez de IA vía VLM local	Hype vs realidad, quejas, sentimiento de mercado

👁️ Visión y Audio

Herramienta	Qué hace	Ideal para
arachne_vision	Análisis de imágenes: OCR, colores, rostros, descripción de IA	Extracción de texto de fotos
arachne_screenshot_vision	Captura de pantalla + pipeline completo de visión	Inspección visual de páginas
arachne_pdf_vision	Extrae imágenes de PDF + análisis de visión	PDFs escaneados
arachne_analyze_video	Metadatos de video: colores, OCR, geometría, VQA, audio	Comprensión de videos
arachne_transcribe	Transcripción de audio/video/YouTube con Whisper	Podcasts, reuniones, videos

🕷️ Oito Olhos — Pruebas de Regresión Visual (VRT)

Herramienta	Qué hace	Ideal para
arachne_visual_snapshot	Captura URL → crea línea base (1ª vez) o compara	Pruebas visuales idempotentes
arachne_visual_diff	Compara con línea base → diff + veredicto semántico	Verificación post-despliegue
arachne_visual_gates	Auditoría determinista: desbordamiento, colisión de texto, errores JS	Sin clave, sin línea base
arachne_visual_report	Suite de pruebas → HTML lado a lado	Revisión consolidada
arachne_visual_approve	Promueve actual → nueva línea base	Aceptar un cambio esperado
arachne_visual_list	Lista líneas base + estado	Monitorear lo que existe
arachne_visual_video	VRT de video: graba screencast + compara (animaciones)	Hover, carruseles, transiciones
arachne_visual_video_report	Suite de video → informe HTML interactivo	Revisión de regresión de animaciones

🤖 Escritorio y Agéntico

Herramienta	Qué hace	Ideal para
arachne_desktop	Control de escritorio (ventanas, escribir, tecla, clic)	Automatización del SO
arachne_desktop_os	Agéntico de escritorio con "ojo" VLM (captura + describe)	Ver antes de actuar
arachne_observe	Captura + cajas delimitadoras numeradas clicables	Navegación de agente GUI

📦 GitHub / GitLab / Paquetes

Herramienta	Qué hace
arachne_repo_download	Descargar repositorio de GitHub como zip (rama/token)
arachne_repo_fork	Hacer fork de un repositorio de GitHub
arachne_repo_forks	Listar forks por estrellas
arachne_repo_index	Descargar + indexar repositorio en RAG
arachne_releases	Listar releases de GitHub con activos
arachne_release_download	Descargar un activo de release
arachne_pypi_download	Descargar paquete PyPI (sdist/wheel)
arachne_npm_download	Descargar tarball de paquete npm
arachne_gitlab_download	Descargar archivo de proyecto GitLab
arachne_github_trending	Repositorios + desarrolladores en tendencia de GitHub (período/idioma, costo cero)
arachne_github_user_prs	PRs creados por un usuario (filtros desde/hasta)
arachne_github_user_activity	Actividad mensual + tipos de eventos para un usuario
arachne_github_repo_metadata	Metadatos completos del repositorio (estrellas/forks/issues/licencia)

🧠 Grafo de Conocimiento de Código

Herramienta	Qué hace
code_graph	Explorar estructura de código: estadísticas, búsqueda, rutas, archivos, dependencias
kg_context	Contexto de código BFS clasificado (~2K tokens)
kg_communities	Detección de comunidades (Leiden/greedy)
kg_god_nodes	Entidades de código más influyentes (PageRank)
kg_watch	Vigilante de Git — detección incremental de cambios

🧭 Utilidades

Herramienta	Qué hace
arachne_capabilities	Auto-descubrir capacidades
arachne_ping	Verificación de salud
arachne_metrics	Métricas del servidor (CPU, RAM, disco)
arachne_plan	Análisis de objetivo → sugerencia de cadena de herramientas
arachne_calc	Calculadora matemática segura (sandbox AST)
arachne_format_converter	Convertidor universal (más de 65 formatos)
arachne_sandbox_status	Verificar disponibilidad del sandbox ai-jail

VRT con LLM local: Oito Olhos usa diff de píxeles + emparejamiento DOM + clasificación semántica CLIP + VLM local (Qwen2.5-VL vía Douglas, espejo de respaldo Samuel) — clasificando cambios como regression | expected | noise, con una sugerencia de corrección (CORRECAO:) cuando detecta un error. Sin clave de API de terceros para el veredicto.

Investigación Social con juez de IA local: arachne_social_research busca en Hacker News (Algolia), Reddit (API JSON + respaldo browser_agent/Camoufox) y YouTube (yt-dlp) en los últimos N días, puntúa por participación real (upvotes/puntos/vistas) y sintetiza un informe de hype vs realidad con un VLM local (sin claves de API de terceros).

🚀 Inicio Rápido

1. Obtén una clave de API

Crea una en arachne.seu.pet/dev (Plan gratuito: 500 solicitudes/mes).

2. Configura en 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. O ejecuta directamente

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

🪟 Instalación en Windows (funciona de inmediato)

arachne-mcp es un cliente Python puro (solo httpx) — sin dependencias solo de Linux, sin necesidad de WSL. Instálalo en Windows con:

pip install arachne-mcp

Luego configúralo en cualquier cliente MCP usando el punto de entrada de script de consola (arachne-mcp está en tu PATH después de la instalación):

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

⚠️ No apuntes command a una ruta de Linux (p. ej. /home/user/.../venv/bin/arachne-mcp) — eso solo existe en la máquina donde se ejecuta el servidor de Arachne. En Windows (y en cualquier otra máquina cliente) usa el paquete pip + clave de API: el servidor hace todo el trabajo pesado (navegador, VLM, visión, RAG) detrás de https://arachne.seu.pet.

📡 Arquitectura

El servidor MCP es un proxy delgado: reenvía cada llamada de herramienta a la API de Arachne (POST /api/mcp/proxy), que ejecuta la herramienta en el lado del servidor y devuelve el resultado. Esto mantiene el cliente ligero (solo httpx), mientras que todo el trabajo pesado — navegador, VLM, visión, RAG — se ejecuta en el servidor de 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

🔐 Seguridad

• Autenticación con clave de API: cada solicitud lleva X-API-Key (crea una en /dev)
• Límites de tasa aplicados en el lado del servidor según el plan
• No se ejecuta código en el lado del cliente — el proxy solo reenvía argumentos