IG-Detective 🕵️‍♂️📸

Créé par @shredzwho | 💖 Soutenir ce projet

IG-Detective est un outil OSINT (Open Source Intelligence) haute performance pour Instagram, écrit en Python. Il offre un shell interactif premium permettant d'effectuer des analyses approfondies sur des comptes Instagram, d'extraire l'historique de localisation, de cartographier les interactions et de générer des rapports d'investigation automatisés.

[!WARNING] Avertissement : Cet outil est destiné uniquement à des fins éducatives et de recherche. Utilisez-le de manière responsable et conformément aux conditions d'utilisation d'Instagram. L'auteur n'est pas responsable d'une mauvaise utilisation.

---

⚡ Fonctionnalités

🛡️ Contournement et Furtivité (Avancé)

• Usurpation d'empreinte TLS : Utilise un navigateur headless Playwright chromium avec playwright-stealth pour imiter un environnement réel, contournant complètement Cloudflare et la limitation de débit CDN.
• Repli furtif profond : Bascule automatiquement vers une récupération headless non authentifiée si une session authentifiée est shadowbannée (ex. : blocages HTTP 401/429/400), en omettant les cookies et en forgeant les en-têtes pour émuler une connexion vierge.
• Poisson Jitter : Délais aléatoires semblables à un comportement humain entre les requêtes pour imiter un comportement naturel.

⚡ Performance et Optimisation

• Réglage mémoire headless : Configuration réduite du navigateur Playwright qui abandonne explicitement les éléments visuels lourds (images, polices, feuilles de style) via l'interception de routes pour atteindre des vitesses de requête ultra-rapides.
• Export de données asynchrone : Utilise le téléchargement parallèle ThreadPool pour la commande d'archivage data, accélérant considérablement la réplication complète des médias du profil.

🔍 Reconnaissance de base

• Infos utilisateur : Détails complets du profil (ID, Bio, Abonnés, Statut professionnel).
• Abonnés/Abonnements : Liste et exportation du réseau social de la cible.
• Analyse des publications : Analyse détaillée du contenu récent, des likes et des commentaires.

📍 OSINT Avancé

• Cartographie géospatiale interactive : Extrait les coordonnées GPS des publications et génère un interactive_map.html Folium avec des adresses lisibles et des marqueurs cliquables.
• Analyse du réseau social (sna) : Cartographie les interactions pour identifier le « Cercle intime » — les 10 utilisateurs les plus fortement connectés à la cible.
• Profilage d'activité temporelle (temporal) : Utilise le clustering DBSCAN pour identifier la « période de sommeil » de la cible et prédire son fuseau horaire principal.
• Extraction d'histoires (stories) : Récupère les URL des stories actives.

🔬 Modules forensiques de pointe basés sur la recherche

• Énumération de récupération de compte (recovery) : Déclenche le flux de réinitialisation de mot de passe pour révéler les indices de contact masqués pour la vérification administrative par e-mail.
• Analyse de co-visitation (intersect) : Identifie les points de rencontre physiques en croisant les intersections GPS/temps entre deux cibles.
• Stylométrie (stylometry) : Génère une « signature linguistique » numérique pour lier plusieurs comptes basée sur la distribution des bigrammes et des emojis.
• Audit d'engagement (audit) : Détection statistique d'activité de bot inauthentique via la variance de gigue temporelle.

📦 Gestion des enquêtes

• Export en un clic (data) : Télécharge automatiquement la liste des abonnés, la liste des abonnements et les médias de la timeline (avec métadonnées JSON) d'une cible, le tout empaqueté dans une archive ZIP unique.
• Rapports automatisés : Chaque commande enregistre automatiquement les résultats dans des rapports JSON et TXT dans data/<target>/.
• Mode batch autonome : Traite plusieurs cibles séquentiellement à partir d'un fichier texte.
• Cache intelligent : Requêtes répétées ultra-rapides grâce à un cache basé sur TTL.

---

🚀 Installation

1. Cloner le dépôt

   root@kitploit:~

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

2. Configurer l'environnement virtuel

   root@kitploit:~

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

3. Installer les dépendances

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Exécution avec Docker (Recommandé)

Vous pouvez exécuter IG-Detective entièrement dans Docker pour éviter les problèmes de dépendances. Le conteneur nécessite un TTY interactif (-it) et un montage de volume pour enregistrer vos rapports forensiques.

1. Avec Docker Compose (le plus simple)

   root@kitploit:~

   docker-compose run --rm detective
   

2. Avec Docker standard

   root@kitploit:~

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

---

🛠 Utilisation

1. Lancer le shell

   root@kitploit:~

   python3 main.py
   # ou utiliser le script fourni :
   ./run.sh
   

2. Commandes principales Une fois dans le shell, vous devez d'abord définir une cible avant d'exécuter les modules d'analyse :

---

📑 Documentation détaillée

Pour une analyse approfondie de l'architecture du système, des méthodologies forensiques et de la logique de contournement, voir : 👉 DOCUMENTATION.md

---

📂 Structure du projet

• main.py : Point d'entrée principal du shell.
• run.sh : Script de lancement.
• src/api/ : Couche réseau contenant le client furtif Playwright et le gestionnaire d'authentification.
• src/core/ : Couche de base avec les modèles de données et la configuration.
• src/modules/ : Couche de logique métier avec les scrappers et les outils d'analyse avancée.
• src/cli/ : Couche de présentation avec l'invite interactive et les formateurs Rich.
• data/ : Rapports d'enquête automatisés (ignorés par git).

---

🤝 Contribution

N'hésitez pas à forker ce projet et à soumettre des pull requests. Pour les modifications majeures, veuillez d'abord ouvrir une issue pour discuter de ce que vous souhaitez changer.

📜 Licence

[MIT]