Robin: strumento OSINT per il dark web basato sull'IA

Robin è uno strumento basato sull'IA per condurre indagini OSINT sul dark web. Sfrutta gli LLM per perfezionare le query, filtrare i risultati di ricerca dai motori di ricerca del dark web e fornire un riepilogo dell'indagine.

Installazione • Robin come MCP • Risoluzione dei problemi • Contribuire • Riconoscimenti

Architettura

Funzionalità

• 🤖 Supporto multi-modello – OpenAI, Claude, Gemini, Mistral, OpenRouter, Ollama o qualsiasi API compatibile con OpenAI (LM Studio, llama.cpp, Groq, ecc.).
• 🌐 Interfaccia web – Interfaccia basata su Streamlit per indagini interattive.
• 🔌 Supporto MCP – Esegui Robin da qualsiasi agente compatibile con MCP, utilizzando il modello dell'agente stesso. Vedi Robin come MCP.
• 💬 Approfondimenti conversazionali – Poni domande di approfondimento basate sui dati di un'indagine senza rieseguire la ricerca, con risposte tratte dai dati dell'indagine stessa.
• 🔀 Pivot con un clic – Query di approfondimento suggerite emerse dai risultati; fai clic su una per avviare una nuova indagine.
• 🐳 Pronto per Docker – Distribuzione Docker consigliata per un utilizzo pulito e isolato.

⚠️ Avvertenza

Questo strumento è destinato esclusivamente a scopi educativi e di indagine leciti. Accedere o interagire con determinati contenuti del dark web può essere illegale a seconda della giurisdizione. L'autore non è responsabile per qualsiasi uso improprio di questo strumento o dei dati raccolti tramite esso.

Usalo in modo responsabile e a tuo rischio. Assicurati di rispettare tutte le leggi pertinenti e le politiche istituzionali prima di condurre indagini OSINT.

Inoltre, Robin sfrutta API di terze parti (inclusi gli LLM). Sii cauto quando invii query potenzialmente sensibili e consulta i termini di servizio di qualsiasi provider di API o modello tu utilizzi.

Installazione

[!NOTE] Lo strumento necessita di Tor per eseguire le ricerche. Puoi installare Tor usando apt install tor su Linux/Windows(WSL) o brew install tor su Mac. Una volta installato, verifica se Tor è in esecuzione in background.

[!TIP] Fornisci la tua chiave API in un file .env (copia .env.example) oppure come variabili d'ambiente. Una chiave è sufficiente: Robin elenca i modelli per i provider che rileva. Le chiavi supportate sono OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, MISTRAL_API_KEY e OPENROUTER_API_KEY.

Per Ollama, non va inserito nulla nel tuo .env. Robin usa per impostazione predefinita http://host.docker.internal:11434, che è ciò di cui necessita l'installazione Docker consigliata. Restano comunque due cose a tuo carico:

1. Esegui il container con --add-host=host.docker.internal:host-gateway (il comando nel README lo fa già).
2. Fai in modo che Ollama ascolti su tutte le interfacce, poiché per impostazione predefinita si lega a 127.0.0.1 e un container non può raggiungerlo. Se lo avvii tu stesso, OLLAMA_HOST=0.0.0.0 ollama serve &. Se viene eseguito sotto systemd, sudo systemctl edit ollama.service, aggiungi [Service] e Environment="OLLAMA_HOST=0.0.0.0", poi sudo systemctl daemon-reload && sudo systemctl restart ollama.

Consulta TROUBLESHOOTING.md se ancora non compare.

Per qualsiasi altro provider compatibile con OpenAI (LM Studio, llama.cpp, Groq, ecc.), usa l'expander 🔌 Custom API Provider nella barra laterale — non sono necessarie modifiche al .env. Inserisci l'URL di base, una chiave API opzionale e, facoltativamente, un nome di modello se il provider non espone /v1/models per il rilevamento automatico.

Docker [Consigliato]

• Scarica l'immagine Docker più recente di Robin

docker pull apurvsg/robin:latest

• Crea un file .env nella cartella da cui esegui, con la tua chiave API al suo interno (vedi .env.example). Creala prima della prima esecuzione: se non esiste, Docker monta una cartella vuota al suo posto e Robin si avvia senza chiavi.

touch .env   # then add your API key to it

• Esegui l'immagine Docker come:

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