{
  "markdown": "<!-- mcp-name: io.github.Samuelfmedeiros/arachne-mcp -->\n\n# 🕷️ Arachne MCP Server\n\n> 🌐 **English** · [🇧🇷 Português](README.pt-BR.md)\n\n**49 MCP tools** for web scraping, browser automation, computer vision, audio transcription, RAG, **Social Sentiment Research**, and **Visual Regression Testing (VRT) — the Oito Olhos (Spider's Eight Eyes)** — all through the Arachne API.\n\nBacked by [Arachne](https://arachne.seu.pet). Works with **Claude Desktop**, **Cursor**, **Codex CLI**, **Hermes**, and any MCP client.\n\n## ✨ Tools (49)\n\n### 🔍 Web & Data\n| Tool | What it does | Best for |\n|------|-----------|------------|\n| `arachne_search` | Web search via DuckDuckGo | Research, lead collection |\n| `arachne_scrape` | Clean markdown from URLs | Static pages, blogs, docs |\n| `arachne_extract` | Extracts ANY format (audio, video, PDF, YouTube) | **Swiss-army knife** |\n| `arachne_browser_extract` | Real browser with Cloudflare/CAPTCHA evasion | Sites that block scrapers |\n| `arachne_browser_run` | Browser actions (click, type, login) | Form automation |\n| `arachne_screenshot` | Screenshot of a URL (full page or viewport) | Visual evidence |\n| `arachne_record` | Records a screencast of a page (.webm) | Interactions, demos |\n| `arachne_torrent_extract` | Extracts magnet links from BR torrent sites | Torrent acquisition |\n| `arachne_download` | Universal download (URL, repo, PyPI, npm) | Fetch any artifact |\n| `arachne_query` | Ask your RAG knowledge base | Chatbot with your data |\n\n### 🔍 Social Sentiment Research\n| Tool | What it does | Best for |\n|------|-----------|------------|\n| `arachne_social_research` | Searches what people REALLY say (HN/Reddit/YouTube, last N days) + AI judge via local VLM | **Hype vs reality, complaints, market sentiment** |\n\n### 👁️ Vision & Audio\n| Tool | What it does | Best for |\n|------|-----------|------------|\n| `arachne_vision` | Image analysis: OCR, colors, faces, AI description | Text extraction from photos |\n| `arachne_screenshot_vision` | Screenshot + full vision pipeline | Visual page inspection |\n| `arachne_pdf_vision` | Extracts images from PDF + vision analysis | Scanned PDFs |\n| `arachne_analyze_video` | Video metadata: colors, OCR, geometry, VQA, audio | Video understanding |\n| `arachne_transcribe` | Audio/video/YouTube transcription with Whisper | Podcast, meeting, video |\n\n### 🕷️ Oito Olhos — Visual Regression Testing (VRT)\n| Tool | What it does | Best for |\n|------|-----------|------------|\n| `arachne_visual_snapshot` | Captures URL → creates baseline (1st time) or compares | Idempotent visual tests |\n| `arachne_visual_diff` | Compares with baseline → diff + semantic verdict | Post-deploy verification |\n| `arachne_visual_gates` | Deterministic audit: overflow, text collision, JS errors | **Key-free, no baseline** |\n| `arachne_visual_report` | Test suite → HTML side-by-side | Consolidated review |\n| `arachne_visual_approve` | Promotes current → new baseline | Accept an expected change |\n| `arachne_visual_list` | Lists baselines + status | Monitor what exists |\n| `arachne_visual_video` | Video VRT: records screencast + compares (animations) | Hover, carousels, transitions |\n| `arachne_visual_video_report` | Video suite → interactive HTML report | Animation regression review |\n\n### 🤖 Desktop & Agentic\n| Tool | What it does | Best for |\n|------|-----------|------------|\n| `arachne_desktop` | Desktop control (windows, type, key, click) | OS automation |\n| `arachne_desktop_os` | Desktop agentic with VLM \"eye\" (screenshot + describe) | See before acting |\n| `arachne_observe` | Screenshot + numbered clickable bounding boxes | GUI agent navigation |\n\n### 📦 GitHub / GitLab / Packages\n| Tool | What it does |\n|------|-----------|\n| `arachne_repo_download` | Download GitHub repo as zip (branch/token) |\n| `arachne_repo_fork` | Fork a GitHub repo |\n| `arachne_repo_forks` | List forks by stars |\n| `arachne_repo_index` | Download + index repo into RAG |\n| `arachne_releases` | List GitHub releases with assets |\n| `arachne_release_download` | Download a release asset |\n| `arachne_pypi_download` | Download PyPI package (sdist/wheel) |\n| `arachne_npm_download` | Download npm package tarball |\n| `arachne_gitlab_download` | Download GitLab project archive |\n| `arachne_github_trending` | GitHub trending repos + developers (period/language, zero cost) |\n| `arachne_github_user_prs` | PRs authored by a user (since/until filters) |\n| `arachne_github_user_activity` | Monthly activity + event types for a user |\n| `arachne_github_repo_metadata` | Full repo metadata (stars/forks/issues/license) |\n\n### 🧠 Code Knowledge Graph\n| Tool | What it does |\n|------|-----------|\n| `code_graph` | Explore code structure: stats, search, routes, files, deps |\n| `kg_context` | Ranked BFS code context (~2K tokens) |\n| `kg_communities` | Community detection (Leiden/greedy) |\n| `kg_god_nodes` | Most influential code entities (PageRank) |\n| `kg_watch` | Git watcher — incremental change detection |\n\n### 🧭 Utilities\n| Tool | What it does |\n|------|-----------|\n| `arachne_capabilities` | Auto-discover capabilities |\n| `arachne_ping` | Health check |\n| `arachne_metrics` | Server metrics (CPU, RAM, disk) |\n| `arachne_plan` | Goal analysis → tool chain suggestion |\n| `arachne_calc` | Safe math calculator (AST-sandboxed) |\n| `arachne_format_converter` | Universal converter (65+ formats) |\n| `arachne_sandbox_status` | Check ai-jail sandbox availability |\n\n> **VRT with local LLM:** Oito Olhos uses pixel diff + DOM pairing + **CLIP semantic triage** + **local VLM** (Qwen2.5-VL via Douglas, Samuel mirror fallback) — classifying changes as `regression | expected | noise`, with a fix suggestion (`CORRECAO:`) when it detects a bug. **No third-party API key for the verdict.**\n\n> **Social Research with local AI judge:** `arachne_social_research` searches Hacker News (Algolia), Reddit (JSON API + browser_agent/Camoufox fallback) and YouTube (yt-dlp) in the last N days, scores by real engagement (upvotes/points/views), and synthesizes a **hype vs reality** report with a local VLM (no third-party API keys).\n\n## 🚀 Quick Start\n\n### 1. Get an API key\n\nCreate one at **[arachne.seu.pet/dev](https://arachne.seu.pet/dev)** (Free plan: 500 req/month).\n\n### 2. Configure in Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"arachne\": {\n      \"command\": \"python3\",\n      \"args\": [\"-m\", \"arachne_mcp\"],\n      \"env\": {\n        \"ARACHNE_API_KEY\": \"arn_your_key_here\",\n        \"ARACHNE_API_URL\": \"https://arachne.seu.pet\"\n      }\n    }\n  }\n}\n```\n\n### 3. Or run directly\n\n```bash\npip install arachne-mcp\nexport ARACHNE_API_KEY=\"arn_your_key_here\"\npython3 -m arachne_mcp\n```\n\n## 🪟 Windows install (works out of the box)\n\n`arachne-mcp` is a **pure-Python client** (only `httpx`) — no Linux-only\ndependencies, no WSL required. Install it on Windows with:\n\n```bat\npip install arachne-mcp\n```\n\nThen configure it in any MCP client using the console-script entry point\n(`arachne-mcp` is on your PATH after install):\n\n```json\n{\n  \"mcpServers\": {\n    \"arachne\": {\n      \"command\": \"arachne-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"ARACHNE_API_KEY\": \"arn_your_key_here\",\n        \"ARACHNE_API_URL\": \"https://arachne.seu.pet\"\n      }\n    }\n  }\n}\n```\n\n> ⚠️ **Do not** point `command` at a Linux path (e.g. `/home/user/.../venv/bin/arachne-mcp`) —\n> that only exists on the machine where the Arachne server runs. On Windows (and any\n> other client machine) use the pip package + API key: the server does all heavy work\n> (browser, VLM, vision, RAG) behind `https://arachne.seu.pet`.\n\n## 📡 Architecture\n\nThe MCP server is a **thin proxy**: it forwards each tool call to the Arachne API\n(`POST /api/mcp/proxy`), which executes the tool server-side and returns the result.\nThis keeps the client light (only `httpx`), while all heavy work — browser, VLM,\nvision, RAG — runs on the Arachne server.\n\n```text\nClaude Desktop / Cursor / Codex\n        │  MCP (stdio)\n        ▼\narachne-mcp (thin proxy, 49 tools)\n        │  HTTP + X-API-Key\n        ▼\nArachne API (arachne.seu.pet) → executes tool → returns JSON\n```\n\n## 🔐 Security\n\n- **API key auth**: every request carries `X-API-Key` (create at `/dev`)\n- **Rate limits** enforced server-side per plan\n- No code runs client-side — the proxy only forwards arguments\n",
  "bytes": 8270,
  "sha": "070cab7a324d07832e5693559842f582bdf84f97acf28f2e1273cbaf9623ab17",
  "repo_slug": "samuelfmedeiros/arachne-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_samuelfmedeiros_arachne_mcp_bfcbe847/readme"
}