TorBot

                         ████████╗ ██████╗ ██████╗     ██████╗  ██████╗ ████████╗
                         ╚══██╔══╝██╔═══██╗██╔══██╗    ██╔══██╗██╔═████╗╚══██╔══╝
                            ██║   ██║   ██║██████╔╝    ██████╔╝██║██╔██║   ██║
                            ██║   ██║   ██║██╔══██╗    ██╔══██╗████╔╝██║   ██║
                            ██║   ╚██████╔╝██║  ██║    ██████╔╝╚██████╔╝   ██║
                            ╚═╝    ╚═════╝ ╚═╝  ╚═╝    ╚═════╝  ╚═════╝    ╚═╝

                            Инструмент разведки на основе открытых источников для даркнета

Статус и социальные ссылки

Возможности

1. Сканер Onion-сайтов (.onion)
2. Возвращает заголовок страницы или имя хоста, если заголовок страницы недоступен, а также адрес с кратким описанием сайта.
3. Сохраняет ссылки в базу данных (не реализовано)
4. Выводит HTML-код сайта или сохраняет его в HTML-файл. (не реализовано)
5. Сохраняет дерево ссылок в виде JSON-файла.
6. Сканирует пользовательские домены
7. Проверяет, доступна ли ссылка
8. Встроенный модуль обновления
9. Строит визуальное дерево связей между ссылками, которое можно быстро просмотреть или сохранить в файл

Последние улучшения

• CLI теперь позволяет запускать --version и --update без указания URL.
• Сканер теперь разрешает относительные ссылки относительно текущей страницы и более корректно пропускает неподдерживаемые или некорректные href.
• Необязательный десктопный интерфейс TorBotApp можно запустить из CLI командой torbot app, если он установлен как соседний репозиторий.

...(будет обновлено)

Зависимости

• Tor (опционально)
• Python 3.10+
• pip

Быстрый старт

Локальная установка

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 .

Запуск CLI

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 остаётся Python-инструментом с приоритетом CLI. Десктопный интерфейс находится в отдельном Electron-проекте TorBotApp, поэтому Node и Electron не требуются пользователям CLI.

Чтобы запустить его из этого 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 и серверные службы взаимодействуют друг с другом.

Отобранные функции

• Переработка модуля визуализации
• Реализация поиска BFS для веб-краулера
• Повышение стабильности (корректная обработка ошибок, расширение покрытия тестами и т. д.)
• Увеличение покрытия тестами
• Сохранение последних результатов поиска в базу данных
• Рандомизация Tor-соединения (случайные заголовки и идентичность)
• Поиск по ключевым словам/фразам
• Интеграция с социальными сетями
• Повышение анонимности
• Захват скриншотов

Правила участия

Нашли проблему?

Если вы столкнулись с какими-либо проблемами в проекте, пожалуйста, сообщите нам, создав новый issue здесь.

Рекомендации для разработчиков