tgscope

टेलीग्राम OSINT, स्क्रेपिंग और अभिलेखन।
एक स्थानीय वेब ऐप जो पूरी तरह से आपकी मशीन पर चलता है और केवल टेलीग्राम से संवाद करता है।

npm install
npm start

फिर http://127.0.0.1:5173 खोलें। पहली बार चलाने पर यह API क्रेडेंशियल, QR साइन-इन और आपके डायलॉग लोड करने की प्रक्रिया में मार्गदर्शन करता है। टेलीग्राम ही एकमात्र सर्वर है जिससे यह संवाद करता है। बनाने के लिए कोई खाता नहीं है, कोई टेलीमेट्री नहीं है और बीच में कोई सेवा नहीं है: आप जो कुछ भी एकत्र करते हैं वह आपकी अपनी SQLite फ़ाइल में रहता है।

telegram-scraper, telescope और Harrier का उत्तराधिकारी, जो Telethon 1.44 पर निर्मित है।

यह क्या करता है

संग्रह

• हर साइन-इन किए गए खाते में हर चैनल, समूह, फ़ोरम विषय और चैट, एक चुनने योग्य ट्री में, नाम के साथ पूरा -100 id और उसे देखने वाले खाते के लिए बैज सहित
• प्रत्येक डायलॉग उस खाते के अंतर्गत एकत्र किया जाता है जो वास्तव में उसे पढ़ सकता है, इसलिए दो खातों में फैला चयन प्रति खाता एक रन शुरू करता है
• पूर्ण मेटाडेटा वाले संदेश: व्यूज़, फ़ॉरवर्ड, रिएक्शन, संपादन तिथियाँ, एल्बम, पोल, जियो, लिंक, रिप्लाई चेन, पोस्ट लेखक और हर संदेश का फ़ॉरवर्ड स्रोत
• विषय के अनुसार विभाजित फ़ोरम समूह — पूरे समूहों के बजाय अलग-अलग विषय एकत्र करें
• मीडिया समानांतर रूप से डाउनलोड होता है और SHA-256 तथा टेलीग्राम फ़ाइल id द्वारा डिडुप्लीकेट होता है, इसलिए पाँच चैनलों पर फ़ॉरवर्ड की गई फ़ाइल एक बार संग्रहीत होती है
• प्रति-डायलॉग वॉटरमार्क से रिज़्यूम; निरंतर मोड एक अंतराल पर पुनः जाँच करता है
• सहेजे गए संग्रह एक क्लिक से चयन को फिर से चलाते हैं

जाँच

• फ़ोन नंबर, @username, उपयोगकर्ता id या t.me लिंक देखें
• बायो, फ़्लैग, गोपनीयता संकेतक के रूप में अंतिम-बार-देखे जाने की परिशुद्धता, साझा चैट, व्यक्तिगत चैनल
• टेलीग्राम खाते के बारे में जो कुछ भी स्वेच्छा से बताता है: पंजीकरण का महीना, फ़ोन नंबर जिस देश का है, व्यक्ति ने आखिरी बार कब अपना नाम बदला या फ़ोटो बदली, उनका ऑटो-डिलीट टाइमर, प्रतिबंधित फ़ॉरवर्ड पर दिखाया गया नाम। सावधान रहें कि यह आमतौर पर इनमें से कुछ भी नहीं बताता। ये फ़ील्ड उस एंटी-स्कैम पैनल के साथ आते हैं जो टेलीग्राम तब दिखाता है जब कोई अजनबी आपको लिखता है, और सीधे देखी गई प्रोफ़ाइल के लिए खाली लौटते हैं, इसलिए उन्हें योजना बनाने की चीज़ के बजाय बोनस मानें
• बिज़नेस खाते विश्वसनीय रूप से सड़क का पता, निर्देशांक और एक समय क्षेत्र देते हैं
• हर दृश्यमान प्रोफ़ाइल फ़ोटो, SHA-256 और एक अवधारणात्मक हैश (perceptual hash) से हैश किया हुआ, गैलरी के रूप में दिखाया गया
• अवधारणात्मक हैश का मिलान खातों के बीच किया जाता है, इसलिए दूसरी प्रोफ़ाइल पर वही तस्वीर सामने आ जाती है
• संदेश भेजने वालों को स्क्रेपिंग के समय दर्ज किया जाता है, इसलिए ब्राउज़र में एक नाम लुकअप के लिए काम करने वाला लिंक होता है, तब भी जब व्यक्ति के पास कोई उपयोगकर्ता नाम न हो; "Sync members" पहले एकत्र की गई किसी भी चीज़ के लिए इसे भर देता है
• हर लुकअप का स्नैपशॉट लिया जाता है और उसका अंतर (diff) निकाला जाता है: उपयोगकर्ता नाम परिवर्तन, प्रदर्शित नाम परिवर्तन, बायो संपादन, जोड़ी या हटाई गई फ़ोटो, बदली गई गोपनीयता

