TGSherlock

OSINT Telegram dans un panneau web local : surveillance en direct, alertes, suivi d'utilisateurs et balayages par mots-clés.

Installation

pipx install tgsherlock

Dernière version depuis GitHub : pipx install git+https://github.com/emrekybs/tgsherlock.git (si tgsherlock est introuvable ensuite, exécutez pipx ensurepath et ouvrez un nouveau terminal).

Lancement

tgsherlock

Le panneau s'ouvre dans votre navigateur à l'adresse http://127.0.0.1:8765. Sous Linux, le premier lancement ajoute également TGSherlock à votre menu d'applications, ce qui vous permet de le démarrer d'un clic.

Premier lancement : créez une application sur my.telegram.org → API development tools, saisissez votre API ID et votre API Hash, puis scannez le QR code avec Telegram (Paramètres → Appareils → Lier un appareil de bureau). La connexion par numéro de téléphone est également disponible.

Fonctionnalités

• Surveillance en direct : messages en temps réel provenant d'utilisateurs, de groupes et de canaux choisis, avec téléchargement optionnel des médias.
• Alertes : surveillez un utilisateur, un groupe ou toutes les discussions pour tout message, mots-clés, regex, médias ou indicateurs. Recevez des notifications dans l'application, sur le bureau, par e-mail (SMTP) ou par webhook, avec limitation des résumés.
• Profil utilisateur : bio, noms d'utilisateur, indicateurs, groupes partagés, première et dernière apparition par groupe, activité horaire et chronologie datée des messages.
• Recherche : utilisateurs, groupes et canaux, affichés avec leurs photos de profil.
• Historique de groupe · Balayage par mots-clés · Suivi d'utilisateur : tâches en arrière-plan avec progression et gestion automatique des FloodWait.
• Entités : e-mails, téléphones, URL, IP, portefeuilles crypto, liens d'invitation et hashtags, extraits automatiquement.
• Archivage et export : filtrez tout ce que vous avez collecté et exportez-le au format CSV, JSON ou rapport HTML.
• Comptes multiples : ajoutez, changez et déconnectez-vous depuis la barre latérale.

Mise à jour : pipx upgrade tgsherlock

Options : --port 8790, --no-browser, --install-desktop, --uninstall-desktop. Les données restent locales : ~/.config/tgsherlock (paramètres, sessions) et ~/.local/share/tgsherlock (bases de données, médias).

Utilisation responsable

Conçu pour l'OSINT défensif et le renseignement sur les menaces. TGSherlock ne voit que ce que votre propre compte Telegram peut voir. Respectez la législation locale et les Conditions d'utilisation de Telegram.

Licence

MIT