tgscope

استخبارات المصادر المفتوحة (OSINT) لتليجرام، واستخراج البيانات والأرشفة.
تطبيق ويب محلي يعمل بالكامل على جهازك ولا يتواصل إلا مع تيليجرام.

npm install
npm start

ثم افتح http://127.0.0.1:5173. يرشدك التشغيل الأول خلال إعداد بيانات اعتماد API، وتسجيل الدخول عبر رمز QR، وتحميل محادثاتك. تيليجرام هو الخادم الوحيد الذي يتواصل معه. لا يوجد حساب لإنشائه، ولا تتبع، ولا خدمة وسيطة: ما تجمعه يبقى في ملف SQLite ملك لك.

خليفة لكل من telegram-scraper وtelescope وHarrier، مبني على Telethon 1.44.

ماذا يفعل

جمع

• كل قناة ومجموعة وموضوع منتدى ومحادثة، عبر كل حساب مسجّل الدخول، في شجرة قابلة للتحديد مع المعرف الكامل -100 بجانب الاسم وشارة للحساب الذي يراها
• تُجمع كل محادثة تحت الحساب الذي يمكنه قراءتها فعليًا، لذا فإن التحديد الذي يغطي حسابين يبدأ تشغيلًا واحدًا لكل حساب
• رسائل ببيانات تعريفية كاملة: المشاهدات، وإعادة التوجيه، والتفاعلات، وتواريخ التعديل، والألبومات، والاستطلاعات، والموقع الجغرافي، والروابط، وسلاسل الردود، ومؤلفي المنشورات، ومصدر إعادة التوجيه لكل رسالة
• المجموعات المنتدائية مقسّمة حسب الموضوع — اجمع موضوعات فردية بدلاً من مجموعات كاملة
• تُنزَّل الوسائط بالتوازي وتُزال تكراراتها عبر SHA-256 ومعرف ملف تيليجرام، بحيث يُخزَّن الملف الذي أُعيد توجيهه إلى خمس قنوات مرة واحدة فقط
• استئناف من علامة مائية لكل محادثة؛ ويعيد الوضع المستمر الفحص على فترات
• تعيد المجموعات المحفوظة تشغيل تحديد بنقرة واحدة

تحقق

• ابحث عن رقم هاتف أو @username أو معرف مستخدم أو رابط t.me
• السيرة الذاتية، والعلامات، ودقة آخر ظهور كمؤشر خصوصية، والمحادثات المشتركة، والقناة الشخصية
• أي شيء يختار تيليجرام الكشف عنه طوعًا بشأن الحساب: شهر التسجيل، والدولة التي ينتمي إليها رقم هاتفه، ومتى غيّر الشخص اسمه أو صورة ملفه آخر مرة، ومؤقت الحذف التلقائي، والاسم الظاهر في إعادة التوجيه المقيدة. انتبه إلى أنه عادة لا يكشف عن أيٍّ من ذلك. تظهر هذه الحقول في لوحة مكافحة الاحتيال التي يعرضها تيليجرام عندما يكتب إليك شخص غريب، وتعود فارغة بالنسبة إلى ملف تعريف تبحث عنه مباشرة، فتعامل معها كميزة إضافية لا كشيء تعتمد عليه في التخطيط
• الحسابات التجارية تعطي بشكل موثوق عنوان الشارع والإحداثيات والمنطقة الزمنية
• كل صورة ملف تعريف مرئية، مُجزّأة بـ SHA-256 وتجزئة إدراكية، تُعرض كمعرض
• تُطابَق التجزئات الإدراكية عبر الحسابات، لذا تظهر الصورة نفسها في ملف تعريف آخر
• يُسجَّل مرسلو الرسائل أثناء استخراجهم، لذا فإن الاسم في المتصفح هو رابط عامل للبحث حتى عندما لا يكون للشخص اسم مستخدم؛ ويقوم "مزامنة الأعضاء" بملء ذلك لأي شيء جُمع سابقًا
• تُلتقط لقطة لكل بحث وتُحسب الفروقات: تغييرات اسم المستخدم، وتغييرات الاسم المعروض، وتعديلات السيرة الذاتية، والصور المضافة أو المحذوفة، والخصوصية المتغيرة

