Robin: Herramienta OSINT de Dark Web impulsada por IA

Robin es una herramienta impulsada por IA para realizar investigaciones OSINT en la dark web. Aprovecha los LLM para refinar consultas, filtrar resultados de búsqueda de motores de búsqueda de la dark web y proporcionar un resumen de la investigación.

Instalación • Robin como MCP • Solución de problemas • Contribuir • Agradecimientos

Arquitectura

Características

• 🤖 Soporte multi-modelo – OpenAI, Claude, Gemini, Mistral, OpenRouter, Ollama o cualquier API compatible con OpenAI (LM Studio, llama.cpp, Groq, etc.).
• 🌐 Interfaz web – Interfaz basada en Streamlit para investigaciones interactivas.
• 🔌 Soporte MCP – Ejecuta Robin desde cualquier agente compatible con MCP, utilizando el modelo propio de ese agente. Consulta Robin como MCP.
• 💬 Preguntas de seguimiento conversacionales – Formula preguntas de seguimiento fundamentadas sobre una investigación sin volver a ejecutar la búsqueda, respondidas a partir de los propios datos de esa investigación.
• 🔀 Pivotes con un clic – Consultas de seguimiento sugeridas que surgen de los hallazgos; haz clic en una para lanzar una nueva investigación.
• 🐳 Listo para Docker – Despliegue recomendado con Docker para un uso limpio y aislado.

⚠️ Aviso legal

Esta herramienta está destinada únicamente a fines educativos y de investigación lícita. Acceder o interactuar con cierto contenido de la dark web puede ser ilegal según tu jurisdicción. El autor no se responsabiliza de ningún uso indebido de esta herramienta ni de los datos recopilados con ella.

Úsala de forma responsable y bajo tu propio riesgo. Asegúrate de cumplir con todas las leyes y políticas institucionales pertinentes antes de realizar investigaciones OSINT.

Además, Robin utiliza API de terceros (incluidos LLM). Ten cuidado al enviar consultas potencialmente sensibles y revisa los términos de servicio de cualquier proveedor de API o modelo que utilices.

Instalación

[!NOTE] La herramienta necesita Tor para realizar las búsquedas. Puedes instalar Tor usando apt install tor en Linux/Windows(WSL) o brew install tor en Mac. Una vez instalado, confirma si Tor se está ejecutando en segundo plano.

[!TIP] Proporciona tu clave de API ya sea en un archivo .env (copia .env.example) o como variables de entorno. Una clave es suficiente: Robin lista los modelos de los proveedores que encuentre. Las claves compatibles son OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, MISTRAL_API_KEY y OPENROUTER_API_KEY.

Para Ollama, no se pone nada en tu .env. Robin usa por defecto http://host.docker.internal:11434, que es lo que necesita la instalación recomendada con Docker. Aún quedan dos cosas de tu parte:

1. Ejecuta el contenedor con --add-host=host.docker.internal:host-gateway (el comando del README ya lo hace).
2. Haz que Ollama escuche en todas las interfaces, ya que por defecto se vincula a 127.0.0.1 y un contenedor no puede alcanzar esa dirección. Si lo inicias tú mismo, OLLAMA_HOST=0.0.0.0 ollama serve &. Si se ejecuta bajo systemd, sudo systemctl edit ollama.service, añade [Service] y Environment="OLLAMA_HOST=0.0.0.0", luego sudo systemctl daemon-reload && sudo systemctl restart ollama.

Consulta TROUBLESHOOTING.md si aún no aparece.

Para cualquier otro proveedor compatible con OpenAI (LM Studio, llama.cpp, Groq, etc.), usa el expansor 🔌 Custom API Provider en la barra lateral — no se requieren cambios en .env. Introduce la URL base, una clave de API opcional y, opcionalmente, un nombre de modelo si el proveedor no expone /v1/models para el descubrimiento automático.

Docker [Recomendado]

• Descarga la última imagen Docker de Robin

docker pull apurvsg/robin:latest

• Crea un archivo .env en la carpeta desde la que ejecutas, con tu clave de API en él (consulta .env.example). Créalo antes de la primera ejecución: si no existe, Docker monta una carpeta vacía en su lugar y Robin se inicia sin claves.

touch .env   # then add your API key to it

• Ejecuta la imagen Docker como:

docker run --rm \
   -v "$(pwd)/.env:/app/.env" \
   --add-host=host.docker.internal:host-gateway \
   -p 8501:8501 \
   apurvsg/robin:latest