🕵️‍♂️ WhoCord v1.1

Verwandle jeden Benutzernamen, jede E-Mail, Domain, Telefonnummer, jedes Bild, jede URL oder jeden Suchstring in ein vollständiges Identitätsprofil.

WhoCord ist eine modulare OSINT-Ermittlungsplattform, die Dutzende Open-Source-Tools ausführt, einen Wissensgraphen erstellt, Korrelationen erkennt und einen KI-optimierten dunkelthematisierten HTML-Bericht erstellt – alles live auf ein modernes React-Dashboard gestreamt.

⚡ Funktionen

• 8 Ermittlungsmodule – Benutzername/Manuell, Discord, E-Mail, Domäne, Telefon, Bild, URL, Datensonde (Auto-Erkennung).
• Discord-native Linkauflösung – extrahiert und löst Instagram-, TikTok-, Facebook- und Twitter-Tracking-Links auf, die von einem Zielbenutzer geteilt werden.
• Vollständige Identitätspipeline – Namen, E-Mails, Standorte, Datenlecks, GitHub-Verlauf, Avatar-Metadaten und Google-Kontoinformationen (GHunt).
• E-Mail-Intelligenz – Holehe (Seitenregistrierungen), h8mail, HIBP, EmailRep, GHunt, Blackbird-E-Mail-Suche, MOSINT (Social-Account-Flags).
• Domänenermittlung – WHOIS, DNS-Einträge, SSL-Zertifikat, IP-Geolokalisierung, Subdomain-Enumeration, theHarvester.
• Telefonermittlung – Nummernvalidierung, Anbieterabfrage, PhoneInfoga OSINT.
• Bildanalyse – EXIF-Metadaten, Perceptual Hash, umgekehrte Bildersuche, OCR-Textextraktion.
• URL-Analyse – HTTP-Metadaten, Redirect-Trace, Seitenmetadaten, Open-Graph-Tags, Safe-Browsing-Prüfung, Wayback-Schnappschuss.
• Datensonde – füge alles ein (E-Mail, Domäne, Telefon, URL, Benutzername) und WhoCord erkennt den Typ automatisch.
• Wissensgraph & Korrelationen – 5 Detektoren (Avatar-Wiederverwendung, E-Mail-Plattform-Cluster, Benutzernamensvarianten, Name-E-Mail-Verknüpfung, Standortkonsistenz).
• KI-generierte Berichte – LLaMA 3.3 (über Groq) erstellt eine strukturierte Erzählung und Personenzusammenfassung.
• Dunkelthematisierter HTML-Bericht – einklappbare Plattformkarten, Avatar-Anzeige, Datenleck-Tags, Pivot-Unterberichte, technische Daten.
• Live-SSE-Streaming – verfolge Ermittlungen in Echtzeit mit Phasenliste, Trefferkarten und Konsolenprotokollen.
• Pivot-System – rekursive Untersuchung entdeckter E-Mails/Benutzernamen mit Benutzerbestätigungsmodul.
• Sicherer Token-Speicher – API-Schlüssel werden in Ihrem OS-Keyring gespeichert, niemals im Klartext.
• Web-Dashboard – führe Ermittlungen aus Ihrem Browser durch, schalte Tools um, verwalte Tokens, sieh dir den Verlauf an.

🚀 Schnellstart (empfohlen)

1. Lade das portable Zip von der Releases-Seite herunter (Linux 64‑Bit, ~500 MB).
2. Entpacke das Archiv an einem beliebigen Ort:
   root@kitploit:~

   unzip WhoCord.zip -d WhoCord
   

3. Führe das Web-Dashboard aus:
   root@kitploit:~

   cd WhoCord
   ./run.sh
   

   (öffnet deinen Browser automatisch)

Es ist keine Python-, pip- oder Tool-Installation erforderlich – alles ist darin gebündelt.

📦 Installation (aus dem Quellcode – für Entwickler)

1. Klone das Repository

git clone https://github.com/Siv-nick/WhoCord.git
cd WhoCord

2. Erstelle eine Python-Virtualenv

python3 -m venv venv
source venv/bin/activate   # Linux / macOS

3. Installiere WhoCord und seine Python-Abhängigkeiten

pip install -e .

4. Installiere externe Befehlszeilentools (meiste über pip)

Alle erforderlichen Tools können mit einem einzigen pip install-Befehl installiert werden:

# Tools zur Benutzernamensuche
pip install sherlock-project maigret naminter linkook

