TorBot

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

                            Herramienta de Inteligencia de Fuentes Abiertas para la Dark Web

Enlaces de estado/redes sociales

Características

1. Rastreador de Onion (.onion)
2. Devuelve el título de la página o el nombre del host si no hay título disponible, junto con la dirección y una breve descripción del sitio.
3. Guarda los enlaces en una base de datos (No implementado)
4. Muestra el HTML de un sitio o lo guarda en un archivo HTML. (No implementado)
5. Guarda el árbol de enlaces como un archivo JSON.
6. Rastrea dominios personalizados
7. Comprueba si el enlace está activo
8. Actualizador integrado
9. Construye un árbol visual de relaciones entre enlaces que puede visualizarse rápidamente o guardarse en un archivo

Mejoras recientes

• La CLI ahora permite ejecutar --version y --update sin necesidad de una URL.
• El rastreador ahora resuelve los enlaces relativos respecto a la página actual y omite con mayor tolerancia los hrefs no compatibles o mal formados.
• La interfaz de escritorio opcional TorBotApp puede iniciarse desde la CLI con torbot app cuando está instalada como un checkout hermano.

...(se actualizará)

Dependencias

• Tor (Opcional)
• Python 3.10+
• pip

Inicio rápido

Configuración 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 .

Ejecutar la CLI

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

Ejemplos comunes

# 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álisis de IA basado en evidencia

Guarde un resultado de rastreo versionado y conviértalo en un paquete de investigación con citas:

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 por defecto un endpoint local de Ollama. Los proveedores remotos compatibles con OpenAI requieren el flag explícito --allow-remote. Cada hallazgo admitido debe citar la evidencia capturada, y una caída del proveedor nunca impide que se escriba el paquete de evidencia determinista. Consulta TorBot Analyst para el inicio rápido sin conexión, los formatos de salida, el límite de privacidad y los esquemas.

Opciones

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 es obligatorio para los comandos relacionados con el rastreo, como --info, --save y --visualize.

Si estás usando Tor localmente, mantén habilitado el proxy SOCKS5. Si no estás usando Tor, añade --disable-socks5 para evitar errores de conexión al proxy.

Lee más sobre torrc aquí: Torrc

Aplicación de escritorio opcional

TorBot sigue siendo una herramienta Python centrada en la CLI. La interfaz de escritorio reside en el proyecto Electron independiente TorBotApp, por lo que Node y Electron no son necesarios para los usuarios de la CLI.

Para lanzarla desde esta CLI, instala TorBotApp como un checkout hermano:

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

Luego ejecuta:

torbot app

Si TorBotApp está en otro lugar, use cualquiera de las siguientes opciones:

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

Consulta Desktop App Architecture para ver cómo encajan la CLI, la UI opcional y los servicios de backend.

Características seleccionadas

• Renovación del módulo de visualización
• Implementar búsqueda BFS para el webcrawler
• Mejorar la estabilidad (manejar errores con elegancia, ampliar la cobertura de pruebas, etc.)
• Aumentar la cobertura de pruebas
• Guardar los resultados de búsqueda más recientes en una base de datos
• Aleatorizar la conexión Tor (cabecera e identidad aleatorias)
• Búsqueda por palabra clave/frase
• Integración con redes sociales
• Aumentar el anonimato
• Captura de pantalla

Directrices de contribución

¿Encontraste un problema?

Si encuentras algún problema en el proyecto, avísanos creando un nuevo issue aquí.