arachne-mcp

🕷️ Arachne MCP Server

🌐 English · 🇧🇷 Português

Arachne API を通じて、ウェブスクレイピング、ブラウザー自動化、コンピュータービジョン、音声文字起こし、RAG、ソーシャルセンチメント調査、ビジュアルリグレッションテスト（VRT）— Oito Olhos（クモの8つの目）を実現する49 個の MCP ツールです。

Arachne を基盤としています。Claude Desktop、Cursor、Codex CLI、Hermes、およびあらゆる MCP クライアントで動作します。

✨ ツール（49）

🔍 ウェブとデータ

ツール	機能	最適な用途
arachne_search	DuckDuckGo によるウェブ検索	調査、見込み客の収集
arachne_scrape	URL からクリーンな Markdown を取得	静的ページ、ブログ、ドキュメント
arachne_extract	あらゆる形式（音声、動画、PDF、YouTube）を抽出	万能ツール
arachne_browser_extract	Cloudflare/CAPTCHA 回避機能を備えた実ブラウザー	スクレイパーをブロックするサイト
arachne_browser_run	ブラウザー操作（クリック、入力、ログイン）	フォームの自動化
arachne_screenshot	URL のスクリーンショット（全ページまたは表示領域）	視覚的な証拠
arachne_record	ページのスクリーンキャストを記録（.webm）	操作、デモ
arachne_torrent_extract	BR のトレントサイトからマグネットリンクを抽出	トレントの取得
arachne_download	汎用ダウンロード（URL、リポジトリ、PyPI、npm）	あらゆる成果物の取得
arachne_query	RAG ナレッジベースに質問	独自データを使ったチャットボット

🔍 ソーシャルセンチメント調査

ツール	機能	最適な用途
arachne_social_research	人々が実際に何と言っているかを検索（HN/Reddit/YouTube、直近 N 日間）＋ローカル VLM による AI 判定	期待と現実、苦情、市場センチメント

👁️ ビジョンと音声

ツール	機能	最適な用途
arachne_vision	画像分析：OCR、色、顔、AI による説明	写真からのテキスト抽出
arachne_screenshot_vision	スクリーンショット＋ビジョンの全処理パイプライン	ページの視覚的な検査
arachne_pdf_vision	PDF から画像を抽出＋ビジョン分析	スキャンされた PDF
arachne_analyze_video	動画メタデータ：色、OCR、形状、VQA、音声	動画の理解
arachne_transcribe	Whisper による音声／動画／YouTube の文字起こし	ポッドキャスト、会議、動画

🕷️ Oito Olhos — ビジュアルリグレッションテスト（VRT）

ツール	機能	最適な用途
arachne_visual_snapshot	URL をキャプチャ → 初回はベースラインを作成し、以降は比較	冪等なビジュアルテスト
arachne_visual_diff	ベースラインと比較 → 差分＋意味的な判定	デプロイ後の検証
arachne_visual_gates	決定論的な監査：オーバーフロー、テキストの衝突、JS エラー	キー不要、ベースライン不要
arachne_visual_report	テストスイート → 左右に並べた HTML	まとめてレビュー
arachne_visual_approve	現在の状態を新しいベースラインに昇格	想定された変更の承認
arachne_visual_list	ベースラインとステータスを一覧表示	登録済み項目の監視
arachne_visual_video	動画 VRT：スクリーンキャストを記録して比較（アニメーション）	ホバー、カルーセル、トランジション
arachne_visual_video_report	動画スイート → インタラクティブな HTML レポート	アニメーションのリグレッションレビュー

🤖 デスクトップとエージェント型機能

ツール	機能	最適な用途
arachne_desktop	デスクトップ操作（ウィンドウ、入力、キー、クリック）	OS の自動化
arachne_desktop_os	VLM の「目」を備えたデスクトップエージェント機能（スクリーンショット＋説明）	操作前の状況把握
arachne_observe	スクリーンショット＋番号付きのクリック可能なバウンディングボックス	GUI エージェントのナビゲーション

📦 GitHub / GitLab / Packages