निर्यात

आवश्यकताएँ

• Node.js 18+
• Python 3.12+
• my.telegram.org/apps से API क्रेडेंशियल

npm install server/.venv के अंतर्गत Python वातावरण बनाता है और दोनों पक्षों को स्थापित करता है।

चीज़ें कहाँ रहती हैं

एक ही डेटाबेस में सब कुछ रहता है, जो क्रॉस-डायलॉग खोज, साझा उपयोगकर्ता तालिका, मीडिया डिडुप और फ़ॉरवर्ड ग्राफ़ को संभव बनाता है।

मीडिया लेआउट

फ़ाइलों को डायलॉग प्रकार, फिर डायलॉग, फिर फ़ोरम विषय, फिर मीडिया प्रकार के अनुसार व्यवस्थित किया जाता है:

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

निर्देशिका नाम हैंडल को पूर्ण id के साथ जोड़ते हैं, गैर-ASCII शीर्षकों का लिप्यंतरण किया जाता है, और फ़ाइल नाम शून्य-पैडेड होते हैं ताकि वे कालानुक्रमिक रूप से क्रमबद्ध हों।

दर सीमाएँ और खाता सुरक्षा

हर टेलीग्राम कॉल टोकन बकेट और FloodWait बैकऑफ़ के साथ प्रति-खाता गवर्नर से गुजरती है, और हर पेज्ड रीड — संदेश, डायलॉग, सदस्य, प्रोफ़ाइल फ़ोटो — फ्लड खत्म होने का इंतज़ार करती है और रन को विफल किए बिना फिर से शुरू होती है। तीन प्रोफ़ाइल:

लंबी प्रतीक्षाओं की घोषणा गतिविधि लॉग में की जाती है और उन्हें सहन किया जाता है; एक रीड पर लगातार बारह प्रतीक्षाएँ होने पर यह हार मान लेता है और इसकी रिपोर्ट करता है।

कई खातों का समर्थन किया जाता है। Settings में किसी एक को burner के रूप में चिह्नित करें और फ़ोन लुकअप स्वचालित रूप से उस पर चलेंगे, क्योंकि यही एक जोखिम भरा ऑपरेशन है:

एक फ़ोन लुकअप नंबर को एक पल के लिए संपर्क के रूप में आयात करता है और फिर हटा देता है। यदि मालिक के पास आपका नंबर पहले से सहेजा है, तो उन्हें "joined Telegram" सूचना दिख सकती है। tgscope हर बार पहले पूछता है, और प्रोफ़ाइल कार्ड रिकॉर्ड करता है कि उसने किस खाते का उपयोग किया।

विकास

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

बैकएंड Telethon कोर पर FastAPI है, जिसे फर्जी Telethon क्लाइंट के विरुद्ध परीक्षण किया गया है: स्क्रेपर, एक्सपोर्टर, मीडिया लेआउट और हर स्कीमा माइग्रेशन। फ्रंटएंड परीक्षण ब्राउज़र के पीछे की शुद्ध लॉजिक, अवधि अंकगणित, हिस्टोग्राम बकेटिंग और संख्या तथा टाइमस्टैम्प फ़ॉर्मेटिंग को कवर करते हैं, और हर स्क्रीन को दो बार रेंडर करते हैं, एक बार खाली और एक बार भरा हुआ।

scripts/demo/ सीडेड फर्जी डेटा से docs/preview.gif को पुनः उत्पन्न करता है। इसे chromium और ffmpeg की आवश्यकता होती है, यह आपके वास्तविक वर्कस्पेस को कुछ भी नहीं छूता, और ऐप का हिस्सा नहीं है।

स्रोत में कोई टिप्पणी नहीं होती — अर्थ नामकरण और संरचना से मिलता है, और एक परीक्षण इसे लागू करता है।

कानूनी

शोध, पत्रकारिता और अधिकृत जाँच के लिए। यह Telethon के माध्यम से आधिकारिक Telegram API का उपयोग करता है और केवल वही पढ़ता है जो आपका खाता पहले से देख सकता है — यह किसी की गोपनीयता सेटिंग्स को बायपास नहीं करता। इसे उत्पीड़न या स्टॉकिंग के लिए उपयोग न करें, Telegram की सेवा शर्तों का सम्मान करें, और अपने पर लागू डेटा-सुरक्षा कानून का ध्यान रखें।

MIT लाइसेंस।