🕷️ TGSpyder

TGSpyder è uno strumento CLI OSINT open-source per Telegram realizzato da Darksight Analytics.

Caratteristiche

• Estrae l'elenco dei membri da gruppi pubblici e privati in CSV
• Estrae i messaggi della chat da gruppi pubblici e privati in CSV
• Estrae i link di invito t.me dalla cronologia chat (gruppi pubblici e privati)
• Cerca un utente Telegram per nome utente o (limitatamente) ID numerico
• Identifica l'ID del creatore del pacchetto adesivi (dedotto tramite l'ID del set di adesivi) Crediti a: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• Supporto proxy:
  • Salvare il proxy (--set-proxy)
  • Rimuovere il proxy (--remove-proxy)
  • Override proxy singolo (--proxy)

Requisiti

• Python 3.10+

Installazione

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

🕷️ Introduzione

Strumento CLI OSINT per Telegram Progettato per investigatori, analisti, giornalisti e ricercatori.

TGSpyder è uno strumento OSINT a riga di comando per la raccolta strutturata e l'analisi dei dati di Telegram. Consente di estrarre membri, messaggi, link di invito, utenti e metadati da gruppi e canali Telegram pubblici e privati — esportando tutto in file CSV facili da analizzare per gli investigatori.

Caratteristiche

• 📋 Estrae elenchi di membri (dove Telegram lo consente)
• 💬 Analizza i messaggi delle chat
• 🔗 Estrae e deduplica i link di invito Telegram
• 🧍 Cerca utenti per ID o nome utente
• 🎭 Identifica i creatori di pacchetti adesivi
• 🌐 Supporto proxy SOCKS (Tor / VPN)
• 📁 Output CSV pulito per flussi di lavoro OSINT
• 📦 Struttura dell'output

Tutti i dati raccolti sono memorizzati in una singola cartella di esecuzione:

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

🚀 Avvio rapido

1️⃣ Clona il repository

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

2️⃣ Crea e attiva un ambiente virtuale

python3 -m venv venv
source venv/bin/activate

3️⃣ Installa le dipendenze

pip install -r requirements.txt

4️⃣ Installa TGSpyder come CLI

pip install -e .

Verifica l'installazione:

tgspyder --help

🔑 Credenziali API Telegram

• Vai su https://my.telegram.org e accedi con il tuo account Telegram.
• Vai su API development tools per generare il tuo API ID e API Hash, necessari per autenticare TGSpyder con Telegram.

🧭 Utilizzo di base

Estrae membri e chat

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

Estrae solo i link di invito

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

Ricerca utente

tgspyder --user 123456789
tgspyder --user @username

Ricerca creatore pacchetto adesivi

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

🌐 Supporto proxy

TGSpyder supporta proxy SOCKS (compatibile con Tor/VPN).

Proxy singolo

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

Salva proxy per esecuzioni future

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

Rimuovi proxy salvato

tgspyder --remove-proxy

🔐 Autenticazione e configurazione

Al primo avvio, TGSpyder richiederà:

• ID API Telegram
• Hash API Telegram
• Account utente o token bot

Le credenziali sono memorizzate localmente in: ~/.tgspyder.conf

I file di sessione vengono riutilizzati automaticamente.

⚠️ Limitazioni

• Alcuni gruppi non espongono elenchi di membri
• I gruppi privati richiedono link di invito validi
• L'attribuzione del creatore di adesivi non è sempre garantita
• Soggetto ai limiti dell'API Telegram

🧪 Uso etico e disclaimer OSINT

TGSpyder è destinato a:

• Investigazioni OSINT
• Ricerca accademica
• Giornalismo
• Analisi di minacce e reti

Gli utenti sono responsabili del rispetto di:

• Leggi locali
• Termini di servizio della piattaforma
• Standard etici di ricerca

📄 Licenza

Licenza MIT Vedere LICENSE per dettagli.

🚀 Demo

👤 Autore

• Valdemar Balle
• Fondatore di Darksight Analytics

⚖️ Disclaimer

TGSpyder è fornito esclusivamente per scopi di intelligence open-source (OSINT), ricerca, investigativi e didattici.

Gli utenti sono gli unici responsabili di garantire che l'uso di questo strumento sia conforme a:

• Leggi e regolamenti applicabili
• Termini di servizio della piattaforma
• Standard etici di ricerca e investigazione

L'autore e i collaboratori non si assumono alcuna responsabilità per l'uso improprio di questo strumento o per eventuali conseguenze derivanti dal suo utilizzo.