dedsecinside/torbotRastrea sitios .onion a través de Tor para recopilar títulos de páginas, nombres de host y relaciones de enlaces, exportando árboles JSON y visualizaciones para investigaciones OSINT en la dark web.
<pre>
████████╗ ██████╗ ██████╗ ██████╗ ██████╗ ████████╗
╚══██╔══╝██╔═══██╗██╔══██╗ ██╔══██╗██╔═████╗╚══██╔══╝
██║ ██║ ██║██████╔╝ ██████╔╝██║██╔██║ ██║
██║ ██║ ██║██╔══██╗ ██╔══██╗████╔╝██║ ██║
██║ ╚██████╔╝██║ ██║ ██████╔╝╚██████╔╝ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
Herramienta de Inteligencia de Fuentes Abiertas para la Dark Web
</pre>
<p align="center">
<a href="https://owasp.org/www-project-torbot/">
<img src="https://assets.kitploit.com/production/public/readmes/58461/8902e5836a324eae0ab281a9be7d62683e025d503ce6778cce6768fb908c1089/44f87cefbeddabc12e5302f46a08c8c511e4ec48c814d7fbb70dc1c317e73552-display-v1.webp" width="270" title="OWASP Foundation">
</a>
<img src="https://assets.kitploit.com/production/public/readmes/58461/1cc64251df7a699491fb27a2d732f724bf9fe989efb8dd3f7fe750e316f2b333/2a88ed821677ed3b033b12c0815ff31e60d4e86357dbbfc127253fe018096b96-display-v1.webp" width="250" title="Hacktoberfest 2022">
<img src="https://assets.kitploit.com/production/public/readmes/58461/54bda09bea5708a8bec2bc836b8decebec80caecd37906f84e76799af642bb6a/159aa0dc48e84a932700c3326470bd3053551554561821e67f78d3db2982e745-display-v1.webp" width="160" title="OpenSource">
</p>
### Enlaces de estado/redes sociales
[](https://github.com/DedSecInside/TorBot/actions/workflows/pytest.yml)
[](https://github.com/DedSecInside/TorBot/actions/workflows/flake8.yml)
[](https://join.slack.com/t/dedsec-inside/shared_invite/zt-i4jcgj8w-1ecHiSdRubwuppAzz8~yfg)
[](https://www.codetriage.com/dedsecinside/torbot)
[]()
[]()
### 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
```sh
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 con OTinstaller (Linux)
[OTinstaller](https://github.com/OSINTVerseHQ/OTinstaller) es un gestor de herramientas de terceros que instala la versión de `torbot` de PyPI en su propio virtualenv. No está mantenido por el equipo de TorBot, así que por favor reporta los problemas con él [en el rastreador de OTinstaller](https://github.com/OSINTVerseHQ/OTinstaller/issues).
```sh
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
```
### Ejecutar la CLI
```sh
python main.py --help
python main.py --version
python main.py -u https://example.com --depth 2 --visualize table
```
### Ejemplos comunes
```sh
# 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:
```sh
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](https://github.com/dedsecinside/torbot/blob/dev/docs/ANALYST.md) para el inicio rápido sin conexión, los formatos de salida, el límite de privacidad y los esquemas.
### Opciones
```text
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](https://github.com/DedSecInside/TorBoT/blob/master/Tor.md)
## 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](https://github.com/KingAkeem/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:
```text
code/
+-- TorBot/
+-- TorBotApp/
```
Luego ejecuta:
```sh
torbot app
```
Si TorBotApp está en otro lugar, use cualquiera de las siguientes opciones:
```sh
TORBOT_APP_DIR=/path/to/TorBotApp torbot app
torbot --app --app-dir /path/to/TorBotApp
```
Consulta [Desktop App Architecture](https://github.com/dedsecinside/torbot/blob/dev/docs/DESKTOP_APP.md) para ver cómo encajan la CLI, la UI opcional y los servicios de backend.
## Características seleccionadas
- [x] Renovación del módulo de visualización
- [x] Implementar búsqueda BFS para el webcrawler
- [x] Mejorar la estabilidad (manejar errores con elegancia, ampliar la cobertura de pruebas, etc.)
- [x] 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í](https://github.com/DedSecInside/TorBot/issues/new/choose).
### Directrices para desarrolladores
¡Damos la bienvenida a las contribuciones a este proyecto! Estas son algunas directrices a seguir:
1. Haz un fork del repositorio y crea una nueva rama para tu contribución.
2. Asegúrate de que tu código pase todas las pruebas ejecutando `pytest` antes de enviar un pull request a la rama `dev`.
3. Sigue la guía de estilo [PEP8](https://www.python.org/dev/peps/pep-0008/) para el código Python.
4. Asegúrate de añadir la documentación adecuada para cualquier nueva característica o cambio.
5. Al enviar un pull request, proporciona una descripción detallada de los cambios realizados.
## Referencias
1. M. Glassman y M. J. Kang, “Intelligence in the internet age: The emergence and evolution of Open Source Intelligence (OSINT),” Comput. Human Behav., vol. 28, no. 2, pp. 673–682, 2012.
2. D. Bradbury, “In plain view: open source intelligence,” Comput. Fraud Secur., vol. 2011, no. 4, pp. 5–9, 2011.
3. B. Butler, B. Wardman y N. Pratt, “REAPER: an automated, scalable solution for mass credential harvesting and OSINT,” 2016 APWG Symp. Electron. Crime Res., pp. 1–10, 2016.
4. B. Zantout y R. A. Haraty, “I2P Data Communication System I2P Data Communication System,” no. April 2002, 2014.
5. J. Qin, Y. Zhou, G. Lai, E. Reid, M. Sageman y H. Chen, “The dark web portal project: collecting and analyzing the presence of terrorist groups on the web,” in Proceedings of the 2005 IEEE international conference on Intelligence and Security Informatics, 2005, pp. 623–624.
6. D. Moore, T. Rid, D. Moore y T. Rid, “Cryptopolitik and the Darknet Cryptopolitik and the Darknet,” vol. 6338, 2016.
7. G. Weimann, “Going dark: Terrorism on the dark Web,” Stud. Confl. Terror., vol. 39, no. 3, pp. 195–206, 2016.
8. A. T. Zulkarnine, R. Frank, B. Monk, J. Mitchell y G. Davies, “Surfacing collaborated networks in dark web to find illicit and criminal content,” in Intelligence and Security Informatics (ISI), 2016 IEEE Conference on, 2016, pp. 109–114.
9. T. Minárik y A.-M. Osula, “Tor does not stink: Use and abuse of the Tor anonymity network from the perspective of law,” Comput. Law Secur. Rev., vol. 32, no. 1, pp. 111–127, 2016.
10. K. Loesing, S. J. Murdoch y R. Dingledine, “A Case Study on Measuring Statistical Data in the {T}or Anonymity Network,” in Proceedings of the Workshop on Ethics in Computer Security Research (WECSR 2010), 2010.
11. B. Nafziger, “Data Mining in the Dark : Darknet Intelligence Automation,” 2017.
12. I. Sanchez-Rola, D. Balzarotti y I. Santos, “The onions have eyes: A comprehensive structure and privacy analysis of tor hidden services,” in Proceedings of the 26th International Conference on World Wide Web, 2017, pp. 1251–1260.
13. Mouli VR, Jevitha KP. “Web Services Attacks and Security-A Systematic Literature Review.”, Procedia Computer Science. 2016 Jan 1;93:870-7.
14. Cova M, Felmetsger V, Vigna G. "Vulnerability analysis of web-based applications. InTest and Analysis of Web Services" 2007 (pp. 363-394). Springer, Berlin, Heidelberg.
15. B. R. Holland, “Enabling Open Source Intelligence (OSINT) in private social networks,” 2012.
16. S. Nakamoto, “Bitcoin: A Peer-to-Peer Electronic Cash System,” Cryptogr. Mail. List https//metzdowd.com, 2009.
17. M. Wesam, A. Nabki, E. Fidalgo, E. Alegre y I. De Paz, “Classifying Illegal Activities on Tor Network Based on Web Textual Contents”, vol. 1, pp. 35–43, 2017.
18. Sathyadevan S, Gangadharan S.“Crime analysis and prediction using data mining”. In Networks & Soft Computing (ICNSC), 2014 First International Conference on 2014 Aug 19 (pp. 406-412). IEEE.
19. Chau M, Chen H. "A machine learning approach to web page filtering using content and structure analysis. Decision Support Systems." 2008 Jan 1;44(2):482-94.
20. Ani R, Jose J, Wilson M, Deepa OS. “Modified Rotation Forest Ensemble Classifier for Medical Diagnosis in Decision Support Systems”, In Progress in Advanced Computing and Intelligent Engineering 2018 (pp. 137-146). Springer, Singapore.
21. Ani R, Augustine A, Akhil N.C. y Deepa O.S., 2016. “Random Forest Ensemble Classifier to Predict the Coronary Heart Disease Using Risk Factors”, In Proceedings of the International Conference on Soft Computing Systems (pp. 701-710). Springer, New Delhi.
## Mantenedores
- [X] [PS Narayanan](https://github.com/PSNAppz) - Copropietario
- [X] [KingAkeem](https://github.com/KingAkeem) - Copropietario
## Agradecimientos a Todos Nuestros Colaboradores
<a href="https://github.com/DedSecInside/TorBot/graphs/contributors">
<img src="https://contrib.rocks/image?repo=DedSecInside/TorBot" />
</a>
## Licencia
[GNU Public License](https://github.com/DedSecInside/TorBot/blob/dev/LICENSE.md)