tgscope

OSINT, scraping et archivage pour Telegram.
Une application web locale qui s'exécute entièrement sur votre machine et ne communique qu'avec Telegram.

npm install
npm start

Ouvrez ensuite http://127.0.0.1:5173. Le premier lancement vous guide à travers la saisie des identifiants API, une connexion par QR code et le chargement de vos dialogues. Telegram est le seul serveur avec lequel il communique. Il n'y a pas de compte à créer, pas de télémétrie et aucun service intermédiaire : ce que vous collectez reste dans un fichier SQLite qui vous appartient.

Successeur de telegram-scraper, telescope et Harrier, construit sur Telethon 1.44.

Collecter	Canaux, groupes et sujets de forum sur plusieurs comptes, avec médias, déduplication et reprise
Enquêter	Numéro de téléphone, @username, id ou lien t.me vers un profil, toutes les photos historiques, et un diff depuis la dernière fois
Exporter	Dix formats, d'un simple CSV à un bundle de preuves haché
Fonctionne sur	Node 18+, Python 3.12+, SQLite. Une base de données, un dossier, aucun service

Ce qu'il fait

Collecter

• Chaque canal, groupe, sujet de forum et discussion, sur tous les comptes connectés, dans une arborescence sélectionnable unique avec l'id complet -100 à côté du nom et un badge pour le compte qui le voit
• Chaque dialogue est collecté sous le compte qui peut réellement le lire, donc une sélection couvrant deux comptes lance une exécution par compte
• Messages avec métadonnées complètes : vues, transferts, réactions, dates d'édition, albums, sondages, géolocalisation, liens, chaînes de réponses, auteurs de publications et la source de transfert de chaque message
• Groupes de forum séparés par sujet — collectez des sujets individuels plutôt que des groupes entiers
• Médias téléchargés en parallèle et dédupliqués par SHA-256 et par identifiant de fichier Telegram, ainsi un fichier transféré vers cinq canaux n'est stocké qu'une fois
• Reprise à partir d'un filigrane par dialogue ; le mode continu revérifie à intervalle régulier
• Les collections enregistrées relancent une sélection en un clic

Enquêter

• Recherchez un numéro de téléphone, un @username, un id utilisateur ou un lien t.me
• Bio, indicateurs, précision de la dernière connexion comme indicateur de confidentialité, discussions en commun, canal personnel
• Tout ce que Telegram choisit de divulguer sur le compte : le mois d'inscription, le pays auquel appartient son numéro de téléphone, la dernière fois que la personne s'est renommée ou a changé sa photo, son minuteur de suppression automatique, le nom affiché sur les transferts restreints. Sachez qu'il n'en divulgue généralement rien. Ces champs accompagnent le panneau anti-arnaque que Telegram affiche lorsqu'un inconnu vous écrit, et reviennent vides pour un profil que vous consultez directement, alors considérez-les comme un bonus plutôt que comme quelque chose sur lequel compter
• Les comptes professionnels fournissent de manière fiable une adresse postale, des coordonnées et un fuseau horaire
• Chaque photo de profil visible, hachée avec SHA-256 et un hash perceptuel, affichée sous forme de galerie
• Les hashes perceptuels sont mis en correspondance entre les comptes, ainsi la même image sur un second profil ressort
• Les expéditeurs de messages sont enregistrés au fur et à mesure de la collecte, ainsi un nom dans le navigateur est un lien fonctionnel vers une recherche même lorsque la personne n'a pas de nom d'utilisateur ; « Sync members » complète cela pour tout ce qui a été collecté auparavant
• Chaque recherche est enregistrée sous forme d'instantané et comparée : changements de nom d'utilisateur, changements de nom d'affichage, modifications de bio, photos ajoutées ou supprimées, confidentialité modifiée

Exporter

Format	Ce que vous obtenez
csv	Un fichier par dialogue
json / jsonl	Métadonnées complètes ; JSONL diffuse ligne par ligne
xlsx	Feuilles pour les messages, médias, participants et réactions
html	Rapport autonome : statistiques, activité, principaux expéditeurs, sources de transfert, table consultable
markdown	Le même rapport en texte
gexf / edges	Graphe de transferts pour Gephi et Maltego
sqlite	Une base de données autonome contenant uniquement les dialogues sélectionnés
bundle	ZIP avec les données, les médias, un manifeste des hashes SHA-256 et le journal de collecte

Prérequis

• Node.js 18+
• Python 3.12+
• Identifiants API depuis my.telegram.org/apps

npm install crée l'environnement Python sous server/.venv et installe les deux côtés.

Où se trouvent les choses

Quoi	Où
Configuration	~/.config/tgscope/config.json (mode 600)
Base de données	~/.local/share/tgscope/tgscope.db (WAL, FTS5)
Médias	~/.local/share/tgscope/media/
Exports	~/.local/share/tgscope/exports/<timestamp>-<label>/

Une seule base de données contient tout, ce qui rend possibles la recherche inter-dialogues, la table utilisateur partagée, la déduplication des médias et le graphe de transferts.

Organisation des médias

Les fichiers sont classés par type de dialogue, puis par dialogue, puis par sujet de forum, puis par type de média :

media/
├── channels/technews_-1001234567890/
│   ├── photos/00004711-8001-conference-slides.jpg
│   └── documents/00004802-8210-quarterly-report.pdf
├── groups/pythondev_-1009876543210/
│   ├── general/photos/…
│   └── help/voice/00000004-9004-voice.ogg
└── profiles/123456789/000-5544332211.jpg

Les noms de répertoires combinent le handle avec l'id complet, les titres non-ASCII sont translittérés, et les noms de fichiers sont complétés par des zéros afin qu'ils se trient chronologiquement.

Limites de débit et sécurité du compte

Chaque appel Telegram passe par un régulateur par compte doté d'un token bucket et d'un backoff FloodWait, et chaque lecture paginée - messages, dialogues, membres, photos de profil - attend la fin d'un flood et reprend plutôt que d'échouer. Trois profils :

Profil	Workers média	Espacement des requêtes	Attentes absorbées silencieusement
stealth	1	1,6 s	jusqu'à 180 s
balanced	4	0,35 s	jusqu'à 90 s
fast	8	aucun	jusqu'à 45 s

Les attentes plus longues sont annoncées dans le journal d'activité et attendues jusqu'au bout ; douze d'affilée sur une même lecture entraînent l'abandon et un rapport.

Plusieurs comptes sont pris en charge. Marquez-en un comme burner dans les paramètres et les recherches de numéro s'y exécutent automatiquement, car c'est la seule opération risquée :

Une recherche de numéro importe le numéro comme contact pendant un instant puis le supprime à nouveau. Si le propriétaire a déjà votre numéro enregistré, il peut voir une notification « a rejoint Telegram ». tgscope demande d'abord, à chaque fois, et la fiche de profil enregistre le compte utilisé.

Développement

npm test                    # 92 backend and 42 frontend tests, no network needed
npm run build               # production bundle of the client