TorBot

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

                            Outil de renseignement en sources ouvertes pour le Dark Web

Statut/Liens sociaux

Fonctionnalités

1. Crawler Onion (.onion)
2. Renvoie le titre de la page ou le nom d'hôte si aucun titre de page n'est disponible, ainsi que l'adresse avec une courte description du site.
3. Enregistre les liens dans une base de données (Non réalisé)
4. Affiche le HTML d'un site ou l'enregistre dans un fichier HTML. (Non réalisé)
5. Enregistre l'arborescence des liens dans un fichier JSON.
6. Explore des domaines personnalisés
7. Vérifie si le lien est actif
8. Mise à jour intégrée
9. Construit une arborescence visuelle des relations entre liens, consultable rapidement ou enregistrable dans un fichier

Améliorations récentes

• La CLI permet désormais à --version et --update de s'exécuter sans nécessiter d'URL.
• Le crawler résout désormais les liens relatifs par rapport à la page courante et ignore plus élégamment les hrefs non pris en charge ou malformés.
• L'interface de bureau optionnelle TorBotApp peut être lancée depuis la CLI avec torbot app lorsqu'elle est installée en tant que checkout voisin.

...(sera mis à jour)

Dépendances

• Tor (Optionnel)
• Python 3.10+
• pip

Démarrage rapide

Installation locale

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 .

Exécuter la CLI

python main.py --help
python main.py --version
python main.py -u https://example.com --depth 2 --visualize table

Exemples courants

# 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

Analyse IA fondée sur les preuves

Enregistrez un résultat de crawl versionné et transformez-le en un dossier d'enquête cité :

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 utilise par défaut un point de terminaison Ollama local. Les fournisseurs distants compatibles OpenAI nécessitent le flag explicite --allow-remote. Chaque constat pris en charge doit citer les preuves capturées, et une panne d'un fournisseur n'empêche jamais l'écriture du bundle de preuves déterministe. Consultez TorBot Analyst pour le démarrage rapide hors ligne, les formats de sortie, la limite de confidentialité et les schémas.

Options

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 est requis pour les commandes liées au crawl telles que --info, --save et --visualize.

Si vous utilisez Tor localement, gardez le proxy SOCKS5 activé. Si vous n'utilisez pas Tor, ajoutez --disable-socks5 pour éviter les erreurs de connexion au proxy.

Pour en savoir plus sur torrc, consultez : Torrc

Application de bureau facultative

TorBot reste un outil Python orienté CLI. L'interface de bureau se trouve dans le projet Electron séparé TorBotApp, afin que Node et Electron ne soient pas requis pour les utilisateurs de la CLI.

Pour la lancer depuis cette CLI, installez TorBotApp en tant que dépôt voisin :

code/
+-- TorBot/
+-- TorBotApp/

Puis exécutez :

torbot app

Si TorBotApp se trouve ailleurs, utilisez soit :

TORBOT_APP_DIR=/path/to/TorBotApp torbot app
torbot --app --app-dir /path/to/TorBotApp

Voir Architecture de l'application de bureau pour comprendre comment la CLI, l'interface utilisateur optionnelle et les services backend s'articulent.

Fonctionnalités sélectionnées

• Refonte du module de visualisation
• Implémentation de la recherche BFS pour le webcrawler
• Amélioration de la stabilité (gestion élégante des erreurs, extension de la couverture des tests, etc.)
• Augmentation de la couverture des tests
• Sauvegarde des résultats de recherche les plus récents dans une base de données
• Randomisation de la connexion Tor (en-tête et identité aléatoires)
• Recherche par mot-clé/expression
• Intégration des médias sociaux
• Augmentation de l'anonymat
• Capture d'écran

Directives de contribution

Vous avez trouvé un problème ?