ツール	説明
arachne_repo_download	GitHub リポジトリを ZIP としてダウンロードします（ブランチ／トークン）
arachne_repo_fork	GitHub リポジトリをフォークします
arachne_repo_forks	スター数順にフォークを一覧表示します
arachne_repo_index	リポジトリをダウンロードして RAG にインデックス化します
arachne_releases	アセット付きの GitHub リリースを一覧表示します
arachne_release_download	リリースアセットをダウンロードします
arachne_pypi_download	PyPI パッケージをダウンロードします（sdist／wheel）
arachne_npm_download	npm パッケージの tarball をダウンロードします
arachne_gitlab_download	GitLab プロジェクトのアーカイブをダウンロードします
arachne_github_trending	GitHub のトレンドリポジトリと開発者を取得します（期間／言語、無料）
arachne_github_user_prs	ユーザーが作成した PR を取得します（開始日／終了日のフィルター）
arachne_github_user_activity	ユーザーの月ごとのアクティビティとイベント種別を取得します
arachne_github_repo_metadata	リポジトリの完全なメタデータを取得します（スター／フォーク／イシュー／ライセンス）

🧠 コードナレッジグラフ

ツール	説明
code_graph	統計、検索、ルート、ファイル、依存関係を使ってコード構造を調べます
kg_context	ランク付けされた BFS コードコンテキストを取得します（約 2K トークン）
kg_communities	コミュニティを検出します（Leiden／greedy）
kg_god_nodes	影響力が最も大きいコードエンティティを取得します（PageRank）
kg_watch	Git ウォッチャー — 変更を段階的に検出します

🧭 ユーティリティ

ツール	説明
arachne_capabilities	機能を自動検出します
arachne_ping	ヘルスチェックを実行します
arachne_metrics	サーバーのメトリクスを取得します（CPU、RAM、ディスク）
arachne_plan	目標を分析し、ツールチェーンを提案します
arachne_calc	安全な数式計算ツールです（AST サンドボックス化）
arachne_format_converter	汎用コンバーターです（65 種類以上の形式）
arachne_sandbox_status	ai-jail サンドボックスが利用可能か確認します

ローカル LLM による VRT： Oito Olhos はピクセル差分、DOM のペアリング、CLIP によるセマンティックトリアージ、ローカル VLM（Douglas 経由の Qwen2.5-VL、フォールバックとして Samuel ミラー）を使用し、変更を regression | expected | noise に分類します。バグを検出した場合は修正案（CORRECAO:）も提示します。判定にサードパーティの API キーは不要です。

ローカル AI ジャッジによるソーシャルリサーチ： arachne_social_research は、過去 N 日間の Hacker News（Algolia）、Reddit（JSON API と browser_agent／Camoufox フォールバック）、YouTube（yt-dlp）を検索し、実際のエンゲージメント（賛成票／ポイント／再生回数）に基づいてスコアを付け、ローカル VLM を使って誇大広告と現実を比較するレポートを作成します（サードパーティの API キーは不要です）。

🚀 クイックスタート

1. API キーを取得する

arachne.seu.pet/dev で作成します（無料プラン：月 500 リクエスト）。

2. 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. または直接実行する

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

🪟 Windows へのインストール（そのまま使えます）

arachne-mcp は 純粋な Python クライアント（httpx のみ）です。Linux 専用の 依存関係はなく、WSL も必要ありません。Windows には次のようにインストールします。

pip install arachne-mcp

その後、コンソールスクリプトのエントリーポイント（インストール後、arachne-mcp は PATH 上にあります）を使って、任意の MCP クライアントで設定します。

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

⚠️ command に Linux のパス（例：/home/user/.../venv/bin/arachne-mcp）を指定しないでください。 これは Arachne サーバーが実行されているマシンにしか存在しません。Windows（および その他のクライアントマシン）では、pip パッケージと API キーを使用してください。重い処理 （ブラウザー、VLM、ビジョン、RAG）はすべて、サーバーが https://arachne.seu.pet の背後で実行します。

📡 アーキテクチャ

MCP サーバーは 薄いプロキシです。各ツール呼び出しを Arachne API （POST /api/mcp/proxy）に転送し、API がサーバー側でツールを実行して結果を返します。 これによりクライアントは軽量（httpx のみ）に保たれ、重い処理（ブラウザー、VLM、 ビジョン、RAG）はすべて 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

🔐 セキュリティ

• API キー認証： すべてのリクエストに X-API-Key が含まれます（/dev で作成）
• レート制限： プランごとにサーバー側で適用されます
• クライアント側ではコードを実行しません。プロキシは引数を転送するだけです