WhoCord

Un canevas OSINT interactif qui s'enrichit à chaque découverte. Commencez par une graine — un utilisateur Discord, un nom d'utilisateur, un email, un domaine, un téléphone, une image ou une URL — et regardez la carte se construire en temps réel.

Stars Issues

Captures d'écran

Galerie : 1 · 2 · 3



1. Page de démarrage	2. Canevas avec panneau de détails

3. Arbres d'investigation multiples (392 nœuds, 391 arêtes)

Fonctionnalités

Modules

Discord — profil, comptes connectés, bio, avatar, recherche de liens dans l'historique des messages
Nom d'utilisateur — User Scanner, WhatsMyName, Maigret, Linkook, Blackbird (600+ plateformes)
Email — Holehe, HIBP, h8mail, EmailRep, GHunt, Scylla, Gravatar, MOSINT, vérification SMTP
Domaine — WHOIS, DNS, SSL, sous-domaines, géolocalisation IP, Wayback
Téléphone — validation, recherche d'opérateur, PhoneInfoga
Image — EXIF, GPS, hash perceptuel, recherche d'image inversée, OCR
URL — trace HTTP, redirections, métadonnées de page, vérification Safe Browsing
Probe — détecte automatiquement le type d'entrée et l'achemine vers le bon module
Pivot — enquête récursivement sur les nouveaux emails et noms d'utilisateur (profondeur limitée)

Renseignement

Graphe de connaissances construit avec networkx
Cinq détecteurs de corrélation : réutilisation d'avatar, clusters email-plateforme, variantes de nom d'utilisateur, liens nom-email, cohérence de localisation
Narratif IA via Groq (Llama 3.3 70B)

Canevas

Résultats en direct via Server-Sent Events
Vue cartes avec recherche, chat IA, éditeur de thème, export PNG et .whocord-map
Palette de commandes (Cmd/Ctrl+K)

Rapports

Rapport HTML autonome (fonctionne hors ligne)
Résumé de persona IA et rapport markdown

Installation

1. Prérequis

Python 3.10+
Node.js 18+ (uniquement pour l'interface canevas moderne)
Git
whois — sudo apt install whois / brew install whois

2. Cloner et configurer

git clone https://github.com/Siv-nick/WhoCord.git
cd WhoCord
python3 -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt

3. Outils OSINT externes

pip install user-scanner maigret linkook socialscan
pip install holehe h8mail gitfive socid-extractor
pip install theharvester

Optionnel : pip install toutatis sharetrace. Scylla et PhoneInfoga nécessitent des téléchargements manuels. Blackbird est cloné à la première utilisation.

4. Compiler le frontend (optionnel)

cd frontend
npm install
npm run build
cd ..

5. Lancer

python web_app.py

Ouvrez http://127.0.0.1:5000.

6. Définir les jetons d'API

Définissez-les depuis le panneau Config dans l'interface web. Ils sont stockés dans le trousseau de votre OS.

Jeton	Requis pour
`DISCORD_TOKEN`	Mode Discord
`GITHUB_TOKEN`	Limites de taux API GitHub plus élevées
`GROQ_API_KEY`	Narratif IA et chat
`INSTAGRAM_SESSION`	Toutatis

Installation complète

git clone https://github.com/Siv-nick/WhoCord.git
cd WhoCord
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
pip install user-scanner maigret linkook socialscan holehe h8mail gitfive
cd frontend && npm install && npm run build && cd ..
python web_app.py

Utilisation

Interface web : ouvrez http://127.0.0.1:5000, cliquez sur Blank canvas, appuyez sur Cmd/Ctrl+K, choisissez un module, saisissez une cible.

CLI :

python -m discord_osint --mode discord \
  --target 123456789012345678 \
  --token "YOUR_TOKEN" \
  --guild 987654321098765432

python -m discord_osint --mode manual --target johndoe
python -m discord_osint --interactive

Option	Description
`--mode {discord,manual}`	Mode d'investigation
`--target`	Nom d'utilisateur ou ID utilisateur Discord
`--token`	Jeton Discord
`--guild`	ID de guilde
`--output {json,markdown,html}`	Format du rapport
`--debug`	Journalisation verbeuse
`--interactive`	Forcer le menu

Configuration

Les paramètres se trouvent dans discord_osint/config.json. Les jetons se trouvent dans le trousseau de l'OS.

Options courantes :

Option	Défaut	Outil
`ENABLE_USER_SCANNER`	Activé	User Scanner
`ENABLE_WMN`	Activé	WhatsMyName
`ENABLE_HOLEHE`	Activé	Holehe
`ENABLE_HIBP`	Activé	HaveIBeenPwned
`ENABLE_GHUNT`	Activé	GHunt
`ENABLE_MAIGRET`	Désactivé	Maigret
`ENABLE_AI_REPORT`	Activé	Rapport Groq
`ENABLE_PIVOTING`	Désactivé	Pivots récursifs
`ENABLE_CACHING`	Désactivé	Charger les renseignements précédents

Liste complète : discord_osint/tools_config.py.

Lorsque le pivot est activé, chaque nouvel email ou nom d'utilisateur devient une graine pour une investigation enfant. Configurez avec PIVOT_EMAIL, PIVOT_USERNAME, PIVOT_MAX_DEPTH (défaut 3), PIVOT_MAX_SEEDS (défaut 5) et PIVOT_REQUIRE_CONFIRM.

Architecture

discord_osint/
  __main__.py                 CLI entry
  config.py / config_service.py
  core.py                     Intel store
  discord_api.py              Discord profile and message search
  scraping.py                 Platform scrapers
  email_intel.py              Email tools
  extras.py                   WHOIS, Wayback, EXIF, reverse image
  api_extractor.py            Derives JSON endpoints from URLs
  username_search.py          User Scanner, Maigret, Linkook, Blackbird
  wmn_scanner.py              WhatsMyName

  intelligence/               Graph, correlations, narrative, HTML report
  pipeline/                   Stages, context, pivot, events

frontend/                     React, TypeScript, Vite, Tailwind
web_app.py                    Flask backend

Ordre du pipeline :

DiscordModeStage -> Discovery -> Scraping -> Media
  -> Analysis -> Intelligence -> EmailIntel -> [Pivot] -> Reporting

Développement

pytest tests/ -v

WhoCord v1.2.1