IG-Detective 🕵️‍♂️📸

Erstellt von @shredzwho | 💖 Dieses Projekt sponsern

IG-Detective ist ein leistungsstarkes, Python-basiertes OSINT-Tool (Open Source Intelligence) für Instagram. Es bietet eine Premium-Interaktiv-Shell zur Durchführung tiefergehender Analysen von Instagram-Konten, zum Extrahieren des Standortverlaufs, zur Kartierung von Interaktionen und zur Erstellung automatisierter Ermittlungsberichte.

[!WARNING] Haftungsausschluss: Dieses Tool dient nur zu Bildungs- und Forschungszwecken. Nutzen Sie es verantwortungsbewusst und in Übereinstimmung mit den Nutzungsbedingungen von Instagram. Der Autor übernimmt keine Verantwortung für Missbrauch.

---

⚡ Features

🛡️ Umgehung & Tarnung (Fortgeschritten)

• TLS-Fingerabdruck-Spoofing: Verwendet einen headless Playwright chromium-Browser mit playwright-stealth, um eine reale Umgebung nachzuahmen und dabei Cloudflare- und CDN-Ratenbegrenzungen vollständig zu umgehen.
• Tiefe Umgehungs-Fallback: Fällt automatisch auf einen nicht authentifizierten Headless-Browser-Fetch zurück, wenn eine authentifizierte Sitzung shadowbanned ist (z. B. HTTP 401/429/400-Blöcke), wobei Cookies weggelassen und Header gefälscht werden, um eine makellose makellose Verbindung zu emulieren.
• Poisson-Jitter: Menschlich wirkende, zufällige Verzögerungen zwischen Anfragen, um natürliches Benutzerverhalten nachzuahmen.

⚡ Leistung & Optimierung

• Headless-Speicheroptimierung: Abgespeckte Playwright-Browserkonfiguration, die über Routenabfang schwere visuelle Assets (Bilder, Schriftarten, Stylesheets) explizit verwirft, um extrem schnelle Abfragegeschwindigkeiten zu erreichen.
• Asynchroner Datenexport: Nutzt paralleles Herunterladen mit ThreadPool für den data-Archivierungsbefehl, wodurch die vollständige Medienreplikation des Profils drastisch beschleunigt wird.

🔍 Kernaufklärung

• Benutzerinfo: Umfassende Profildetails (ID, Bio, Follower, Geschäftsstatus).
• Follower/Abonnements: Liste und Export des sozialen Netzwerks des Ziels.
• Beitragsanalyse: Detaillierte Aufschlüsselung der letzten Inhalte, Likes und Kommentare.

📍 Erweiterte OSINT

• Interaktives Geodaten-Mapping: Extrahiert GPS-Koordinaten aus Beiträgen und generiert eine Folium interactive_map.html mit lesbaren Adressen und klickbaren Markierungen.
• Social Network Analysis (sna): Kartiert Interaktionen, um den "Inner Circle" zu identifizieren – die 10 am stärksten mit dem Ziel verbundenen Benutzer.
• Temporale Aktivitätsprofilierung (temporal): Verwendet DBSCAN-Clustering, um die "Schlafphase" des Ziels zu identifizieren und die primäre Zeitzone vorherzusagen.
• Story-Extraktion (stories): Aktive Story-URLs abrufen.

🔬 Forschungsgestützte forensische Module (Neueste Technologie)

• Konto-Wiederherstellungs-Enumeration (recovery): Löst den Passwort-Reset-Fluss aus, um maskierte Kontakthinweise zur administrativen E-Mail-Verifizierung preiszugeben.
• Ko-Besuchs-Analyse (intersect): Identifiziert physische physische Treffpunkte durch Abgleich von GPS/Zeit-Schnittpunkten zwischen zwei Zielen.
• Stilometrie (stylometry): Generiert eine digitale "linguistische Signatur", um mehrere Konten auf Basis von Bigramm- und Emoji-Verteilung zu verknüpfen.
• Engagement-Audit (audit): Statistische Erkennung von unauthentischer Bot-Aktivität mittels zeitlicher Jitter-Varianz.

📦 Untersuchungsmanagement

• Ein-Klick-Export (data): Lädt automatisch die Follower-Liste, Abonnement-Liste und Timeline-Medien (mit Metadaten-JSON) eines Ziels herunter und verpackt sie in einem einzigen ZIP-Archiv.
• Automatisierte Berichterstellung: Jeder Befehl speichert Ergebnisse automatisch als JSON- und TXT-Berichte in data/<target>/.
• Autonomer Batch-Modus: Verarbeitet mehrere Ziele nacheinander aus einer Textdatei.
• Intelligentes Caching: Blitzschnelle wiederholte Abfragen durch TTL-basiertes Caching.

---

🚀 Installation

1. Repository klonen

   root@kitploit:~

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

2. Virtuelle Umgebung einrichten

   root@kitploit:~

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

3. Abhängigkeiten installieren

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Mit Docker ausführen (Empfohlen)

Sie können IG-Detective vollständig in Docker ausführen, um Abhängigkeitsprobleme zu vermeiden. Der Container erfordert ein interaktives TTY (-it) und einen Volume-Mount, um Ihre forensischen Berichte zu speichern.

1. Docker Compose verwenden (Am einfachsten)

   root@kitploit:~

   docker-compose run --rm detective
   

2. Standard Docker verwenden

   root@kitploit:~

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

---

🛠 Verwendung

1. Shell starten

   root@kitploit:~

   python3 main.py
   # or use the provided wrapper:
   ./run.sh
   

2. Kernbefehle Sobald Sie sich in der Shell befinden, müssen Sie zuerst ein Ziel festlegen, bevor Sie Analysemodule ausführen:

---

📑 Ausführliche Dokumentation

Für einen tiefen Einblick in die Systemarchitektur, forensische Methoden und Umgehungslogik siehe: 👉 DOCUMENTATION.md

---

📂 Projektstruktur

• main.py: Haupt-Einstiegspunkt für die Shell.
• run.sh: Start-Wrapper-Skript.
• src/api/: Netzwerkschicht mit dem Playwright-Stealth-Client und Auth-Manager.
• src/core/: Grundschicht mit Datenmodellen und Konfiguration.
• src/modules/: Geschäftslogikschicht mit Scrapern und tiefgehenden Analysetools.
• src/cli/: Präsentationsschicht mit interaktiver Eingabeaufforderung und Rich-Formatierern.
• data/: Automatisierte Ermittlungsberichte (git-ignoriert).

---

🤝 Mitwirken

Sie können dieses Projekt gerne forken und Pull-Requests einreichen. Bei größeren Änderungen eröffnen Sie bitte zuerst ein Issue, um zu besprechen, was Sie ändern möchten.

📜 Lizenz

[MIT]