OnionSearch: cómo buscar en la red Tor desde la terminal con Python

OnionSearch: cómo buscar en la red Tor desde la terminal con Python
La red Tor siempre ha tenido un aura de misterio. No porque sea “oscura” en sí misma, sino porque acceder a su contenido suele requerir herramientas específicas, navegación manual y algo de paciencia.
Pero ¿qué pasaría si pudieras automatizar esa búsqueda y consultar múltiples motores .onion al mismo tiempo?
Ahí es donde entra OnionSearch.

¿Qué es OnionSearch?
OnionSearch es una herramienta desarrollada en Python que permite realizar búsquedas en múltiples motores de la red Tor de forma automatizada.
En lugar de entrar manualmente a cada buscador .onion, esta herramienta hace el trabajo por ti: consulta varios motores y recopila los resultados en un solo archivo.
Según su documentación, se trata de:
“Un script en Python3 que recolecta URLs desde diferentes motores de búsqueda
.onion.”
¿Por qué es interesante?
Trabajar con Tor normalmente implica:
- Abrir el navegador Tor
- Buscar manualmente
- Revisar resultados uno por uno
Con OnionSearch, puedes:
- Automatizar búsquedas
- Consultar múltiples motores al mismo tiempo
- Guardar resultados estructurados
- Analizar información sin interfaz gráfica
Esto lo vuelve especialmente útil para:
- Investigación OSINT
- Análisis de información
- Automatización de scraping
- Curiosidad técnica sobre la red Tor
Motores de búsqueda soportados
Una de sus mayores ventajas es la cantidad de motores .onion compatibles.
Incluye buscadores como:
- Ahmia
- Torch (variantes como tor66, tormax, etc.)
- DeepLink
- Haystack
- Phobos
- OnionLand
- entre otros
Esto permite obtener resultados mucho más amplios que usando un solo buscador.
Instalación
Tienes dos formas principales de instalarlo.
Opción 1: desde PyPI
pip3 install onionsearch
Opción 2: desde GitHub
git clone https://github.com/megadose/OnionSearch.git
cd OnionSearch
python3 setup.py install
Requisitos importantes
Antes de usar OnionSearch, necesitas:
- Python 3 instalado
- Tener Tor corriendo en tu sistema (proxy por defecto:
127.0.0.1:9050)
Esto es clave, porque sin Tor no podrás acceder a la red .onion.
Uso básico
El uso más simple es:
onionsearch "palabra clave"
Esto hará una búsqueda en todos los motores disponibles y generará un archivo con los resultados.
Opciones útiles
OnionSearch tiene muchas opciones que lo vuelven bastante potente.
Limitar resultados por motor
onionsearch "bitcoin" --limit 3
Elegir motores específicos
onionsearch "bitcoin" --engines tor66 deeplink phobos
Excluir motores
onionsearch "bitcoin" --exclude ahmia candle
Guardar resultados en archivo personalizado
onionsearch "bitcoin" --output resultados.csv
Escritura progresiva (muy útil)
onionsearch "bitcoin" --continuous_write True
Esto permite ver resultados en tiempo real usando:
tail -f resultados.csv
Formato de salida
Por defecto, OnionSearch genera un archivo CSV con:
- Motor de búsqueda
- Nombre del resultado
- URL
También puedes personalizar los campos:
--fields engine name link domain
Rendimiento y multiprocessing
La herramienta aprovecha múltiples núcleos del CPU:
- Usa
cpu_count() - 1por defecto - Ejecuta búsquedas en paralelo
- Mejora considerablemente la velocidad
Aunque también puedes desactivarlo:
--mp_units 1
Consideraciones importantes
Aquí conviene ser claro y realista:
- No todo lo que aparece en Tor es confiable
- Muchos enlaces pueden estar caídos
- Algunos contenidos pueden ser sensibles o ilegales
OnionSearch no filtra contenido, solo recopila resultados.
Por eso es importante usarlo con criterio.
¿Para qué sirve realmente?
Más allá del “misterio”, OnionSearch es una herramienta práctica para:
- Automatizar búsquedas en Tor
- Centralizar resultados
- Evitar navegación manual repetitiva
- Integrar en scripts más grandes
En otras palabras, convierte la red Tor en algo más cercano a un entorno de análisis que a una simple navegación.
Conclusión
OnionSearch demuestra algo interesante:
la red Tor no es solo un lugar para navegar, también puede explorarse de forma técnica y estructurada.
Si te interesa la seguridad, el análisis de información o simplemente entender cómo funcionan estas redes, esta herramienta es un excelente punto de partida.



