المقدمة والتعريف

مكتبة arabseed-scraper هي مكتبة بايثون احترافية ومفتوحة المصدر مصممة خصيصاً للبحث التفاعلي واستخراج جميع روابط المشاهدة المباشرة (البث) وروابط التحميل المباشر من موقع عرب سيد ومراياه المختلفة وفك تشفيرها تلقائياً بالكامل.

تتميز الحزمة بنظام مرن ومرن جداً لتوزيع وفك تشفير الروابط التي يعتمدها الموقع لحماية الملفات، إلى جانب دعم تدوير المرايا والتحويل التلقائي للنطاقات الشغالة (Mirror Fallback) لتفادي مشاكل الحجب الإقليمي.

🔓 تقنية فك تشفير الروابط الحصرية
يقوم الموقع بتعمية الروابط عبر تحويلها إلى مسارات Base64 معقدة. تفك هذه المكتبة تشفير هذه الروابط فورياً وتعطيك الروابط المباشرة للسيرفرات الأساسية والبديلة (مثل ArabSeed CDN و Up4ever وغيرها).

البدء السريع

تم رفع المكتبة وتوزيعها رسمياً على منصة حزم بايثون العالمية PyPI. يمكنك تثبيتها في ثوانٍ باستخدام مدير الحزم pip.

تثبيت الحزمة

terminal
pip install arabseed-scraper

مثال سريع للاستخدام البرمجي

python
from arabseed_scraper import ArabSeedAPI

# 1. تهيئة الكلاس
api = ArabSeedAPI()

# 2. البحث عن عمل
results = api.search("فيلم الست")

# 3. طباعة السيرفرات والروابط المباشرة المفكوكة التشفير
if results:
    url = results[0]['url']
    download_servers = api.get_download_links(url)
    for d in download_servers:
        print(f"السيرفر: {d['server']} -> الرابط المباشر: {d['direct_link']}")

واجهة الطرفية CLI التفاعلية

تأتي المكتبة مع واجهة تفاعلية ملونة وفائقة الجمال داخل موجه الأوامر (Terminal) مبنية بالكامل باستخدام مكتبة rich الرائعة. تتيح لك الواجهة البحث التفاعلي واختيار الفيلم أو الحلقة بمرونة كاملة وتوليد جداول منظمة للروابط.

تشغيل الواجهة التفاعلية

terminal
arabseed-scraper
🎨 تلميح التصميم الملون
في حال كانت بيئة التشغيل لديك تدعم الألوان الكاملة، ستظهر الأداة بجداول رسومية ملونة وموجهات تفاعلية، وفي البيئات البسيطة ستقوم تلقائياً بالتحويل لواجهة نصية متوافقة وجميلة لضمان عدم توقف البرنامج.

تهيئة الـ API والتحكم بالمرايا

يمكنك تهيئة كلاس ArabSeedAPI بمرايا ونطاقات مخصصة للتحكم بالاتصال وإدارته بشكل كامل.

python
from arabseed_scraper import ArabSeedAPI

# تهيئة بموقع مخصص وتحديد مهلة اتصال (timeout) بـ 15 ثانية
api = ArabSeedAPI(base_url="https://m.asd.ink", timeout=15)

# اختبار سرعة استجابة النطاق بالثواني (Latency)
latency = api.test_connection()
print(f"سرعة الاستجابة: {latency:.4f} ثانية")

# البحث والتبديل التلقائي إلى أسرع نطاق مرآة شغالة حالياً
fallback_success = api.auto_fallback_mirror()
print("تم التبديل لأسرع مرآة بنجاح:", fallback_success)
print("النطاق النشط الحالي:", api.base_url)

جلب التفاصيل واستخراج حلقات المواسم

تستعلم هذه الدالة عن صفحة العمل للحصول على القصة وتفاصيل المسلسل والمواسم والحلقات كاملة.

python
# جلب تفاصيل العمل
details = api.get_details("https://m.asd.ink/مسلسل-ليل-الحلقة-69/")

print("اسم العمل الفعلي:", details["title"])
print("القصة:", details["description"])
print("هل العمل مسلسل؟:", details["is_series"])

# في حال كان مسلسلاً، اطبع حلقات الموسم بالكامل وروابطها
if details["is_series"]:
    for ep in details["episodes"]:
        active_status = "⭐ حلقة حالية" if ep["active"] else ""
        print(f"- {ep['title']} -> {ep['url']} {active_status}")