🕷️ TGSpyder

TGSpyder est un outil CLI OSINT Open Source pour Telegram, développé par Darksight Analytics.

Fonctionnalités

• Extraire la liste des membres de groupes publics et privés vers un fichier CSV
• Extraire les messages de discussion de groupes publics et privés vers un fichier CSV
• Extraire les liens d'invitation t.me de l'historique des discussions (groupes publics et privés)
• Rechercher un utilisateur Telegram par nom d'utilisateur ou par ID numérique (limité)
• Identifier l'ID du créateur de pack de stickers (déduit via l'ID du jeu de stickers) Crédits : https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• Prise en charge des proxys :
  • Enregistrer un proxy (--set-proxy)
  • Supprimer un proxy (--remove-proxy)
  • Proxy ponctuel (--proxy)

Prérequis

• Python 3.10+

Installation

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

🕷️ Introduction

Outil CLI OSINT pour Telegram Conçu pour les enquêteurs, analystes, journalistes et chercheurs.

TGSpyder est un outil OSINT en ligne de commande pour la collecte et l'analyse structurées de données Telegram. Il permet d'extraire les membres, messages, liens d'invitation, utilisateurs et métadonnées de groupes et canaux Telegram publics et privés — en exportant le tout vers des fichiers CSV adaptés aux enquêtes.

Fonctionnalités

• 📋 Extraire les listes de membres (lorsque Telegram le permet)
• 💬 Parcourir les messages de discussion
• 🔗 Extraire et dédupliquer les liens d'invitation Telegram
• 🧍 Rechercher des utilisateurs par ID ou nom d'utilisateur
• 🎭 Identifier les créateurs de packs de stickers
• 🌐 Prise en charge des proxys SOCKS (Tor / VPN)
• 📁 Sortie CSV propre pour les flux de travail OSINT
• 📦 Structure de sortie

Toutes les données collectées sont stockées dans un dossier d'exécution unique :

Sortie TGSpyder/
├── members/
│   └── members_<cible>_<horodatage>.csv
├── chats/
│   └── messages_<cible>_<horodatage>.csv
└── crawled_links/
    └── crawled_links_<cible>_<horodatage>.csv

🚀 Démarrage rapide

1️⃣ Cloner le dépôt

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ Créer et activer un environnement virtuel

python3 -m venv venv
source venv/bin/activate

3️⃣ Installer les dépendances

pip install -r requirements.txt

4️⃣ Installer TGSpyder en tant que CLI

pip install -e .

Vérifier l'installation :

tgspyder --help

🔑 Identifiants API Telegram

• Rendez-vous sur https://my.telegram.org et connectez-vous avec votre compte Telegram.
• Accédez à API development tools pour générer votre API ID et votre API Hash, nécessaires pour authentifier TGSpyder auprès de Telegram.

🧭 Utilisation de base

Extraire les membres et les discussions

tgspyder https://t.me/examplegroup --members --chats

Extraire uniquement les liens d'invitation

tgspyder https://t.me/examplegroup --crawl-invites

Recherche d'utilisateur

tgspyder --user 123456789
tgspyder --user @username

Recherche du créateur d'un pack de stickers

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 Prise en charge des proxys

TGSpyder prend en charge les proxys SOCKS (compatible Tor / VPN).

Proxy ponctuel

tgspyder --proxy socks5://127.0.0.1:9050 <cible> --chats

Enregistrer un proxy pour les exécutions futures

tgspyder --set-proxy socks5://127.0.0.1:9050

Supprimer le proxy enregistré

tgspyder --remove-proxy

🔐 Authentification et configuration

Lors de la première exécution, TGSpyder demandera :

• ID API Telegram
• Hash API Telegram
• Compte utilisateur ou jeton de bot

Les identifiants sont stockés localement dans : ~/.tgspyder.conf

Les fichiers de session sont réutilisés automatiquement.

⚠️ Limitations

• Certains groupes n'exposent pas de listes de membres
• Les groupes privés nécessitent des liens d'invitation valides
• L'attribution du créateur des stickers n'est pas toujours garantie
• Soumis aux limites de l'API Telegram

🧪 Utilisation éthique et avertissement OSINT

TGSpyder est destiné à :

• Enquêtes OSINT
• Recherche académique
• Journalisme
• Analyse des menaces et des réseaux

Les utilisateurs sont responsables du respect :

• Des lois locales
• Des conditions d'utilisation de la plateforme
• Des normes éthiques de recherche

📄 Licence

Licence MIT Voir LICENSE pour plus de détails.

🚀 Démo

👤 Auteur

• Valdemar Balle
• Fondateur de Darksight Analytics

⚖️ Avertissement

TGSpyder est fourni uniquement à des fins de renseignement open source (OSINT), de recherche, d'enquête et d'éducation.

Les utilisateurs sont seuls responsables de veiller à ce que leur utilisation de cet outil soit conforme :

• Aux lois et règlements applicables
• Aux conditions d'utilisation de la plateforme
• Aux normes éthiques de recherche et d'enquête

L'auteur et les contributeurs déclinent toute responsabilité en cas d'utilisation abusive de cet outil ou de toute conséquence découlant de son utilisation.