TorBot

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

                            Strumento di Open Source Intelligence per il Dark Web

Stato/Link social

Funzionalità

1. Crawler Onion (.onion)
2. Restituisce il titolo della pagina o il nome host se non è disponibile un titolo della pagina, insieme all'indirizzo e a una breve descrizione del sito.
3. Salva i link in un database (Non completato)
4. Restituisce l'HTML di un sito o lo salva in un file HTML. (Non completato)
5. Salva l'albero dei link come file JSON.
6. Esegue la scansione di domini personalizzati
7. Verifica se il link è attivo
8. Aggiornamento integrato
9. Costruisce un albero visivo delle relazioni tra link che può essere visualizzato rapidamente o salvato in un file

Miglioramenti recenti

• La CLI ora consente di eseguire --version e --update senza richiedere un URL.
• Il crawler ora risolve i link relativi rispetto alla pagina corrente e ignora in modo più efficiente gli href non supportati o malformati.
• L'interfaccia desktop opzionale TorBotApp può essere avviata dalla CLI con torbot app quando installata come checkout adiacente.

...(sarà aggiornato)

Dipendenze

• Tor (Opzionale)
• Python 3.10+
• pip

Avvio rapido

Configurazione 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 .

Esegui la CLI

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

Esempi comuni

# 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

Analisi AI basata sulle evidenze

Salva un risultato di scansione versionato e trasformalo in un bundle di indagine con citazioni:

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 usa per impostazione predefinita un endpoint Ollama locale. I provider remoti compatibili con OpenAI richiedono il flag esplicito --allow-remote. Ogni finding supportato deve citare le evidenze acquisite, e un'interruzione del provider non impedisce mai la scrittura del bundle di evidenze deterministico. Consulta TorBot Analyst per la guida rapida offline, i formati di output, i limiti di privacy e gli schemi.

Opzioni

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 è obbligatorio per i comandi relativi al crawling come --info, --save e --visualize.

Se utilizzi Tor localmente, mantieni abilitato il proxy SOCKS5. Se non utilizzi Tor, aggiungi --disable-socks5 per evitare errori di connessione al proxy.

Per saperne di più su torrc: Torrc

App desktop opzionale

TorBot rimane uno strumento Python pensato principalmente per la CLI. L'interfaccia desktop risiede nel progetto Electron separato TorBotApp, così Node ed Electron non sono necessari per gli utenti della CLI.

Per avviarla da questa CLI, installa TorBotApp come checkout adiacente:

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

Poi esegui:

torbot app

Se TorBotApp si trova altrove, utilizzare uno dei due:

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

Consulta Desktop App Architecture per capire come la CLI, l'UI opzionale e i servizi backend si integrano tra loro.

Funzionalità curate

• Revisione del modulo di visualizzazione
• Implementazione della ricerca BFS per il webcrawler
• Miglioramento della stabilità (gestione degli errori in modo elegante, ampliamento della copertura dei test, ecc.)
• Aumento della copertura dei test
• Salvataggio dei risultati di ricerca più recenti in un database
• Randomizzazione della connessione Tor (header e identità casuali)
• Ricerca per parola chiave/frase
• Integrazione con i social media
• Aumento dell'anonimato
• Cattura di screenshot

Linee guida per i contributi

Hai trovato un problema?

Se riscontri problemi nel progetto, faccelo sapere creando una nuova issue qui.

Linee guida per gli sviluppatori