Statecraft Cyber Intelligence

一个从零构建的葡萄牙语威胁情报平台，作为个人蓝队项目。它聚合全球开源数据，并将其转化为技术简报、分类新闻、增强的 CVE 和结构化 IOC——全部为 PT-BR，持续更新。

网站： statecraftcyber.vercel.app

---

平台提供的内容

• 威胁简报 — 由 AI（Groq / LLaMA 3.3 70B）每小时生成的技术卡片，包含严重性、IOC、CVE 以及面向蓝队的直接建议
• CVE — 过去 72 小时的漏洞，包含 CVSS、EPSS、CISA KEV 以及按类型分类（代码执行、注入、缓冲区溢出等）
• 新闻 — 来自国际和巴西来源的 20 个 RSS 源（CISA、Krebs、Google Threat Intelligence、CERT.br、WeLiveSecurity Brasil 等），按威胁类型和地区分类。当用户打开一篇文章时，Statecraft AI 会按需丰富内容，生成一篇完整的 PT-BR 新闻报道。结果会缓存在 NewsCache 中，以便后续阅读时无需再次调用 LLM
• IOC 搜索 — 搜索从简报中提取的妥协指标，支持 IP、域名、哈希、URL 和电子邮件
• 健康端点 — /api/health 用于监控可用性和数据库完整性
• 关于 — 平台和数据管道的技术背景

---

技术栈

层级	技术
前端 / 后端	Next.js 16.2.6 (App Router)、TypeScript、Tailwind CSS v4
数据库	PostgreSQL (Neon) + Prisma 6
AI	Groq API (LLaMA 3.3 70B)
净化	isomorphic-dompurify + marked
威胁来源	NVD API、CISA KEV、OTX AlienVault、EPSS (FIRST.org)
新闻源	20 个国际和巴西 RSS 源
部署	Vercel（应用）+ cron-job.org（外部每小时调度器，Hobby 计划）

---

架构与数据管道

外部来源 (NVD, CISA KEV, OTX, RSS)
        │
        ▼
  cron-job.org → Vercel — 每小时执行 (Hobby plan)
  vercel.json 定义 schedule，以便未来迁移到 Pro 计划
        │
        ├── 收集新闻 (RSS feeds) → NewsCache (PostgreSQL)
        │
        └── 收集威胁 (NVD, CISA, OTX)
                │
                ▼
          Groq LLaMA 3.3 70B
          生成结构化简报 (标题、摘要、
          严重性、IOC、CVE、MITRE ATT&CK)
                │
                ▼
          简报 → PostgreSQL (status: published)
                │
                ├── 结构化 IOC → Ioc 表
                └── 通过 REST API 暴露 → 前端 (Next.js)

---

Prisma 模型

模型	描述
Briefing	由 AI 生成的完整简报，包含威胁元数据
Ioc	带索引的规范化妥协指标
NewsCache	来自 RSS 源的增强新闻
CronLog	cron 作业执行日志

---

本地设置

先决条件

• Node.js 20+
• PostgreSQL（或免费的 Neon 账户）
• API 密钥：Groq、NVD（可选）、OTX（可选）

安装

git clone https://github.com/ptkthg/statecraftcyber
cd statecraftcyber
npm install

环境变量

复制示例文件并填写变量：

cp .env.example .env

变量	描述
DATABASE_URL	带 ?sslmode=require 的 PostgreSQL 连接 URL
GROQ_API_KEY	Groq API 密钥 (groq.com)
NVD_API_KEY	NVD API 密钥 — 可选，没有密钥时速率限制更低
OTX_API_KEY	AlienVault OTX 密钥 — 可选
CRON_SECRET	用于验证 cron 调用的秘密令牌（header Authorization: Bearer）
ADMIN_SECRET	访问 /admin/status 面板的密码
AUTO_PUBLISH	true 表示自动发布简报
MAX_HOURLY_BRIEFINGS	每小时简报数量限制（默认：3）

数据库

# 创建表并应用迁移
npx prisma migrate dev

# 在浏览器中查看数据
npx prisma studio

开发

npm run dev

访问 http://localhost:3000。

生产构建

npm run build
npm start

---

有用的 Prisma 命令

# 在生产环境应用迁移（不生成迁移文件）
npx prisma migrate deploy

# 在 schema 更改后重新生成 Prisma Client
npx prisma generate

# 重置数据库（小心：删除所有数据）
npx prisma migrate reset

---

数据来源

来源	类型	端点
NVD (NIST)	CVE	services.nvd.nist.gov/rest/json/cves/2.0
CISA KEV	已被利用的漏洞	www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json
EPSS (FIRST.org)	利用评分	api.first.org/data/v1/epss
AlienVault OTX	IOC 和脉冲	otx.alienvault.com/api/v1
20x RSS feeds	新闻	CISA、Google Threat Intelligence、Cisco Talos、CERT.br、Elastic Security Labs 等

---

免责声明

威胁情报数据在任何关键生产操作之前，必须在主要来源中进行验证。

---

由 Patrick Santos 开发 — 安全分析师，蓝队。