IG-Detective 🕵️‍♂️📸

Creato da @shredzwho | 💖 Sponsorizza questo progetto

IG-Detective è uno strumento di Open Source Intelligence (OSINT) ad alte prestazioni basato su Python per Instagram. Offre una shell interattiva premium per eseguire analisi approfondite sugli account Instagram, estrarre la cronologia delle posizioni, mappare le interazioni e generare report investigativi automatizzati.

[!WARNING] Disclaimer: Questo strumento è solo a scopo educativo e di ricerca. Usalo responsabilmente e in conformità con i Termini di Servizio di Instagram. L'autore non è responsabile per qualsiasi uso improprio.

---

⚡ Caratteristiche

🛡️ Evasione e Stealth (Avanzato)

• Spoofing dell'impronta TLS: Utilizza un browser headless Playwright chromium con playwright-stealth per imitare un ambiente reale, bypassando completamente i limiti di velocità di Cloudflare e CDN.
• Fallback di Evasione Profonda: Passa automaticamente a un fetch headless non autenticato se una sessione autenticata è shadowbannata (es. blocchi HTTP 401/429/400), omettendo i cookie e forgiando gli header per emulare una connessione incontaminata.
• Jitter di Poisson: Ritardi randomizzati simili a quelli umani tra le richieste per imitare il comportamento naturale dell'utente.

⚡ Prestazioni e Ottimizzazione

• Ottimizzazione della memoria headless: Configurazione del browser Playwright ridotta all'osso che elimina esplicitamente gli asset visivi pesanti (immagini, font, fogli di stile) tramite intercettazione delle route per ottenere velocità di interrogazione ultrarapide.
• Esportazione asincrona dei dati: Utilizza il download parallelo ThreadPool per il comando di archiviazione data, accelerando notevolmente la replica completa dei media del profilo.

🔍 Ricognizione Principale

• Informazioni Utente: Dettagli completi del profilo (ID, Bio, Follower, Stato Business).
• Follower/Following: Elenca ed esporta la rete sociale del target.
• Analisi dei Post: Analisi dettagliata dei contenuti recenti, dei like e dei commenti.

📍 OSINT Avanzato

• Mappatura Geospaziale Interattiva: Estrae le coordinate GPS dai post e genera una interactive_map.html di Folium con indirizzi leggibili e pin cliccabili.
• Analisi della Rete Sociale (sna): Mappa le interazioni per identificare il "Circolo Ristretto"—i 10 utenti più connessi al target.
• Profilazione Temporale dell'Attività (temporal): Utilizza il clustering DBSCAN per identificare il "gap di sonno" del target e prevedere il suo fuso orario principale.
• Estrazione delle Storie (stories): Recupera gli URL delle storie attive.

🔬 Moduli Forensi Basati sulla Ricerca (All'Avanguardia)

• Enumerazione del Recupero Account (recovery): Attiva il flusso di reimpostazione della password per rivelare suggerimenti di contatto mascherati per la verifica amministrativa via email.
• Analisi di Co-Visitazione (intersect): Identifica punti di incontro fisici incrociando le intersezioni GPS/Tempo tra due target.
• Stilometria (stylometry): Genera una "Firma Linguistica" digitale per collegare più account basata sulla distribuzione di bigrammi ed emoji.
• Audit del Coinvolgimento (audit): Rilevamento statistico di attività bot inautentiche tramite varianza del jitter temporale.

📦 Gestione delle Indagini

• Esportazione con un Click (data): Scarica automaticamente la lista dei follower, la lista dei following e i media della cronologia (con JSON dei metadati) di un target, impacchettati in un unico archivio ZIP.
• Reportistica Automatica: Ogni comando salva automaticamente i risultati in report JSON e TXT in data/<target>/.
• Modalità Batch Autonoma: Elabora più target in sequenza da un file di testo.
• Cache Intelligente: Ripetizione di query fulminee grazie a una cache basata su TTL.

---

🚀 Installazione

1. Clona il repository

   root@kitploit:~

   git clone https://github.com/shredzwho/IG-Detective.git
   cd IG-Detective
   

2. Imposta l'ambiente virtuale

   root@kitploit:~

   python3 -m venv venv
   source venv/bin/activate  # Su Windows: venv\Scripts\activate
   

3. Installa le dipendenze

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Esegui con Docker (Consigliato)

Puoi eseguire IG-Detective interamente all'interno di Docker per evitare problemi di dipendenze. Il container richiede un TTY interattivo (-it) e un mount di volume per salvare i tuoi report forensi.

1. Usando Docker Compose (Più facile)

   root@kitploit:~

   docker-compose run --rm detective
   

2. Usando Docker standard

   root@kitploit:~

   docker build -t ig-detective .
   docker run -it -v $(pwd)/data:/app/data ig-detective
   

---

🛠 Utilizzo

1. Avvia la shell

   root@kitploit:~

   python3 main.py
   # oppure usa lo script wrapper fornito:
   ./run.sh
   

2. Comandi principali Una volta all'interno della shell, devi prima impostare un target prima di eseguire i moduli di analisi:

---

📑 Documentazione Dettagliata

Per un'analisi approfondita dell'architettura del sistema, delle metodologie forensi e della logica di evasione, consulta: 👉 DOCUMENTATION.md

---

📂 Struttura del Progetto

• main.py: Punto di ingresso principale per la shell.
• run.sh: Script wrapper di avvio.
• src/api/: Livello di rete contenente il client stealth Playwright e il gestore dell'autenticazione.
• src/core/: Livello fondamentale con modelli di dati e configurazione.
• src/modules/: Livello di logica di business con scraper e strumenti di analisi approfondita.
• src/cli/: Livello di presentazione con il prompt interattivo e i formattatori Rich.
• data/: Report investigativi automatizzati (ignorati da git).

---

🤝 Contributi

Sentiti libero di fare un fork di questo progetto e inviare pull request. Per modifiche importanti, apri prima un issue per discutere cosa vorresti cambiare.

📜 Licenza

[MIT]