|
1 | | -# Telegram Virus Scanner Bot |
| 1 | +# 🤖 Telegram Virus Scanner Bot |
2 | 2 |
|
3 | | -🤖 بوت لفحص الروابط باستخدام [VirusTotal API](https://www.virustotal.com/). |
| 3 | +بوت لفحص الروابط باستخدام [VirusTotal API](https://www.virustotal.com/). |
4 | 4 |
|
5 | 5 | --- |
6 | 6 |
|
7 | | -## المتطلبات |
| 7 | +## 📝 المتطلبات |
8 | 8 |
|
9 | | -- Python >= 3.11 |
10 | | -- مكتبات Python المطلوبة: |
11 | | - - python-telegram-bot==20.5 |
12 | | - - requests==2.31.0 |
13 | | - - python-dotenv==1.0.0 |
| 9 | +- **Python** >= 3.11 |
| 10 | +- المكتبات المطلوبة: |
| 11 | + - `python-telegram-bot==20.5` |
| 12 | + - `requests==2.31.0` |
| 13 | + - `python-dotenv==1.0.0` |
14 | 14 |
|
15 | 15 | --- |
16 | 16 |
|
17 | | -## تثبيت المشروع |
| 17 | +## ⚡ تثبيت المشروع |
18 | 18 |
|
19 | | -1. استنساخ المستودع: |
| 19 | +1. **استنساخ المستودع:** |
20 | 20 | ```bash |
21 | 21 | git clone https://github.com/username/telegram-bot.git |
22 | 22 | cd telegram-bot |
| 23 | +``` |
23 | 24 |
|
24 | | -2-إنشاء بيئة افتراضية وتفعيلها: |
| 25 | +2. **إنشاء بيئة افتراضية وتفعيلها:** |
| 26 | +```bash |
25 | 27 | python -m venv venv |
| 28 | + |
26 | 29 | # على ويندوز |
27 | 30 | venv\Scripts\activate |
| 31 | + |
28 | 32 | # على لينكس/ماك |
29 | 33 | source venv/bin/activate |
| 34 | +``` |
30 | 35 |
|
31 | | -3-تثبيت المكتبات: |
| 36 | +3. **تثبيت المكتبات المطلوبة:** |
| 37 | +```bash |
32 | 38 | pip install -r requirements.txt |
| 39 | +``` |
33 | 40 |
|
34 | | -4-إنشاء ملف .env وملئه بالمفاتيح: |
| 41 | +4. **إنشاء ملف `.env` وملئه بالمفاتيح:** |
| 42 | +``` |
35 | 43 | TELEGRAM_TOKEN=your_telegram_bot_token_here |
36 | 44 | VIRUSTOTAL_API_KEY=your_virustotal_api_key_here |
| 45 | +``` |
37 | 46 |
|
38 | | -تشغيل البوت |
| 47 | +5. **تشغيل البوت:** |
| 48 | +```bash |
39 | 49 | python main.py |
| 50 | +``` |
40 | 51 |
|
41 | | -------------------------------------------------------------------- |
42 | | - |
43 | | -الأوامر المتاحة في البوت |
44 | | - |
45 | | -/start - بداية التشغيل وشرح البوت |
46 | | - |
47 | | -/help - المساعدة |
48 | | - |
49 | | -/about - معلومات عن البوت |
50 | | - |
51 | | -/scan <رابط> - فحص رابط محدد |
52 | | - |
53 | | -/stats - عرض إحصائيات المستخدم |
| 52 | +--- |
54 | 53 |
|
55 | | -/export - تصدير تقرير المستخدم |
| 54 | +## 🔹 الأوامر المتاحة في البوت |
56 | 55 |
|
57 | | -/clear - مسح التقرير |
| 56 | +| الأمر | الوصف | |
| 57 | +|----------------|------------------------------------------------| |
| 58 | +| `/start` | بداية التشغيل وشرح البوت | |
| 59 | +| `/help` | المساعدة | |
| 60 | +| `/about` | معلومات عن البوت | |
| 61 | +| `/scan <رابط>` | فحص رابط محدد | |
| 62 | +| `/stats` | عرض إحصائيات المستخدم | |
| 63 | +| `/export` | تصدير تقرير المستخدم | |
| 64 | +| `/clear` | مسح التقرير | |
| 65 | +| إرسال أي رابط مباشر | يتم فحصه تلقائيًا | |
58 | 66 |
|
59 | | -إرسال أي رابط مباشر لفحصه تلقائيًا |
| 67 | +--- |
60 | 68 |
|
61 | | ------------------------------------------------------------------- |
62 | | -ملاحظات |
| 69 | +## 💡 ملاحظات مهمة |
63 | 70 |
|
64 | | -تأكد من عدم رفع ملف .env إلى GitHub. |
| 71 | +- **لا تقم برفع ملف `.env` إلى GitHub** لتجنب تسرب المفاتيح. |
| 72 | +- جميع السجلات يتم حفظها في ملفات `logs_<user_id>.txt`. |
| 73 | +- البوت يستخدم Telegram Bot API و VirusTotal API لفحص الروابط. |
65 | 74 |
|
66 | | -جميع السجلات يتم حفظها في ملفات logs_<user_id>.txt. |
| 75 | +--- |
67 | 76 |
|
68 | | -هذا البوت يستخدم Telegram Bot API و VirusTotal API لفحص الروابط. |
| 77 | +## 🛠️ نصائح لاحتراف المشروع |
69 | 78 |
|
70 | | --------------------------------------------------------------------- |
71 | | -نصائح إضافية لاحتراف المشروع |
| 79 | +1. استخدام مجلد `logs/` لحفظ السجلات بدل وضعها في مجلد الجذر. |
| 80 | +2. تحديث README دائمًا عند إضافة ميزات جديدة. |
| 81 | +3. عند تشغيل البوت على Render أو أي سيرفر، ضع `.env` مباشرة على السيرفر. |
| 82 | +4. إضافة ملف `LICENSE` (مثل MIT أو Apache) لتوضيح حقوق الاستخدام. |
72 | 83 |
|
73 | | -استخدام مجلد logs/ لحفظ الملفات بدل وضعها في مجلد الجذر. |
| 84 | +--- |
74 | 85 |
|
75 | | -تحديث README دائمًا إذا أضفت ميزات جديدة. |
| 86 | +## 📌 روابط مفيدة |
76 | 87 |
|
77 | | -على Render أو أي سيرفر، ضع .env مباشرة على السيرفر بدل رفعه للمستودع. |
| 88 | +- [Telegram Bot API Documentation](https://core.telegram.org/bots/api) |
| 89 | +- [VirusTotal API Documentation](https://developers.virustotal.com/) |
78 | 90 |
|
79 | | -إضافة ملف LICENSE (MIT أو Apache) لتوضيح حقوق الاستخدام. |
|
0 commit comments