SOCMIntelligence

Outil web SOCMINT / OSINT multiplateforme.

---

Présentation

SOCMIntelligence collecte des données publiques sur de nombreuses plateformes, transforme chaque résultat en graphiques, tableaux de constats et graphe de relations, et fusionne le tout dans un graphe d'identité inter-plateformes unique. Comme un même compte reçoit le même ID de nœud partout, un email, un domaine ou un nom d'utilisateur qui apparaît dans deux scans différents est automatiquement relié — vous pouvez ainsi voir qui est qui à travers les services.

Modules

Groupe	Modules
Réseaux sociaux	X (Twitter) · Instagram · Bluesky · LinkedIn · YouTube · TikTok · Twitch · Kick · Snapchat · Reddit · Mastodon · Telegram · Discord · Steam
Développeur	GitHub · GitLab · Stack Exchange · Hacker News
Identité et archives	Keybase · Gravatar · Wayback Machine
Recherche et cartographie	Recherche par mot-clé (Bluesky · Reddit · Mastodon) · Carte de hashtags

Chaque module lit uniquement des données publiques (ou une API officielle lorsqu'une clé est fournie). Aucun scraping d'identifiants/sessions de comptes privés n'est effectué.

Fonctionnalités

• Graphe de relations — un graphe de forces D3 qui fusionne chaque scan réussi. Correspondances inter-plateformes (email, domaine, nom d'utilisateur partagés), pivotement (double-cliquez sur un nœud pour le scanner dans le module approprié), recherche, filtres par type, export PNG/JSON.
• Chronologie — les publications, commentaires, uploads et événements de création de compte de chaque compte sur un même axe, plus une carte thermique de chevauchement horaire et un tableau de similarité horaire.
• Correspondance d'identité — un score « même personne ? » de 0 à 100 par paire de comptes avec les raisons (lien vérifié/cryptographique, email partagé, similarité de nom d'utilisateur et de nom d'affichage, domaine personnel partagé, pHash d'avatar, heures d'activité). Les paires ≥ 40 sont dessinées sur le graphe.
• Comparaison — placez côte à côte 2 comptes scannés ou plus d'un même module (tableau de KPI + graphique en barres, valeur la plus élevée mise en évidence).
• Marques d'analyste — marquez les nœuds du graphe comme Vérifié / Suspect / Écarté, ajoutez des notes, ajoutez des nœuds et des liens manuels. Tout est enregistré dans le dossier.
• Gestion de dossier — créez un dossier, activez-le, et les scans/marques/notes sont enregistrés automatiquement. Importez/exportez un paquet .socmint.
• Suivi des changements (Monitoring) — rescannez les cibles selon un calendrier et enregistrez ce qui a changé (champs, liens ajoutés/supprimés).
• Intégrité des preuves — les données brutes de chaque scan sont hachées (SHA-256 sur JSON canonique) au moment de la collecte ; un bouton de vérification prouve si elles ont été altérées.
• Exports — rapport HTML / PDF, Excel (.xlsx), GraphML (Gephi/yEd), GEXF (Gephi), CSV Maltego, JSON.
• Interface en anglais — toute l'interface, les rapports, les tableurs et les libellés des graphiques sont en anglais.
• Page de paramètres — clés API, rotation proxy / Tor / liste de proxys et limites de débit, tout géré depuis l'interface au lieu du .env.

Installation

pipx (recommandé sous Linux)

pipx install socmintelligence
socmintelligence

ou avec pip dans un virtualenv :

pip install socmintelligence
socmintelligence

Ouvrez ensuite http://localhost:8000. Options : socmintelligence --host 0.0.0.0 --port 8000 --data-dir ~/socmint-data --no-browser. Les données (dossiers, paramètres) sont stockées dans ~/.local/share/socmintelligence, sauf si --data-dir ou SOCMINT_DATA_DIR est défini.

Directement depuis GitHub : pipx install git+https://github.com/emrekybs/SOCMIntelligence

Démarrage rapide (depuis les sources)

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000

Ensuite, ouvrez http://localhost:8000 — documentation de l'API à l'adresse http://localhost:8000/docs.

Les exécutions suivantes nécessitent uniquement :

source .venv/bin/activate && uvicorn server:app --port 8000

Docker : docker compose up --build (service unique).

Configuration

Toute la configuration se trouve sur la page Settings (enregistrée dans data/settings.json ; .env est toujours lu, mais Settings a la priorité) :

• Clés API — stockées côté serveur, jamais renvoyées au navigateur (seuls « set » + les 4 derniers caractères sont affichés).
  • YOUTUBE_API_KEY — requise pour le module YouTube.
  • HIKERAPI_TOKEN — Instagram (HikerAPI). Sans elle, le module Instagram affiche des données d'exemple clairement identifiées.
  • X_BEARER_TOKEN — API X (Twitter) v2. Sans elle, le module X affiche des données d'exemple clairement identifiées afin de prévisualiser la sortie avant d'ajouter un token.
  • STEAM_API_KEY, STACKEXCHANGE_KEY, GRAVATAR_API_KEY, GITLAB_TOKEN — optionnelles, débloquent des données supplémentaires.
• Proxy / Tor — désactivé, Tor, un proxy personnalisé unique, ou une liste de proxies qui tourne en round-robin à chaque scan (répartit les limites de débit).
• Rate — nombre de scans parallèles et délai entre les requêtes.

Notes

• X (Twitter) : l'offre gratuite de X est très limitée — même avec un token, l'historique des posts peut revenir vide selon l'offre ; le module signale ce cas.
• Telegram lit uniquement l'aperçu public t.me/s/ (sans connexion).
• Gravatar ne reçoit que le hash MD5/SHA-256 d'un email, jamais l'email lui-même.
• TikTok applique fréquemment des limites de débit et bloque les bots ; le module réessaie et distingue un véritable « not found » d'un blocage temporaire.
• Les distributions temporelles sont en UTC. La « croissance » des abonnés TikTok est une estimation (signalée comme telle), pas un historique réel.

Licence

Apache License 2.0 — voir LICENSE.