TorBot v4.3.1

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

                            Ferramenta de Inteligência de Fontes Abertas para a Dark Web

Status/Links sociais

Funcionalidades

1. Rastreador Onion (.onion)
2. Retorna o título da página ou o nome do host caso não haja título disponível, juntamente com o endereço e uma breve descrição do site.
3. Salva links em um banco de dados (Não concluído)
4. Exibe o HTML de um site ou o salva em um arquivo HTML. (Não concluído)
5. Salva a árvore de links como um arquivo JSON.
6. Rastreia domínios personalizados
7. Verifica se o link está ativo
8. Atualizador integrado
9. Constrói uma árvore visual de relacionamentos entre links que pode ser rapidamente visualizada ou salva em um arquivo

Melhorias recentes

• A CLI agora permite executar --version e --update sem exigir uma URL.
• O rastreador agora resolve links relativos em relação à página atual e ignora hrefs não suportados ou malformados de forma mais tolerante.
• A interface desktop opcional TorBotApp pode ser iniciada a partir da CLI com torbot app quando instalada como um checkout irmão.

...(será atualizado)

Dependências

• Tor (Opcional)
• Python 3.10+
• pip

Início rápido

Configuração local

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 .

Instalar com o OTinstaller (Linux)

OTinstaller é um gerenciador de ferramentas de terceiros que instala a versão do torbot do PyPI em seu próprio virtualenv. Ele não é mantido pela equipe do TorBot, portanto, relate problemas com ele no rastreador do OTinstaller.

pipx install otinstaller
otinstaller init
otinstaller install torbot
# url:... is passed to TorBot as -u; the other flags go through unchanged
otinstaller run torbot -- url:https://example.com --depth 2 --visualize table

Executar a CLI

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

Exemplos comuns

# 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

Análise de IA com foco em evidências

Salve um resultado de rastreamento versionado e transforme-o em um pacote de investigação com citações:

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/

O Analyst usa por padrão um endpoint local do Ollama. Provedores remotos compatíveis com OpenAI exigem a flag explícita --allow-remote. Toda descoberta suportada deve citar evidências capturadas, e uma indisponibilidade do provedor nunca impede que o pacote de evidências determinístico seja gravado. Consulte TorBot Analyst para o início rápido offline, formatos de saída, limite de privacidade e esquemas.

Opções

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 é obrigatório para comandos relacionados a crawl, como --info, --save e --visualize.

Se você estiver usando Tor localmente, mantenha o proxy SOCKS5 habilitado. Se não estiver usando Tor, adicione --disable-socks5 para evitar erros de conexão com o proxy.

Leia mais sobre o torrc aqui: Torrc

Aplicativo desktop opcional

O TorBot continua sendo uma ferramenta Python com foco em CLI. A interface desktop fica no projeto Electron separado TorBotApp, de modo que Node e Electron não são necessários para usuários da CLI.

Para iniciá-lo a partir desta CLI, instale o TorBotApp como um checkout irmão:

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

Em seguida, execute:

torbot app

Se o TorBotApp estiver em outro local, use um dos seguintes:

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

Consulte Desktop App Architecture para saber como a CLI, a UI opcional e os serviços de backend se integram.