dedsecinside/torbotTor経由で.onionサイトをクロールし、ページタイトル、ホスト名、リンク関係を収集して、ダークウェブOSINT調査向けにJSONツリーと可視化をエクスポートします。
████████╗ ██████╗ ██████╗ ██████╗ ██████╗ ████████╗
╚══██╔══╝██╔═══██╗██╔══██╗ ██╔══██╗██╔═████╗╚══██╔══╝
██║ ██║ ██║██████╔╝ ██████╔╝██║██╔██║ ██║
██║ ██║ ██║██╔══██╗ ██╔══██╗████╔╝██║ ██║
██║ ╚██████╔╝██║ ██║ ██████╔╝╚██████╔╝ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
ダークウェブ向けオープンソースインテリジェンスツール
--versionと--updateを実行できるようになりました。torbot appで起動できます。...(更新予定)
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python -m pip install -e .
python main.py --help
python main.py --version
python main.py -u https://example.com --depth 2 --visualize table
# Gather basic site information
python main.py -u https://example.com --info
# Save the crawl tree as JSON
python main.py -u https://example.com --depth 2 --save json
# Disable SOCKS5 if you are not using Tor locally
python main.py -u https://example.com --disable-socks5 --visualize tree
# Launch the optional desktop app when TorBotApp is installed
torbot app
バージョン管理されたクロール結果を保存し、引用付きの調査バンドルに変換します:
torbot --url https://example.com --disable-socks5 \
--save result --result-file crawl-result.json
torbot analyze crawl-result.json --provider ollama --model qwen3 \
--output investigation/
Analyst はデフォルトでローカルの Ollama エンドポイントを使用します。リモートの OpenAI 互換プロバイダーを利用するには、明示的に --allow-remote フラグを指定する必要があります。サポートされるすべての検出結果は、キャプチャされた証拠を引用しなければならず、プロバイダーの障害が発生しても、決定論的な証拠バンドルの書き込みが妨げられることはありません。オフラインでのクイックスタート、出力形式、プライバシー境界、およびスキーマについては、TorBot Analyst を参照してください。
usage: Gather and analyze data from Tor sites.
optional arguments:
-u URL, --url URL Specify a website link to crawl
--depth DEPTH Specify max depth of crawler (default 1)
-h, --help Show this help message and exit
--host Set IP address for SOCKS5 proxy (defaults to 127.0.0.1)
--port Set port for SOCKS5 proxy (defaults to 9050)
-v Displays DEBUG level logging, default is INFO
--version Show the current version of TorBot.
--update Update TorBot to the latest stable version
--app Run optional TorBot desktop app
--app-dir APP_DIR Path to a TorBotApp checkout
-q, --quiet Prevents display of header and IP address
--save FORMAT Save results in a file. (tree, JSON)
--visualize FORMAT Visualizes tree of data gathered. (tree, JSON, table)
-i, --info Info displays basic info of the scanned site
--disable-socks5 Executes HTTP requests without using SOCKS5 proxy
-u/--urlは--info、--save、--visualizeなどのクロール関連コマンドで必須です。
ローカルで Tor を使用している場合は、SOCKS5 プロキシを有効にしたままにしてください。Tor を使用していない場合は、プロキシ接続エラーを避けるために --disable-socks5 を追加してください。
torrc の詳細についてはこちらをご覧ください: Torrc
TorBot は CLI ファーストの Python ツールであり続けます。デスクトップ UI は別個の TorBotApp Electron プロジェクトに存在するため、CLI ユーザーには Node や Electron は不要です。
この CLI から起動するには、TorBotApp を兄弟チェックアウトとしてインストールしてください:
code/
+-- TorBot/
+-- TorBotApp/
次に実行します:
torbot app
TorBotApp が別の場所にある場合は、次のいずれかを使用してください:
TORBOT_APP_DIR=/path/to/TorBotApp torbot app
torbot --app --app-dir /path/to/TorBotApp
CLI、オプションのUI、バックエンドサービスがどのように連携するかについては、デスクトップアプリのアーキテクチャを参照してください。
プロジェクトで問題が発生した場合は、こちらから新しいissueを作成してお知らせください。
このプロジェクトへのコントリビューションを歓迎します！以下に従うべきガイドラインをいくつか示します：
devブランチへのプルリクエストを送信する前に、pytestを実行してコードがすべてのテストに合格することを確認してください。