Telegram Story Scraper 📱

Uno script Python che ti permette di raccogliere e scaricare automaticamente le storie dei tuoi amici su Telegram utilizzando la libreria Telethon. Lo script monitora continuamente e salva sia foto che video dalle storie, insieme ai relativi metadati.

TGSS - Interfaccia principale

Nota importante sull'accesso alle storie ⚠️

A causa delle restrizioni dell'API di Telegram, questo script può accedere solo alle storie di:

• Utenti che hai aggiunto alla tua lista amici
• Utenti le cui impostazioni sulla privacy ti consentono di vedere le loro storie

Questa è una limitazione dell'API di Telegram e non può essere aggirata.

Funzionalità 🚀

• Raccoglie automaticamente tutte le storie disponibili dai tuoi amici su Telegram
• Scarica sia foto che video dalle storie
• Memorizza i metadati in un database SQLite
• Esporta i dati in un foglio Excel
• Monitoraggio in tempo reale con intervalli personalizzabili
• Timestamp impostato su (UTC+2)
• Mantiene un registro delle storie già scaricate
• Capacità di ripresa
• Meccanismo di riprova automatico

Prerequisiti 📋

Prima di eseguire lo script, avrai bisogno di:

• Python 3.7 o superiore
• Account Telegram
• Credenziali API da Telegram
• Amici su Telegram di cui vuoi monitorare le storie

Pacchetti Python richiesti

pip install -r requirements.txt

Contenuto di requirements.txt:

telethon
openpyxl
schedule

Ottenere le credenziali API di Telegram 🔑

1. Visita https://my.telegram.org/auth
2. Accedi con il tuo numero di telefono
3. Fai clic su 'API development tools'
4. Compila il modulo:
   • App title: Il nome della tua app
   • Short name: Il nome breve della tua app
   • Platform: Può essere lasciato come 'Desktop'
   • Description: Breve descrizione della tua app
5. Fai clic su 'Create application'
6. Riceverai:
   • api_id: Un numero
   • api_hash: Una stringa di lettere e numeri

Mantieni al sicuro queste credenziali, ti serviranno per eseguire lo script!

Configurazione ed esecuzione 🔧

1. Clona il repository:

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

2. Installa i requisiti:

pip install -r requirements.txt

3. Esegui lo script:

python TGSS.py

4. Al primo avvio, ti verrà chiesto di inserire:
   • Il tuo API ID
   • Il tuo API Hash
   • Il tuo numero di telefono (con prefisso internazionale)
   • Codice di verifica (inviato al tuo Telegram)
   • Intervallo di controllo in secondi (default 60)

Come funziona 🔄

Lo script:

1. Si connette al tuo account Telegram
2. Controlla periodicamente le nuove storie dei tuoi amici
3. Scarica eventuali nuove storie (foto/video)
4. Memorizza i metadati in un database SQLite
5. Esporta le informazioni in un file Excel
6. Funziona continuamente finché non viene interrotto (Ctrl+C)

Archiviazione dei dati 💾

Struttura del database (stories.db)

Database SQLite contenente:

• user_id: ID utente Telegram del creatore della storia
• story_id: Identificatore unico della storia
• timestamp: Quando la storia è stata pubblicata (UTC+2)
• filename: Nome file locale del media scaricato

Esportazione CSV ed Excel (stories_export.csv/xlsx)

File di esportazione contenente le stesse informazioni del database, utile per:

• Visualizzazione semplice dei metadati delle storie
• Filtraggio e ordinamento
• Analisi dei dati
• Condivisione dei dati con altri

Archiviazione dei media 📁

• Le foto vengono salvate come: {user_id}_{story_id}.jpg
• I video vengono salvati con la loro estensione originale: {user_id}_{story_id}.{estensione}
• Tutti i file media vengono salvati nella directory dello script

Funzionalità in dettaglio 🔍

Monitoraggio continuo

• Intervallo di controllo personalizzabile (default: 60 secondi)
• Funziona continuamente fino all'arresto manuale
• Mantiene lo stato tra le esecuzioni
• Evita download duplicati

Gestione dei media

• Supporta sia foto che video
• Rileva automaticamente il tipo di media
• Preserva la qualità originale
• Genera nomi file univoci

Gestione degli errori 🛠️

Lo script include:

• Meccanismo di riprova automatico per download falliti
• Registrazione errori per operazioni fallite
• Gestione errori di connessione
• Conservazione dello stato in caso di interruzione

Limitazioni ⚠️

• Soggetto ai limiti di velocità di Telegram
• Le storie devono essere attive (non scadute)
• Si applicano limiti alla dimensione dei download dei media secondo le restrizioni di Telegram

Contributi 🤝

I contributi sono benvenuti! Sentiti libero di inviare una Pull Request.

Licenza 📄

Questo progetto è concesso in licenza MIT - consulta il file LICENSE per i dettagli.

Dichiarazione di non responsabilità ⚖️

Questo strumento è solo a scopo educativo. Assicurati di:

• Rispettare i Termini di Servizio di Telegram
• Ottenere i permessi necessari prima di raccogliere dati
• Usare in modo responsabile ed etico
• Rispettare le normative sulla protezione dei dati
• Rispettare la privacy degli utenti