🕷️ TGSpyder

TGSpyder هي أداة سطر أوامر مفتوحة المصدر للاستخبارات مفتوحة المصدر (OSINT) على تيليجرام من إنتاج Darksight Analytics.

الميزات

• استخراج قائمة الأعضاء من المجموعات العامة والخاصة إلى ملف CSV
• استخراج رسائل الدردشة من المجموعات العامة والخاصة إلى ملف CSV
• استخراج روابط دعوة t.me من سجل الدردشة (المجموعات العامة والخاصة)
• البحث عن مستخدم تيليجرام باسم المستخدم أو (بشكل محدود) بالمعرّف الرقمي
• تحديد معرّف منشئ حزمة الملصقات (يُستنتج عبر معرّف مجموعة الملصقات) الفضل يعود إلى: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• دعم البروكسي:
  • حفظ البروكسي (--set-proxy)
  • إزالة البروكسي (--remove-proxy)
  • تجاوز البروكسي لمرة واحدة (--proxy)

المتطلبات

• Python 3.10+

التثبيت

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

🕷️ مقدمة

أداة سطر أوامر للاستخبارات مفتوحة المصدر (OSINT) على تيليجرام مصممة للمحققين والمحللين والصحفيين والباحثين.

TGSpyder هي أداة OSINT تعمل عبر سطر الأوامر لجمع وتحليل بيانات تيليجرام بشكل منظم. تتيح استخراج الأعضاء والرسائل وروابط الدعوة والمستخدمين والبيانات الوصفية من مجموعات وقنوات تيليجرام العامة والخاصة — مع تصدير كل شيء إلى ملفات CSV سهلة الاستخدام للمحققين.

الميزات

• 📋 استخراج قوائم الأعضاء (حيثما يسمح تيليجرام بذلك)
• 💬 تجميع رسائل الدردشة
• 🔗 استخراج روابط دعوة تيليجرام وإزالة التكرارات
• 🧍 البحث عن المستخدمين بالمعرّف أو اسم المستخدم
• 🎭 تحديد منشئي حزم الملصقات
• 🌐 دعم بروكسي SOCKS (تور / VPN)
• 📁 مخرجات CSV نظيفة لسير عمل OSINT
• 📦 بنية المخرجات

يتم تخزين جميع البيانات المجمعة في مجلد تشغيل واحد:

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 البدء السريع

1️⃣ استنساخ المستودع

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ إنشاء وتفعيل بيئة افتراضية

python3 -m venv venv
source venv/bin/activate

3️⃣ تثبيت التبعيات

pip install -r requirements.txt

4️⃣ تثبيت TGSpyder كأداة سطر أوامر

pip install -e .

تحقق من التثبيت:

tgspyder --help

🔑 بيانات اعتماد تيليجرام API

• انتقل إلى https://my.telegram.org وسجّل الدخول بحساب تيليجرام الخاص بك.
• انتقل إلى أدوات تطوير API لإنشاء API ID وAPI Hash الخاصين بك، وهما مطلوبان لمصادقة TGSpyder مع تيليجرام.

🧭 الاستخدام الأساسي

استخراج الأعضاء والدردشات

tgspyder https://t.me/examplegroup --members --chats

استخراج روابط الدعوة فقط

tgspyder https://t.me/examplegroup --crawl-invites

البحث عن مستخدم

tgspyder --user 123456789
tgspyder --user @username

البحث عن منشئ حزمة الملصقات

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 دعم البروكسي

تدعم TGSpyder بروكسيات SOCKS (متوافق مع تور / VPN).

بروكسي لمرة واحدة

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

حفظ البروكسي للتشغيلات المستقبلية

tgspyder --set-proxy socks5://127.0.0.1:9050

إزالة البروكسي المحفوظ

tgspyder --remove-proxy

🔐 المصادقة والإعدادات

عند أول تشغيل، سيُطلب منك:

• Telegram API ID
• Telegram API Hash
• حساب مستخدم أو رمز بوت

تُخزَّن بيانات الاعتماد محليًا في: ~/.tgspyder.conf

تُعاد استخدام ملفات الجلسة تلقائيًا.

⚠️ القيود

• بعض المجموعات لا تُظهر قوائم الأعضاء
• المجموعات الخاصة تتطلب روابط دعوة صالحة
• تحديد منشئ الملصقات غير مضمون دائمًا
• تخضع لحدود تيليجرام API

🧪 الاستخدام الأخلاقي وإخلاء مسؤولية OSINT

تم تصميم TGSpyder من أجل:

• تحقيقات OSINT
• البحث الأكاديمي
• الصحافة
• تحليل التهديدات والشبكات

يتحمل المستخدمون مسؤولية الامتثال لـ:

• القوانين المحلية
• شروط خدمة المنصة
• معايير البحث الأخلاقية

📄 الترخيص

MIT License راجع LICENSE للتفاصيل.

🚀 العرض التوضيحي

👤 المؤلف

• Valdemar Balle
• مؤسس Darksight Analytics

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

تُوفَّر TGSpyder لأغراض الاستخبارات مفتوحة المصدر (OSINT) والبحث والتحقيق والتعليم فقط.

يتحمل المستخدمون وحدهم مسؤولية ضمان امتثال استخدامهم لهذه الأداة لـ:

• القوانين واللوائح المعمول بها
• شروط خدمة المنصة
• معايير البحث والتحقيق الأخلاقية

لا يتحمل المؤلف والمساهمون أي مسؤولية عن إساءة استخدام هذه الأداة أو عن أي عواقب ناتجة عن استخدامها.