cp .env.example .env          # قم بالتكوين (انظر أدناه)
docker compose up --build     # يبدأ تشغيل db + app + frontend

PHISH_PROXY_URL=socks5://127.0.0.1:9050
PHISH_PROXY_SSL_VERIFY=true   # Tor لا يعترض TLS

PHISH_PROXY_URL=http://127.0.0.1:8080
PHISH_PROXY_SSL_VERIFY=false  # مطلوب لـ Burp / الوكلاء المعترضين

curl -X POST http://localhost:8000/api/v1/collections \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://suspicious-site.example.com", "use_wordlist": true}'

# التثبيت (داخل الحاوية أو بيئة افتراضية محلية مع requirements.txt)
pip install -e .

# إرسال رابط والانتظار حتى الانتهاء
phishcollector collect https://target.example.com --wait

# مع اختبار تخميني بقائمة كلمات
phishcollector collect https://target.example.com --wordlist --wait

# عرض الوظائف الأخيرة
phishcollector list

# عرض التفاصيل الكاملة
phishcollector detail <job-id>

# تنزيل لقطة الشاشة
phishcollector screenshot <job-id> -o capture.png

# البحث حسب حزمة التقنيات / تجزئة favicon / الدولة
phishcollector search --tech WordPress --country RU
phishcollector search --favicon-hash -1234567890

PHISH_URLHAUS_ENABLED=true
PHISH_URLHAUS_API_KEY=<مفتاح-المصادقة-الخاص-بك>

PHISH_VIRUSTOTAL_API_KEY=<مفتاحك>

# phishcollector/plugins/myplugin.py
from . import CheckResult

async def check(url: str, proxy_url=None, ssl_verify=True) -> CheckResult:
    # استعلم عن مصدرك / API هنا
    return CheckResult(
        plugin_name="myplugin",
        status="malicious",   # malicious | suspicious | clean | unknown | error
        score=0.95,           # 0.0–1.0، أو None
        result={"raw": ...},  # مخزنة بصيغة JSONB، معروضة في الواجهة
    )

from .myplugin import check as myplugin_check
tasks.append(myplugin_check(url, proxy_url=settings.proxy_url, ssl_verify=settings.proxy_ssl_verify))

phishcollector/collector/fingerprint.py

PHISHING_PATTERNS: dict[str, list[tuple[str, str]]] = {

    "credential_harvest": [
        (r"document\.getElementById\(['\"]password['\"]", "JS يقرأ حقل كلمة المرور بواسطة المعرف"),
        (r"btoa\s*\(.*password", "ترميز كلمة المرور بـ Base64"),
        # أضف قواعدك الخاصة هنا …
    ],

    "obfuscation": [
        (r"\beval\s*\(", "استخدام eval()"),
        (r"atob\s*\(", "فك ترميز Base64 في وقت التشغيل"),
    ],

    "exfiltration": [
        (r"api\.telegram\.org/bot", "تسريب عبر بوت Telegram"),
        (r"@(?:gmail|yahoo|hotmail|outlook)\.com", "عنوان بريد مجاني في الكود"),
    ],

    "antibot": [
        (r"navigator\.webdriver", "فحص خاصية WebDriver"),
        (r"ipqualityscore|ipqs\.com", "خدمة مكافحة البوتات IPQS"),
    ],

    "kit_indicators": [
        (r"office365|microsoft365", "موضوع تصيد Office 365"),
        (r"paypal.*limit|limit.*paypal", "موضوع حدود PayPal"),
        # حزمة جديدة لاحظتها؟ أضف قاعدة هنا:
        (r"docusign.*sign|e.?sign.*document", "طعم DocuSign"),
        (r"(?:dhl|fedex|ups).*track", "طعم توصيل الطرود"),
    ],
}

# مثال: تتبع بصمة حزمة مكتشفة حديثًا
"my_campaign_2024": [
    (r"panel\.php\?cmd=send", "مسار C2 معروف"),
    (r"X-Mailer:\s*PHPMailer\s*5\.2\.1", "إصدار PHPMailer محدد تستخدمه الحزمة"),
],

TECH_SIGNATURES: dict[str, dict] = {
    "WordPress": {
        "html":    [r"wp-content", r"wp-includes"],
        "url":     [r"/wp-login\.php"],
        "cookies": ["wordpress_"],
    },
    # أضف أي شيء تريد تتبعه:
    "GoPhish": {
        "html": [r"rid=[a-zA-Z0-9]{20}"],
        "url":  [r"/track\?rid="],
    },
    "Evilginx": {
        "url":  [r"phishlets"],
        "html": [r"__utmz.*evilginx"],
    },
}

# مسارات حزم جديدة لوحظت
/panel/send.php
/b374k.php
/uploads/gate.php

/data/
  screenshots/   <collection-id>.png
  html/          <collection-id>.html
  assets/
    <collection-id>/
      <sha256-prefix>.js
      <sha256-prefix>.css

phishcollector/
  collector/
    browser.py        # التقاط Playwright، JS الخفي، تدوير وكيل المستخدم
    fingerprint.py    # جميع فحوصات البصمة + PHISHING_PATTERNS + TECH_SIGNATURES
    spider.py         # استخراج الروابط، robots.txt، خريطة الموقع، اختبار تخميني بقائمة كلمات
    orchestrator.py   # دورة حياة المهمة: يربط جميع الوحدات معًا
  plugins/
    __init__.py       # فئة CheckResult
    urlhaus.py        # إضافة abuse.ch URLhaus
    virustotal.py     # إضافة VirusTotal v3
    runner.py         # تشغيل الإضافات المفعلة بشكل متزامن
  api/
    routes.py         # نقاط نهاية FastAPI
  main.py             # نقطة دخول التطبيق، CORS، وسيط المصادقة
  models.py           # نماذج SQLAlchemy ORM
  config.py           # إعدادات Pydantic (متغيرات البيئة)
  database.py         # محرك، مصنع الجلسات، ترحيلات المخطط
frontend/
  app.js              # تطبيق SPA بـ Vanilla JS
  style.css           # واجهة طرفية إلكترونية
  nginx.conf          # وكيل عكسي + رؤوس أمان
wordlists/
  phishing_paths.txt  # قائمة كلمات الزاحف الافتراضية

# تشغيل قاعدة البيانات فقط
docker compose up db -d

# تشغيل API محليًا
pip install -r requirements.txt
playwright install chromium
uvicorn phishcollector.main:app --reload

# تشغيل الاختبارات (إن وجدت)
pytest