टेलीग्राम स्टोरी स्क्रैपर 📱

एक Python स्क्रिप्ट जो आपको Telethon लाइब्रेरी का उपयोग करके अपने टेलीग्राम मित्रों से स्वचालित रूप से स्टोरीज़ को स्क्रैप और डाउनलोड करने की अनुमति देती है। स्क्रिप्ट लगातार निगरानी करती है और स्टोरीज़ से फ़ोटो और वीडियो दोनों को उनके मेटाडेटा के साथ सहेजती है।

TGSS - मुख्य इंटरफ़ेस

स्टोरी एक्सेस के बारे में महत्वपूर्ण नोट ⚠️

Telegram API की सीमाओं के कारण, यह स्क्रिप्ट केवल निम्नलिखित से स्टोरीज़ तक पहुँच सकती है:

• जिन उपयोगकर्ताओं को आपने अपनी मित्र सूची में जोड़ा है
• जिन उपयोगकर्ताओं की गोपनीयता सेटिंग्स आपको उनकी स्टोरीज़ देखने की अनुमति देती हैं

यह Telegram API की एक सीमा है और इसे टाला नहीं जा सकता।

विशेषताएँ 🚀

• आपके टेलीग्राम मित्रों से सभी उपलब्ध स्टोरीज़ को स्वचालित रूप से स्क्रैप करता है
• स्टोरीज़ से फ़ोटो और वीडियो दोनों डाउनलोड करता है
• मेटाडेटा को SQLite डेटाबेस में संग्रहीत करता है
• डेटा को Excel स्प्रेडशीट में निर्यात करता है
• अनुकूलन योग्य अंतराल के साथ रीयल-टाइम निगरानी
• टाइमस्टैम्प (UTC+2) पर सेट है
• पहले से डाउनलोड की गई स्टोरीज़ का रिकॉर्ड रखता है
• पुनः शुरू करने की क्षमता
• स्वचालित पुनर्प्रयास तंत्र

आवश्यक शर्तें 📋

स्क्रिप्ट चलाने से पहले, आपको चाहिए:

• Python 3.7 या उच्चतर
• Telegram खाता
• Telegram से API क्रेडेंशियल्स
• Telegram पर मित्र जिनकी स्टोरीज़ आप ट्रैक करना चाहते हैं

आवश्यक Python पैकेज

pip install -r requirements.txt

requirements.txt की सामग्री:

telethon
openpyxl
schedule

Telegram API क्रेडेंशियल्स प्राप्त करना 🔑

1. https://my.telegram.org/auth पर जाएँ
2. अपने फ़ोन नंबर से लॉग इन करें
3. "API development tools" पर क्लिक करें
4. फ़ॉर्म भरें:
   • App title: आपका ऐप नाम
   • Short name: आपका ऐप का संक्षिप्त नाम
   • Platform: "Desktop" के रूप में छोड़ा जा सकता है
   • Description: आपके ऐप का संक्षिप्त विवरण
5. "Create application" पर क्लिक करें
6. आपको प्राप्त होगा:
   • api_id: एक संख्या
   • api_hash: अक्षरों और संख्याओं की एक स्ट्रिंग

इन क्रेडेंशियल्स को सुरक्षित रखें, स्क्रिप्ट चलाने के लिए आपको इनकी आवश्यकता होगी!

सेटअप और चलाना 🔧

1. रिपॉजिटरी क्लोन करें:

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

2. आवश्यकताएँ स्थापित करें:

pip install -r requirements.txt

3. स्क्रिप्ट चलाएँ:

python TGSS.py

4. पहली बार चलाने पर, आपको निम्नलिखित दर्ज करने के लिए कहा जाएगा:
   • आपका API ID
   • आपका API Hash
   • आपका फ़ोन नंबर (देश कोड के साथ)
   • सत्यापन कोड (आपके Telegram पर भेजा गया)
   • सेकंड में जाँच अंतराल (डिफ़ॉल्ट 60 है)

यह कैसे काम करता है 🔄

