🕷️ TGSpyder

TGSpyder ist ein Open-Source Telegram OSINT CLI Tool von Darksight Analytics.

Funktionen

• Mitgliederliste sowohl aus öffentlichen als auch privaten Gruppen nach CSV exportieren
• Chat-Nachrichten sowohl aus öffentlichen als auch privaten Gruppen nach CSV exportieren
• t.me-Einladungslinks aus dem Chatverlauf extrahieren (öffentliche und private Gruppen)
• Einen Telegram-Benutzer nach Benutzername oder (begrenzter) numerischer ID suchen
• Ersteller-ID von Sticker-Paketen identifizieren (abgeleitet über Sticker-Set-ID) Credits an: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• Proxy-Unterstützung:
  • Proxy speichern (--set-proxy)
  • Proxy entfernen (--remove-proxy)
  • Einmalige Proxy-Überschreibung (--proxy)

Voraussetzungen

• Python 3.10+

Installation

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

🕷️ Einführung

Telegram OSINT CLI Tool Entwickelt für Ermittler, Analysten, Journalisten und Forscher.

TGSpyder ist ein Kommandozeilen-OSINT-Tool für die strukturierte Sammlung und Analyse von Telegram-Daten. Es ermöglicht das Auslesen von Mitgliedern, Nachrichten, Einladungslinks, Benutzern und Metadaten aus öffentlichen und privaten Telegram-Gruppen und -Kanälen — und exportiert alles in untersuchungsfreundliche CSV-Dateien.

Funktionen

• 📋 Mitgliederlisten auslesen (wo Telegram dies erlaubt)
• 💬 Chat-Nachrichten durchsuchen
• 🔗 Telegram-Einladungslinks extrahieren und deduplizieren
• 🧍 Benutzer anhand von ID oder Benutzername suchen
• 🎭 Ersteller von Sticker-Paketen identifizieren
• 🌐 SOCKS-Proxy-Unterstützung (Tor / VPN)
• 📁 Saubere CSV-Ausgabe für OSINT-Workflows
• 📦 Ausgabestruktur

Alle gesammelten Daten werden in einem einzigen Laufzeitordner gespeichert:

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 Schnellstart

1️⃣ Repository klonen

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

2️⃣ Virtuelle Umgebung erstellen & aktivieren

python3 -m venv venv
source venv/bin/activate

3️⃣ Abhängigkeiten installieren

pip install -r requirements.txt

4️⃣ TGSpyder als CLI installieren

pip install -e .

Installation überprüfen:

tgspyder --help

🔑 Telegram API-Anmeldedaten

• Gehen Sie zu https://my.telegram.org und melden Sie sich mit Ihrem Telegram-Konto an.
• Navigieren Sie zu API development tools, um Ihre API-ID und Ihren API-Hash zu generieren, die zur Authentifizierung von TGSpyder bei Telegram erforderlich sind.

🧭 Grundlegende Verwendung

Mitglieder und Chats auslesen

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

Nur Einladungslinks extrahieren

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

Benutzersuche

tgspyder --user 123456789
tgspyder --user @username

Suche nach Sticker-Paket-Ersteller

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

🌐 Proxy-Unterstützung

TGSpyder unterstützt SOCKS-Proxys (Tor/VPN-freundlich).

Einmaliger Proxy

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

Proxy für zukünftige Läufe speichern

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

Gespeicherten Proxy entfernen

tgspyder --remove-proxy

🔐 Authentifizierung und Konfiguration

Beim ersten Start fragt TGSpyder nach:

• Telegram API ID
• Telegram API Hash
• Benutzerkonto oder Bot-Token

Anmeldedaten werden lokal gespeichert in: ~/.tgspyder.conf

Sitzungsdateien werden automatisch wiederverwendet.

⚠️ Einschränkungen

• Einige Gruppen legen keine Mitgliederlisten offen
• Private Gruppen erfordern gültige Einladungslinks
• Die Zuordnung von Stickern zu Erstellern ist nicht immer garantiert
• Unterliegt den Telegram-API-Beschränkungen

🧪 Ethische Nutzung & OSINT-Haftungsausschluss

TGSpyder ist vorgesehen für:

• OSINT-Ermittlungen
• Akademische Forschung
• Journalismus
• Bedrohungs- & Netzwerkanalyse

Benutzer sind verantwortlich für die Einhaltung von:

• Lokalen Gesetzen
• Plattformnutzungsbedingungen
• Ethischen Forschungsstandards

📄 Lizenz

MIT-Lizenz Siehe LICENSE für Details.

🚀 Demo

👤 Autor

• Valdemar Balle
• Gründer von Darksight Analytics

⚖️ Haftungsausschluss

TGSpyder wird ausschließlich für Open-Source-Intelligence (OSINT), Forschung, Ermittlungs- und Bildungszwecke bereitgestellt.

Benutzer sind allein dafür verantwortlich, dass ihre Nutzung dieses Tools mit folgenden Vorgaben übereinstimmt:

• Anwendbaren Gesetzen und Vorschriften
• Plattformnutzungsbedingungen
• Ethischen Forschungs- und Ermittlungsstandards

Der Autor und die Mitwirkenden übernehmen keine Haftung für Missbrauch dieses Tools oder für daraus resultierende Folgen.