Scraper d'Histoires Telegram 📱

Un script Python qui vous permet de scraper et télécharger automatiquement les stories de vos amis Telegram à l'aide de la bibliothèque Telethon. Le script surveille et enregistre en continu les photos et vidéos des stories, ainsi que leurs métadonnées.

TGSS - Interface principale

Note importante concernant l'accès aux stories ⚠️

En raison des restrictions de l'API Telegram, ce script ne peut accéder qu'aux stories de :

• Utilisateurs que vous avez ajoutés à votre liste d'amis
• Utilisateurs dont les paramètres de confidentialité vous autorisent à voir leurs stories

Il s'agit d'une limitation de l'API de Telegram et elle ne peut être contournée.

Fonctionnalités 🚀

• Scrape automatiquement toutes les stories disponibles de vos amis Telegram
• Télécharge les photos et vidéos des stories
• Stocke les métadonnées dans une base de données SQLite
• Exporte les données vers un tableur Excel
• Surveillance en temps réel avec intervalles personnalisables
• Le timestamp est réglé sur (UTC+2)
• Conserve un enregistrement des stories déjà téléchargées
• Capacité de reprise
• Mécanisme de nouvelle tentative automatique

Prérequis 📋

Avant d'exécuter le script, vous aurez besoin de :

• Python 3.7 ou supérieur
• Compte Telegram
• Identifiants API de Telegram
• Amis sur Telegram dont vous souhaitez suivre les stories

Paquets Python requis

pip install -r requirements.txt

Contenu de requirements.txt :

telethon
openpyxl
schedule

Obtention des identifiants API Telegram 🔑

1. Visitez https://my.telegram.org/auth
2. Connectez-vous avec votre numéro de téléphone
3. Cliquez sur 'API development tools'
4. Remplissez le formulaire :
   • Titre de l'application : votre nom d'application
   • Nom court : votre nom court d'application
   • Plateforme : peut être laissé sur 'Desktop'
   • Description : brève description de votre application
5. Cliquez sur 'Create application'
6. Vous recevrez :
   • api_id : un nombre
   • api_hash : une chaîne de lettres et de chiffres

Gardez ces identifiants en sécurité, vous en aurez besoin pour exécuter le script !

Configuration et exécution 🔧

1. Clonez le dépôt :

git clone https://github.com/unnohwn/telegram-story-scraper.git
cd telegram-story-scraper

2. Installez les dépendances :

pip install -r requirements.txt

3. Exécutez le script :

python TGSS.py

4. Lors de la première exécution, il vous sera demandé de saisir :
   • Votre API ID
   • Votre API Hash
   • Votre numéro de téléphone (avec indicatif du pays)
   • Code de vérification (envoyé sur votre Telegram)
   • Intervalle de vérification en secondes (défaut 60)

Comment ça marche 🔄

Le script :

1. Se connecte à votre compte Telegram
2. Vérifie périodiquement les nouvelles stories de vos amis
3. Télécharge toute nouvelle story (photo/vidéo)
4. Stocke les métadonnées dans une base SQLite
5. Exporte les informations vers un fichier Excel
6. S'exécute en continu jusqu'à interruption (Ctrl+C)

Stockage des données 💾

Structure de la base de données (stories.db)

Base de données SQLite contenant :

• user_id : ID utilisateur Telegram du créateur de la story
• story_id : identifiant unique de la story
• timestamp : moment où la story a été publiée (UTC+2)
• filename : nom local du fichier du média téléchargé

Export CSV et Excel (stories_export.csv/xlsx)

Fichier d'export contenant les mêmes informations que la base de données, utile pour :

• Visualisation facile des métadonnées de story
• Filtrage et tri
• Analyse des données
• Partage des données avec d'autres

Stockage des médias 📁

• Les photos sont sauvegardées sous : {user_id}_{story_id}.jpg
• Les vidéos sont sauvegardées avec leur extension d'origine : {user_id}_{story_id}.{extension}
• Tous les fichiers médias sont sauvegardés dans le répertoire du script

Fonctionnalités en détail 🔍

Surveillance continue

• Intervalle de vérification personnalisable (défaut : 60 secondes)
• S'exécute en continu jusqu'à arrêt manuel
• Conserve l'état entre les exécutions
• Évite les téléchargements en double

Gestion des médias

• Prend en charge les photos et les vidéos
• Détecte automatiquement le type de média
• Conserve la qualité d'origine
• Génère des noms de fichiers uniques

Gestion des erreurs 🛠️

Le script inclut :

• Mécanisme de nouvelle tentative automatique pour les téléchargements échoués
• Journalisation des erreurs pour les opérations échouées
• Gestion des erreurs de connexion
• Conservation de l'état en cas d'interruption

Limitations ⚠️

• Soumis aux limites de taux de Telegram
• Les stories doivent être actuellement actives (non expirées)
• Des limites de taille de téléchargement de médias s'appliquent selon les restrictions de Telegram

Contribution 🤝

Les contributions sont les bienvenues ! N'hésitez pas à soumettre une Pull Request.

Licence 📄

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

Avertissement ⚖️

Cet outil est à des fins éducatives uniquement. Assurez-vous de :

• Respecter les conditions d'utilisation de Telegram
• Obtenir les autorisations nécessaires avant de scraper
• Utiliser de manière responsable et éthique
• Se conformer aux réglementations sur la protection des données
• Respecter la vie privée des utilisateurs