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가 있는 로컬 venv에서)
pip install -e .

# URL 제출 및 완료 대기
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

# 기술 스택 / 파비콘 해시 / 국가별 검색
phishcollector search --tech WordPress --country RU
phishcollector search --favicon-hash -1234567890

PHISH_URLHAUS_ENABLED=true
PHISH_URLHAUS_API_KEY=<your-auth-key>

PHISH_VIRUSTOTAL_API_KEY=<your-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로 저장, GUI에 표시
    )

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가 ID로 비밀번호 필드 읽음"),
        (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, UA 로테이션
    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              # Vanilla JS SPA
  style.css           # 사이버 터미널 UI
  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