أوامر الكاشط

1. كاشط المباريات (fetch_matches.py)

يقوم بكشط المباريات من الموقع مع جميع التفاصيل (النتائج، الفرق، الشعارات) + أحداث المباريات (أهداف، بطاقات، تبديلات)

كشط دوري وموسم محدد


python scraper/fetch_matches.py --league 4 --season 2026

مثال: كأس السوبر الإسباني (league_id=4) موسم 2026

كشط دوري كامل (كل المواسم)


python scraper/fetch_matches.py --league 3

مثال: الدوري الإسباني (league_id=3) كل المواسم المتاحة

كشط الموسم الحالي لكل الدوريات


python scraper/fetch_matches.py --current

كشط كل الدوريات وكل المواسم


python scraper/fetch_matches.py --all

⚠️ تحذير: هذا الأمر يستغرق وقتاً طويلاً جداً (ساعات)

ميزة جديدة: الكاشط يقوم تلقائياً بجلب أحداث المباريات المنتهية (أهداف، بطاقات، تبديلات) وحفظها في قاعدة البيانات

2. كاشط الترتيب (fetch_standings.py)

يقوم بكشط جدول ترتيب الدوري/البطولة

كشط ترتيب موسم محدد


python scraper/fetch_standings.py --league 3 --season "2025/2026"

مثال: الدوري الإسباني موسم 2025/2026

تحديد slug البطولة يدوياً


python scraper/fetch_standings.py --league 3 --season "2025/2026" --slug "spanish-primera-division"

3. كاشط إحصائيات اللاعبين (fetch_player_stats.py)

يقوم بكشط إحصائيات الهدافين والصانعين مع صور اللاعبين

كشط الهدافين فقط


python scraper/fetch_player_stats.py --league 3 --season "2025/2026" --type scorers

كشط الصانعين فقط


python scraper/fetch_player_stats.py --league 3 --season "2025/2026" --type assists

كشط الهدافين والصانعين معاً


python scraper/fetch_player_stats.py --league 3 --season "2025/2026" --type both

مع تحديد slug البطولة


python scraper/fetch_player_stats.py --league 3 --season "2025/2026" --type both --slug "spanish-primera-division"

ميزة: يقوم تلقائياً بتحميل صور اللاعبين وحفظها محلياً في assets/images/players/

4. كاشط البطولات (fetch_competitions.py)

يقوم بكشط قائمة البطولات المتاحة وحفظها في قاعدة البيانات

كشط جميع البطولات


python scraper/fetch_competitions.py

يجلب جميع البطولات مع الشعارات والألوان والمواسم

5. كاشط المباريات المباشرة (live_matches_daemon.py) خدمة خلفية

يعمل في الخلفية لتحديث بيانات المباريات المباشرة تلقائياً كل 10 ثوانٍ من API

ميزات الكاشط المباشر

تحديث النتائج والدقيقة والوقت بدل الضائع
تحديث حالة المباراة (live, finished)
تحديث جميع الأحداث (أهداف، بطاقات، تبديلات)
التحقق من المباريات القادمة التي بدأت

تشغيل يدوي (للاختبار)


python scraper/live_matches_daemon.py

استخدم Ctrl+C لإيقاف الكاشط

تثبيت كخدمة systemd (موصى به للعمل التلقائي)


# تثبيت الخدمة
./scraper/manage_live_daemon.sh install

# بدء الخدمة
./scraper/manage_live_daemon.sh start

# التحقق من الحالة
./scraper/manage_live_daemon.sh status

# عرض السجلات
./scraper/manage_live_daemon.sh logs

# عرض السجلات الحية (Ctrl+C للإيقاف)
./scraper/manage_live_daemon.sh logs follow

# إعادة التشغيل
./scraper/manage_live_daemon.sh restart

# إيقاف الخدمة
./scraper/manage_live_daemon.sh stop

# إلغاء التثبيت
./scraper/manage_live_daemon.sh uninstall

ملف السجلات


/var/www/kooralive/logs/live_matches.log

عرض السجلات: ./scraper/manage_live_daemon.sh file-logs

معلومات إضافية

معرفات البطولات الشائعة (league_id)

3 - الدوري الإسباني (La Liga)

4 - كأس السوبر الإسباني

1 - دوري أبطال أوروبا

2 - الدوري الإنجليزي الممتاز

💡 للحصول على قائمة كاملة: صفحة البطولات

صيغة المواسم

للدوريات: 2025/2026
للبطولات: 2026
الكاشط يقوم تلقائياً بتحويل الصيغة حسب الحاجة

FlareSolverr (مطلوب)

تنبيه: جميع الكواشط تتطلب تشغيل FlareSolverr لتجاوز Cloudflare


docker run -d -p 8191:8191 --name=flaresolverr ghcr.io/flaresolverr/flaresolverr:latest

تأكد من تشغيل FlareSolverr على المنفذ 8191 قبل استخدام أي كاشط

سير العمل الموصى به

1
كشط البطولات أولاً: python scraper/fetch_competitions.py
2
كشط المباريات (مع الأحداث): python scraper/fetch_matches.py --league 3 --season "2025/2026"
3
كشط الترتيب: python scraper/fetch_standings.py --league 3 --season "2025/2026"
4
كشط إحصائيات اللاعبين: python scraper/fetch_player_stats.py --league 3 --season "2025/2026" --type both

ملاحظة مهمة

🎯 الكاشط الشامل الجديد (scrape_all.py)

كشط موسم محدد (موصى به)

كشط دوري كامل

الموسم الحالي فقط

كل شيء ⚠️