⚡ Ch4120N CVE Pulse

스마트 검색 및 위협 인텔리전스를 갖춘 실시간 CVE PoC 수집기

CVE Pulse는 GitHub에서 **CVE 개념 증명(Proof‑of‑Concept)**을 자동으로 발견, 점수화, 색인합니다.
EPSS 점수와 CISA KEV 데이터로 강화하고, 일일 스냅샷 및 차이점을 생성하며, 빠르고 검색 가능한 정적 웹사이트를 제공합니다

📋 목차

• 👨‍💻 프로젝트 제작자
• 🎯 주요 기능
• ✨ 핵심 특징
• 🧱 아키텍처
• ⚙️ 작동 방식
• 🚀 빠른 시작
• 📦 설치
• 💻 사용법
  • 하위 명령어
  • 전체 파이프라인
• 📊 출력 및 웹사이트
• 🗂️ 프로젝트 구조
• 🔧 설정
• 📡 데이터 소스
• 📅 자동화 (CI/CD)
• 📈 트렌딩 PoC
• ⚠️ 면책 조항
• 📄 라이선스

👨‍💻 프로젝트 제작자

Ch4120N – 보안 애호가 및 자동화 애호가.
📧 [email protected]

🎯 주요 기능

1. 최신 EPSS 점수와 CISA 알려진 악용 취약점(KEV) 목록을 가져옵니다.
2. CVE에 대한 익스플로잇 PoC를 포함하는 저장소를 GitHub에서 검색합니다 (검색 + GraphQL 메타데이터 사용).
3. 각 후보를 신뢰도 모델(스타, 최신성, 키워드 일치, 블랙리스트 등)로 점수화합니다.
4. PoC 데이터를 EPSS 및 KEV와 결합한 후 완전한 JSON API를 구축합니다.
5. 강력한 클라이언트 측 검색 엔진을 갖춘 정적 웹사이트를 생성합니다.
6. 일일 스냅샷과 차이점을 생성하여 새로운 고신뢰도 PoC를 추적할 수 있습니다.

✨ 핵심 특징

• 🔍 자동화된 PoC 발견 – 다중 윈도우 GitHub 코드/저장소 검색
• 🧠 스마트 점수화 – 코드 대 문서 일치, 스타 수, 최신성, 블랙리스트, 휴리스틱
• 📈 EPSS 및 KEV 통합 – CISA의 KEV 목록과 FIRST의 EPSS 점수가 PoC 데이터와 병합됨
• 📊 일일 스냅샷 및 차이점 – 새로운 것, "고신뢰도"로 승격된 것, 제거된 것을 확인
• 🌐 검색 가능한 웹사이트 – CVE ID, 벤더, 제품, 키워드로 퍼지 검색, 부정 필터(-windows) 지원
• 🚀 완전 자동화 – GitHub Actions 파이프라인이 일정에 따라 모든 것을 업데이트
• 💾 제로 서버 비용 – 모든 데이터는 정적 JSON/HTML로 GitHub Pages에서 호스팅
• 🛡️ 블랙리스트 지원 – 노이즈가 많거나 관련 없는 저장소 무시

🧱 아키텍처

⚙️ 작동 방식

1. **fetch-epss**는 EPSS 점수 기준 상위 2000개 CVE를 다운로드합니다.
2. **fetch-kev**는 CISA KEV 카탈로그를 다운로드합니다.
3. **sync-cves**는 data/github.txt를 읽고 MITRE API에서 CVE 메타데이터를 가져온 후 각 CVE에 대한 마크다운 파일을 생성/업데이트합니다.
4. pipeline (또는 개별 build-* 명령어):
   • 스캔할 CVE의 범위를 구축합니다 (github.txt 또는 이전에 저신뢰도였던 것들로부터).
   • GitHub 검색 API를 사용하여 CVE ID를 언급하는 저장소를 찾습니다.
   • GraphQL을 통해 저장소 메타데이터(스타, 언어, 토픽)로 후보를 강화합니다.
   • 각 저장소를 점수화하고 신뢰도 등급(높음, 중간, 낮음)을 할당합니다.
   • CVE별 JSON 파일, 인덱스, 상위 100개 목록을 작성합니다.
   • 현재 상태의 스냅샷과 전날 대비 차이점을 생성합니다.
5. **build-site**는 CVE_list.json, trending_poc.json, 정적 HTML 페이지를 생성합니다.
6. 웹사이트(docs/)는 GitHub Pages에 배포됩니다.

🚀 빠른 시작```bash

Clone the repository

git clone https://github.com/Ch4120N/Ch4120N-CVE-Pulse.git cd Ch4120N-CVE-Pulse

Install dependencies

pip install -r requirements.txt

Download base data

python chCVEPulse.py fetch-epss python chCVEPulse.py fetch-kev

Sync your initial CVE list (from data/github.txt)

python chCVEPulse.py sync-cves

Run the full discovery pipeline (needs GITHUB_TOKEN for higher rate limits)

export GITHUB_TOKEN=your_token_here python chCVEPulse.py pipeline --days 7

Generate the static website

python chCVEPulse.py build-site

Open docs/index.html in your browser

---

## 📦 설치

**요구 사항:**
- Python 3.9+
- `pip`

패키지를 설치하세요:```bash
pip install -r requirements.txt

(requirements.txt에는 requests, jinja2 및 기타 의존성이 포함되어 있습니다.)

💻 사용법

모든 작업은 단일 스크립트 chCVEPulse.py를 통해 수행됩니다.

하위 명령어

예시:```bash

Fetch new data

python chCVEPulse.py fetch-epss --limit 2000 python chCVEPulse.py fetch-kev

Update a specific CVE

python chCVEPulse.py sync-cves --cve CVE-2025-12345

Full pipeline (daily mode)

python chCVEPulse.py pipeline --days 7 --mode daily --limit 50

Regenerate website only

python chCVEPulse.py build-site --html-mode summary

### 전체 파이프라인

`pipeline` 하위 명령은 세부 조정이 가능합니다:

- `--days` : GitHub를 며칠 전까지 검색할지 (기본값: 7)
- `--mode` : `daily` (최근 CVE, 더 빠름) 또는 `weekly` (더 광범위한 스캔)
- `--limit` : 스캔할 최대 CVE 수 (기본값: 50)
- `--cve` : 스캔할 하나 이상의 CVE ID 지정
- `--skip-discovery` : 기존 데이터에서 출력만 재생성
- `--check-links` : 저장소 URL이 아직 유효한지 확인

---

## 📊 출력 및 웹사이트

파이프라인 실행이 성공하면 `docs/`에 다음이 포함됩니다:

- **`index.html`** – 메인 검색 페이지 (`logic.js`와 `style.css`로 구동)
- **`CVE_list.json`** – 설명과 PoC 링크가 포함된 모든 CVE
- **`trending_poc.json`** – 최근 업데이트된 PoC (자동 업데이트되는 README에서 가져옴)
- **`api/v1/`** – 완전한 REST 방식 JSON 엔드포인트:
  - `joined_top.json` – PoC, EPSS, KEV 상태가 포함된 우선순위 높은 CVE
  - `kev.json` – 강화된 KEV 목록
  - `epss_top.json` – PoC가 있는 상위 EPSS CVE
  - `cve/{CVE-ID}.json` – CVE별 상세 PoC 정보
  - `snapshots/` – 일일 상태 스냅샷
  - `diffs/` – 일별 변경 사항

검색은 **퍼지 매칭**, 벤더/제품 필터, 부정 용어(예: `-windows`)를 지원합니다.

---

## 🗂️ 프로젝트 구조```
Ch4120N-CVE-Pulse/
├── chCVEPulse.py
├── scripts/
│   ├── config.py
│   ├── helpers.py
│   ├── github_api.py
│   ├── scoring.py
│   ├── discovery.py
│   ├── outputs.py
│   ├── diff.py
│   ├── joined.py
│   ├── site.py
│   ├── sync.py
│   ├── fetch_epss.py
│   ├── fetch_kev.py
│   └── pipeline.py
├── templates/
│   └── index.html# Jinja2 template for the website
├── data/
│   ├── github.txt# CVE -> PoC URL list (edit this)
│   ├── blacklist.txt
│   ├── cache/
│   └── evidence/
├── docs/
│   ├── api/v1/
│   └── index.html, style.css, logic.js
├── requirements.txt
└── README.md

🔧 구성

거의 모든 설정은 scripts/config.py에 있습니다:

• GITHUB_SOURCES – data/github.txt 경로
• EPSS_API_URL, KEV_URL, CVE_API_TEMPLATE – 외부 API 엔드포인트
• HIGH_EPSS_THRESHOLD – "높음" 경고를 위한 최소 EPSS
• TOP_KEV_COUNT – 유지할 KEV 항목 수
• SNAPSHOT_RETENTION_DAYS – 이전 스냅샷을 보관할 기간

📡 데이터 소스

API 속도 제한을 높이려면 GitHub 토큰을 사용하는 것이 좋습니다 (GITHUB_TOKEN 환경 변수로 설정).

📅 자동화 (CI/CD)

세 가지 GitHub Actions 워크플로가 모든 것을 최신 상태로 유지합니다:

• sync_cve_pocs.yml – 매일 실행되며, data/github.txt를 읽고 최신 CVE 메타데이터를 가져와 마크다운 파일을 업데이트합니다.
• hot_cves.yml – 6시간마다 실행되며, 이 README의 Trending PoCs 섹션을 업데이트합니다.
• site.yml – 정적 웹사이트를 빌드하여 GitHub Pages에 배포합니다.

모든 워크플로는 .github/workflows/에 있습니다.

📈 Trending PoCs

아래의 Trending PoCs 표는 CI 파이프라인에 의해 6시간마다 자동으로 업데이트됩니다.

2026 (latest 20 of 584 repos)

2025 (latest 20 of 594 repos)

2024 (latest 20 of 636 repos)

2023 (latest 20 of 531 repos)

2022 (latest 20 of 560 repos)

⚠️ 면책 조항

이 프로젝트는 위협 인텔리전스, 취약점 관리, 방어적 보안 연구를 위해 만들어졌습니다.
불법적이거나 무단 활동에 링크된 저장소를 사용하지 마십시오.
저자는 PoC 코드를 호스팅하거나 보증하지 않으며, 단지 공개적으로 이용 가능한 정보를 색인할 뿐입니다.

📄 라이선스

GPLv3 라이선스 – 전문은 LICENSE 파일을 참조하십시오.