Telegram Story Scraper 📱

Ein Python-Skript, mit dem Sie automatisch Stories Ihrer Telegram-Freunde scrapen und herunterladen können, unter Verwendung der Telethon-Bibliothek. Das Skript überwacht kontinuierlich und speichert sowohl Fotos als auch Videos von Stories zusammen mit ihren Metadaten.

TGSS - Hauptoberfläche

Wichtiger Hinweis zum Zugriff auf Stories ⚠️

Aufgrund der Telegram API-Einschränkungen kann dieses Skript nur auf Stories von folgenden Personen zugreifen:

• Benutzer, die Sie zu Ihrer Freundesliste hinzugefügt haben
• Benutzer, deren Datenschutzeinstellungen es Ihnen erlauben, ihre Stories anzusehen

Dies ist eine Einschränkung der Telegram-API und kann nicht umgangen werden.

Funktionen 🚀

• Extrahiert automatisch alle verfügbaren Stories Ihrer Telegram-Freunde
• Lädt sowohl Fotos als auch Videos von Stories herunter
• Speichert Metadaten in einer SQLite-Datenbank
• Exportiert Daten in eine Excel-Tabelle
• Echtzeit-Überwachung mit anpassbaren Intervallen
• Zeitstempel ist auf (UTC+2) eingestellt
• Führt Aufzeichnungen über zuvor heruntergeladene Stories
• Fortsetzungsfähigkeit
• Automatischer Wiederholungsmechanismus

Voraussetzungen 📋

Bevor Sie das Skript ausführen, benötigen Sie:

• Python 3.7 oder höher
• Telegram-Konto
• API-Anmeldedaten von Telegram
• Freunde auf Telegram, deren Stories Sie verfolgen möchten

Erforderliche Python-Pakete

pip install -r requirements.txt

Inhalt von requirements.txt:

telethon
openpyxl
schedule

Abrufen der Telegram API-Anmeldedaten 🔑

1. Besuchen Sie https://my.telegram.org/auth
2. Melden Sie sich mit Ihrer Telefonnummer an
3. Klicken Sie auf "API development tools"
4. Füllen Sie das Formular aus:
   • App-Titel: Ihr App-Name
   • Kurzname: Ihr App-Kurzname
   • Plattform: Kann als "Desktop" belassen werden
   • Beschreibung: Kurze Beschreibung Ihrer App
5. Klicken Sie auf "Create application"
6. Sie erhalten:
   • api_id: Eine Zahl
   • api_hash: Eine Zeichenfolge aus Buchstaben und Zahlen

Bewahren Sie diese Anmeldedaten sicher auf, Sie benötigen sie, um das Skript auszuführen!

Einrichtung und Ausführung 🔧

1. Klonen Sie das Repository:

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

2. Installieren Sie die Abhängigkeiten:

pip install -r requirements.txt

3. Führen Sie das Skript aus:

python TGSS.py

4. Beim ersten Start werden Sie aufgefordert, Folgendes einzugeben:
   • Ihre API-ID
   • Ihren API-Hash
   • Ihre Telefonnummer (mit Ländervorwahl)
   • Bestätigungscode (wird an Ihr Telegram gesendet)
   • Überprüfungsintervall in Sekunden (Standard ist 60)

Funktionsweise 🔄

Das Skript:

1. Verbindet sich mit Ihrem Telegram-Konto
2. Überprüft regelmäßig auf neue Stories Ihrer Freunde
3. Lädt alle neuen Stories (Fotos/Videos) herunter
4. Speichert Metadaten in einer SQLite-Datenbank
5. Exportiert Informationen in eine Excel-Datei
6. Läuft kontinuierlich, bis es unterbrochen wird (Strg+C)

Datenspeicherung 💾

Datenbankstruktur (stories.db)

SQLite-Datenbank enthaltend:

• user_id: Telegram-Benutzer-ID des Story-Erstellers
• story_id: Eindeutige Story-Kennung
• timestamp: Wann die Story gepostet wurde (UTC+2)
• filename: Lokaler Dateiname der heruntergeladenen Medien

CSV- und Excel-Export (stories_export.csv/xlsx)

Exportdatei mit denselben Informationen wie die Datenbank, nützlich für:

• Einfache Ansicht der Story-Metadaten
• Filtern und Sortieren
• Datenanalyse
• Teilen von Daten mit anderen

Medienspeicherung 📁

• Fotos werden gespeichert als: {user_id}_{story_id}.jpg
• Videos werden mit ihrer ursprünglichen Erweiterung gespeichert: {user_id}_{story_id}.{extension}
• Alle Mediendateien werden im Verzeichnis des Skripts gespeichert

Funktionen im Detail 🔍

Kontinuierliche Überwachung

• Anpassbares Überprüfungsintervall (Standard: 60 Sekunden)
• Läuft kontinuierlich bis zum manuellen Stopp
• Behält den Zustand zwischen den Ausführungen bei
• Vermeidet doppelte Downloads

Medienverarbeitung

• Unterstützt sowohl Fotos als auch Videos
• Erkennt automatisch den Medientyp
• Behält die Originalqualität bei
• Erzeugt eindeutige Dateinamen

Fehlerbehandlung 🛠️

Das Skript beinhaltet:

• Automatischen Wiederholungsmechanismus für fehlgeschlagene Downloads
• Fehlerprotokollierung für fehlgeschlagene Vorgänge
• Behandlung von Verbindungsfehlern
• Zustandssicherung im Falle einer Unterbrechung

Einschränkungen ⚠️

• Unterliegt den Ratenbegrenzungen von Telegram
• Stories müssen aktuell aktiv sein (nicht abgelaufen)
• Es gelten die Größenbeschränkungen für Mediendownloads gemäß den Telegram-Beschränkungen

Mitwirken 🤝

Beiträge sind willkommen! Reichen Sie gerne einen Pull Request ein.

Lizenz 📄

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE-Datei für Details.

Haftungsausschluss ⚖️

Dieses Tool dient nur zu Bildungszwecken. Stellen Sie sicher, dass Sie:

• Die Nutzungsbedingungen von Telegram respektieren
• Vor dem Scrapen die erforderlichen Genehmigungen einholen
• Verantwortungsbewusst und ethisch handeln
• Datenschutzbestimmungen einhalten
• Die Privatsphäre der Benutzer respektieren