स्क्रिप्ट:

1. आपके Telegram खाते से जुड़ती है
2. समय-समय पर आपके मित्रों से नई स्टोरीज़ की जाँच करती है
3. किसी भी नई स्टोरी (फ़ोटो/वीडियो) को डाउनलोड करती है
4. मेटाडेटा को SQLite डेटाबेस में संग्रहीत करती है
5. जानकारी को Excel फ़ाइल में निर्यात करती है
6. बाधित होने तक (Ctrl+C) लगातार चलती रहती है

डेटा भंडारण 💾

डेटाबेस संरचना (stories.db)

SQLite डेटाबेस जिसमें शामिल है:

• user_id: स्टोरी बनाने वाले का Telegram उपयोगकर्ता आईडी
• story_id: अद्वितीय स्टोरी पहचानकर्ता
• timestamp: स्टोरी पोस्ट होने का समय (UTC+2)
• filename: डाउनलोड किए गए मीडिया का स्थानीय फ़ाइल नाम

CSV और Excel निर्यात (stories_export.csv/xlsx)

डेटाबेस के समान जानकारी वाली निर्यात फ़ाइल, जो इसके लिए उपयोगी है:

• स्टोरी मेटाडेटा को आसानी से देखना
• फ़िल्टर करना और सॉर्ट करना
• डेटा विश्लेषण
• दूसरों के साथ डेटा साझा करना

मीडिया भंडारण 📁

• फ़ोटो इस रूप में सहेजी जाती हैं: {user_id}_{story_id}.jpg
• वीडियो उनके मूल एक्सटेंशन के साथ सहेजे जाते हैं: {user_id}_{story_id}.{extension}
• सभी मीडिया फ़ाइलें स्क्रिप्ट की निर्देशिका में सहेजी जाती हैं

विशेषताएँ विस्तार से 🔍

लगातार निगरानी

• अनुकूलन योग्य जाँच अंतराल (डिफ़ॉल्ट: 60 सेकंड)
• मैन्युअल रूप से रोके जाने तक लगातार चलती है
• रनों के बीच स्थिति बनाए रखती है
• डुप्लिकेट डाउनलोड से बचती है

मीडिया प्रबंधन

• फ़ोटो और वीडियो दोनों का समर्थन करता है
• स्वचालित रूप से मीडिया प्रकार का पता लगाता है
• मूल गुणवत्ता को संरक्षित करता है
• अद्वितीय फ़ाइल नाम उत्पन्न करता है

त्रुटि प्रबंधन 🛠️

स्क्रिप्ट में शामिल है:

• असफल डाउनलोड के लिए स्वचालित पुनर्प्रयास तंत्र
• असफल संचालन के लिए त्रुटि लॉगिंग
• कनेक्शन त्रुटि प्रबंधन
• रुकावट के मामले में स्थिति संरक्षण

सीमाएँ ⚠️

• Telegram की दर सीमाओं के अधीन
• स्टोरीज़ वर्तमान में सक्रिय होनी चाहिए (समाप्त नहीं)
• Telegram की सीमाओं के अनुसार मीडिया डाउनलोड आकार सीमाएँ लागू होती हैं

योगदान 🤝

योगदान का स्वागत है! कृपया बेझिझक Pull Request सबमिट करें।

लाइसेंस 📄

यह प्रोजेक्ट MIT लाइसेंस के अंतर्गत लाइसेंस प्राप्त है - विवरण के लिए LICENSE फ़ाइल देखें।

अस्वीकरण ⚖️

यह उपकरण केवल शैक्षिक उद्देश्यों के लिए है। सुनिश्चित करें:

• Telegram की सेवा की शर्तों का सम्मान करें
• स्क्रैप करने से पहले आवश्यक अनुमतियाँ प्राप्त करें
• जिम्मेदारी से और नैतिक रूप से उपयोग करें
• डेटा सुरक्षा नियमों का पालन करें
• उपयोगकर्ताओं की गोपनीयता का सम्मान करें