تصدير

المتطلبات

• Node.js 18+
• Python 3.12+
• بيانات اعتماد API من my.telegram.org/apps

يُنشئ npm install بيئة Python تحت server/.venv ويُثبّت الطرفين.

أين توجد الملفات

قاعدة بيانات واحدة تضم كل شيء، وهو ما يجعل البحث عبر المحادثات وجدول المستخدمين المشترك وإزالة تكرار الوسائط والرسم البياني لإعادة التوجيه ممكنة.

تخطيط الوسائط

تُرتَّب الملفات حسب نوع المحادثة، ثم المحادثة، ثم موضوع المنتدى، ثم نوع الوسائط:

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

تجمع أسماء المجلدات بين الاسم المختصر والمعرف الكامل، وتُنقحر العناوين غير ASCII، وأسماء الملفات مُعبأة بالأصفار بحيث تُرتَّب زمنيًا.

حدود المعدل وسلامة الحساب

كل استدعاء لتيليجرام يمر عبر مُنظّم لكل حساب مع دلو رموز (token bucket) وتأخير FloodWait، وكل قراءة مقسمة إلى صفحات - رسائل أو محادثات أو أعضاء أو صور ملفات تعريف - تنتظر انتهاء الفيضان ثم تستأنف بدلاً من فشل التشغيل. ثلاثة ملفات تعريف:

تُعلن فترات الانتظار الأطول في سجل النشاط ويُنتظَر انتهاؤها؛ وإذا تكررت اثنتا عشرة مرة على التوالي في قراءة واحدة، يستسلم التطبيق ويُبلغ عنها.

تُدعم حسابات متعددة. حدد أحدها كحساب burner في الإعدادات وستُجرى عمليات البحث عن أرقام الهواتف عليه تلقائيًا، لأنها العملية الوحيدة المحفوفة بالمخاطر:

استعلام رقم الهاتف يستورد الرقم كجهة اتصال للحظة ثم يحذفه مجددًا. إذا كان المالك يحفظ رقمك بالفعل، فقد يرى إشعار "انضم إلى تيليجرام". يسأل tgscope أولاً، في كل مرة، وبطاقة الملف التعريفي تسجل الحساب الذي استُخدم.

التطوير

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

الواجهة الخلفية هي FastAPI فوق نواة Telethon، وتُختبر مقابل عميل Telethon وهمي: المستخرِج، والمُصدِّرون، وتخطيط الوسائط، وكل ترحيل لمخطط قاعدة البيانات. تغطي اختبارات الواجهة الأمامية المنطق الخالص داخل المتصفح، وحساب الفترات الزمنية، وتجميع المدرجات التكرارية، وتنسيق الأرقام والطوابع الزمنية، وتعرض كل شاشة مرتين، مرة فارغة ومرة ممتلئة.

يُعيد scripts/demo/ توليد docs/preview.gif من بيانات وهمية مُلقّحة. يتطلب chromium وffmpeg، ولا يلمس شيئًا في مساحة عملك الحقيقية، وليس جزءًا من التطبيق.

لا يحمل الكود المصدري أي تعليقات — الأسماء والبنية تحمل المعنى، ويضمن ذلك اختبار.

الجانب القانوني

لأغراض البحث والصحافة والتحقيقات المصرح بها. يستخدم واجهة تيليجرام الرسمية عبر Telethon ويقرأ فقط ما يمكن لحسابك رؤيته بالفعل — فهو لا يتجاوز إعدادات الخصوصية الخاصة بأي شخص. لا تستخدمه للمضايقة أو التتبع، واحترم شروط خدمة تيليجرام، وانتبه إلى قانون حماية البيانات الذي ينطبق عليك.

مرخّص بموجب MIT.