ماسح قصص تيليجرام 📱

سكريبت بلغة Python يتيح لك مسح وتنزيل القصص تلقائيًا من أصدقائك في تيليجرام باستخدام مكتبة Telethon. يقوم السكريبت بمراقبة مستمرة وحفظ كل من الصور والفيديوهات من القصص، إلى جانب بياناتها الوصفية.

TGSS - الواجهة الرئيسية

ملاحظة هامة حول الوصول إلى القصص ⚠️

بسبب قيود API تيليجرام، يمكن لهذا السكريبت الوصول إلى القصص فقط من:

• المستخدمين الذين أضفتهم إلى قائمة أصدقائك
• المستخدمين الذين تسمح إعدادات الخصوصية الخاصة بهم بمشاهدة قصصهم

هذا قيد من API تيليجرام ولا يمكن تجاوزه.

الميزات 🚀

• مسح جميع القصص المتاحة تلقائيًا من أصدقائك في تيليجرام
• تنزيل كل من الصور والفيديوهات من القصص
• تخزين البيانات الوصفية في قاعدة بيانات SQLite
• تصدير البيانات إلى جدول بيانات Excel
• مراقبة فورية بفترات زمنية قابلة للتخصيص
• الطابع الزمني مضبوط على (UTC+2)
• الحفاظ على سجل القصص التي تم تنزيلها سابقًا
• إمكانية الاستئناف
• آلية إعادة المحاولة التلقائية

المتطلبات الأساسية 📋

قبل تشغيل السكريبت، ستحتاج إلى:

• Python 3.7 أو أحدث
• حساب تيليجرام
• بيانات اعتماد API من تيليجرام
• أصدقاء على تيليجرام ترغب في تتبع قصصهم

حزم Python المطلوبة

pip install -r requirements.txt

محتويات requirements.txt:

telethon
openpyxl
schedule

الحصول على بيانات اعتماد 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 الخاص بك
   • رقم هاتفك (مع رمز الدولة)
   • رمز التحقق (المرسل إلى تيليجرام الخاص بك)
   • فترة التحقق بالثواني (الافتراضي هو 60)

كيفية العمل 🔄

يقوم السكريبت:

1. الاتصال بحسابك على تيليجرام
2. التحقق دوريًا من وجود قصص جديدة من أصدقائك
3. تنزيل أي قصص جديدة (صور/فيديوهات)
4. تخزين البيانات الوصفية في قاعدة بيانات SQLite
5. تصدير المعلومات إلى ملف Excel
6. العمل باستمرار حتى يتم إيقافه (Ctrl+C)

تخزين البيانات 💾

هيكل قاعدة البيانات (stories.db)

قاعدة بيانات SQLite تحتوي على:

• user_id: معرف مستخدم تيليجرام لمنشئ القصة
• story_id: معرف فريد للقصة
• timestamp: وقت نشر القصة (UTC+2)
• filename: اسم الملف المحلي للوسائط التي تم تنزيلها

تصدير CSV و Excel (stories_export.csv/xlsx)

ملف التصدير يحتوي على نفس المعلومات الموجودة في قاعدة البيانات، وهو مفيد لـ:

• عرض سهل للبيانات الوصفية للقصص
• التصفية والفرز
• تحليل البيانات
• مشاركة البيانات مع الآخرين

تخزين الوسائط 📁

• يتم حفظ الصور بصيغة: {user_id}_{story_id}.jpg
• يتم حفظ الفيديوهات بامتدادها الأصلي: {user_id}_{story_id}.{extension}
• يتم حفظ جميع ملفات الوسائط في دليل السكريبت

الميزات بالتفصيل 🔍

المراقبة المستمرة

• فترة تحقق قابلة للتخصيص (الافتراضي: 60 ثانية)
• يعمل باستمرار حتى يتم إيقافه يدويًا
• يحافظ على الحالة بين جلسات التشغيل
• يتجنب التنزيلات المكررة

معالجة الوسائط

• يدعم كلًا من الصور والفيديوهات
• يكتشف تلقائيًا نوع الوسائط
• يحافظ على الجودة الأصلية
• يُنشئ أسماء ملفات فريدة

معالجة الأخطاء 🛠️

يتضمن السكريبت:

• آلية إعادة محاولة تلقائية للتنزيلات الفاشلة
• تسجيل الأخطاء للعمليات الفاشلة
• معالجة أخطاء الاتصال
• الحفاظ على الحالة في حالة الانقطاع

القيود ⚠️

• يخضع لحدود معدل تيليجرام
• يجب أن تكون القصص نشطة حاليًا (غير منتهية الصلاحية)
• تنطبق حدود حجم تنزيل الوسائط حسب قيود تيليجرام

المساهمة 🤝

المساهمات مرحب بها! لا تتردد في تقديم طلب سحب (Pull Request).

الترخيص 📄

هذا المشروع مرخص بموجب رخصة MIT - راجع ملف LICENSE للحصول على التفاصيل.

إخلاء المسؤولية ⚖️

هذه الأداة مخصصة للأغراض التعليمية فقط. تأكد من:

• احترام شروط خدمة تيليجرام
• الحصول على الأذونات اللازمة قبل المسح
• الاستخدام بمسؤولية وأخلاقية
• الامتثال للوائح حماية البيانات
• احترام خصوصية المستخدمين