TorBot

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

                            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 .

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.

Recursos Selecionados

• Reformulação do Módulo de Visualização
• Implementar Busca BFS para o webcrawler
• Melhorar a estabilidade (Tratar erros de forma adequada, ampliar a cobertura de testes, etc.)
• Aumentar a cobertura de testes
• Salvar os resultados de busca mais recentes em um banco de dados
• Randomizar a Conexão Tor (Header e Identidade Aleatórios)
• Busca por Palavra-chave/Frase
• Integração com Redes Sociais
• Aumentar o anonimato
• Captura de tela

Diretrizes de Contribuição

Encontrou um problema?

Se você encontrar algum problema no projeto, por favor nos avise criando uma nova issue aqui.

Diretrizes para Desenvolvedores

Agradecemos contribuições para este projeto! Aqui estão algumas diretrizes a seguir: