⚡ Ch4120N CVE Pulse

スマート検索と脅威インテリジェンスを備えたライブCVE PoCアグリゲーター

CVE Pulse は、GitHubから CVE Proof‑of‑Concepts を自動的に発見、スコアリング、インデックス化します。
EPSSスコア と CISA KEV データでそれらを強化し、日次の スナップショット＆差分 を構築し、高速で検索可能な 静的ウェブサイト を提供します

📋 目次

• 👨‍💻 プロジェクト作成者
• 🎯 機能概要
• ✨ 主な機能
• 🧱 アーキテクチャ
• ⚙️ 仕組み
• 🚀 クイックスタート
• 📦 インストール
• 💻 使用方法
  • サブコマンド
  • フルパイプライン
• 📊 出力とウェブサイト
• 🗂️ プロジェクト構成
• 🔧 設定
• 📡 データソース
• 📅 自動化 (CI/CD)
• 📈 トレンドPoC
• ⚠️ 免責事項
• 📄 ライセンス

👨‍💻 プロジェクト作成者

Ch4120N – セキュリティ愛好家＆自動化好き。
📧 [email protected]

🎯 機能概要

1. 最新のEPSSスコアとCISA Known Exploited Vulnerabilities (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のmarkdownファイルを作成/更新します。
4. pipeline（または個別の build-* コマンド）:
   • スキャン対象CVEの スコープ を構築します（github.txt または以前に低信頼度だったものから）。
   • GitHub検索APIを使用して、CVE IDに言及しているリポジトリを検索します。
   • GraphQLを介してリポジトリメタデータ（スター、言語、トピック）で候補を強化します。
   • 各リポジトリをスコアリングし、信頼度ティア（high、medium、low）を割り当てます。
   • 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 を 1 つ以上指定
- `--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)

3 つの GitHub Actions ワークフローがすべてを最新の状態に保ちます：

• sync_cve_pocs.yml – 毎日実行され、data/github.txt を読み込み、最新の CVE メタデータを取得して markdown ファイルを更新します。
• hot_cves.yml – 6 時間ごとに実行され、この README の Trending PoCs セクションを更新します。
• site.yml – 静的ウェブサイトをビルドし、GitHub Pages にデプロイします。

すべてのワークフローは .github/workflows/ にあります。

📈 Trending PoCs

以下の Trending PoCs テーブルは、CI パイプラインによって 6 時間ごとに自動更新 されます。

2026 (584 リポジトリのうち最新 20 件)

2025 (594 リポジトリのうち最新 20 件)

2024 (636 リポジトリのうち最新 20 件)

2023 (531 リポジトリのうち最新 20 件)

2022 (560 リポジトリのうち最新 20 件)

⚠️ 免責事項

このプロジェクトは 脅威インテリジェンス、脆弱性管理、および防御的セキュリティ研究 を目的としています。
リンクされたリポジトリを違法または不正な活動に使用しないでください。
作者は PoC コードをホストまたは推奨しておらず、公開されている情報をインデックス化しているだけです。

📄 ライセンス

GPLv3 ライセンス – 全文は LICENSE ファイルを参照してください。