# Tools zur E-Mail-Intelligenz
pip install holehe h8mail theHarvester

# GitHub- & Google-Tools
pip install gitfive ghunt

# Telefon- & Bildanalyse
pip install phoneinfoga pillow imagehash pytesseract

# Domänenermittlung
pip install dnspython

5. Installiere Blackbird (E-Mail- und Benutzernamensuche auf über 600 Seiten)

git clone https://github.com/p1ngul1n0/blackbird
cd blackbird
pip install -r requirements.txt
cd ..

Die erforderliche Datendatei (wmn-data.json) wird bei der ersten Verwendung automatisch heruntergeladen. Falls das fehlschlägt, lade sie manuell von WhatsMyName herunter und lege sie in blackbird/data/ ab.

6. Installiere systemweite WHOIS (erforderlich für Domänenermittlungen)

sudo apt install whois          # Debian/Ubuntu
# brew install whois            # macOS

7. (Optional) Authentifiziere GHunt für Google-Konto-Intelligenz

ghunt login

Folge den Anweisungen, um dich mit deinem Google-Konto zu authentifizieren.

8. Erstelle das Frontend (erforderlich für Quellinstallationen)

Das Web-Dashboard benötigt ein kompiliertes React-Frontend. Stelle sicher, dass Node.js 18+ und npm installiert sind, und führe dann Folgendes aus:

cd frontend
npm install
npm run build
cd ..

Dadurch wird der Ordner frontend/dist/ erstellt, der von Flask automatisch bereitgestellt wird.

9. Starte das Web-Dashboard

python web_app.py

Öffne dann http://127.0.0.1:5000.
Oder verwende den Ein-Klick-Starter: ./run.sh.

🚀 Verwendung

Web-Dashboard (primäre Schnittstelle)

Das Dashboard bietet acht Ermittlungsmodule:

Live-Ermittlungsseite zeigt:

• Phasenliste mit Echtzeit-Status
• Trefferkarten (E-Mails, Namen, Datenlecks, Korrelationen)
• Konsolenprotokolle (rohe Tool-Ausgaben)
• Pivot-Bestätigungsmodul (wenn aktiviert)

Verlaufsseite – Liste aller vergangenen Ermittlungen mit Links zu Berichten und JSON-Intel.

Konfigurationsseite – API-Tokens verwalten, Tools umschalten, Pivot-Optionen einstellen, Tools aktualisieren.

Interaktives Menü (legacy CLI)

discord-osint

Verwende dann das nummerierte Menü, um Tools umzuschalten, Tokens zu setzen und Ermittlungen zu starten.

Befehlszeilenmodus (eingeschränkt auf manuell/discord)

discord-osint --mode manual --target someusername --output html --debug

📁 Ausgabedateien

Alle Ergebnisse werden in investigation_cache/ gespeichert:

HTML-Berichtsabschnitte

• Identität (Discord-Handle, Namenshinweise, Standort, Sprache, Konfidenzwerte)
• Personenzusammenfassung (KI)
• Soziale Profile (einklappbare Plattformkarten mit Avataren, Biografien, zusätzlichen Feldern)
• E-Mail-Intelligenz (Datenleck-Tags, MOSINT-Flags)
• Intelligenzanalyse (Graphenstatistiken, Erzählung, Korrelationen)
• Pivot-Unterermittlungen
• Technische Daten (WHOIS, DNS, SSL, IP-Geolokalisierung, Subdomains, theHarvester, Telefon, URL-Analyse, GHunt)

🛠️ Tools & Technologien

WhoCord integriert diese Open-Source-OSINT-Projekte:

🔄 Aktualisierungen

Siehe CHANGELOG.md für den Versionsverlauf.

🔒 Sicherheit & Datenschutz

• Tokens werden niemals im Klartext gespeichert – sie werden in Ihrem OS-Keyring aufbewahrt.
• config.json enthält nur nicht-sensible Umschalter.
• Alle Ermittlungsdaten bleiben auf Ihrem Rechner im Ordner investigation_cache/.

⚠️ Haftungsausschluss

WhoCord ist nur für Bildungszwecke und autorisierte Sicherheitstests bestimmt.
Verwenden Sie es nicht, um Personen zu belästigen, zu stalken oder deren Privatsphäre zu verletzen.
Der Autor übernimmt keine Haftung für Missbrauch.

📄 Lizenz

MIT-Lizenz