
用于快速IOC分析(IP、域名、CVE)的Python CLI工具,使用6个免费威胁情报API。输出:彩色编码的Excel、JSON、CSV。使用:VT、Shodan、AbuseIPDB。
🚀 荣登官方 Awesome OSINT 仓库。
🧠 ThreatLens 的一项贡献被收录于 XERJ Corpus Hub。
ThreatLens 是一款单一命令行工具,统一了跨最受信赖的免费 OSINT 来源的威胁情报查询。无需将 IP 粘贴到五个不同的网站,ThreatLens 会并行查询所有来源,规范化结果,并给出清晰的判定——在终端中,或在一份精美、带颜色编码的 Excel/JSON/CSV 报告中。
专为 SOC 分析师、事件响应人员、威胁狩猎人员,以及任何希望无需离开 shell 即可快速、可靠地丰富 IOC 的人而构建。
|
为什么选择 ThreatLens
|
不适用于
|
| 功能 | 详情 |
|---|---|
| 🎯 IOC 类型 | IP、域名、URL、文件哈希(MD5 / SHA1 / SHA256)、CVE |
| 🔌 集成 API | AbuseIPDB、VirusTotal、AlienVault OTX、Shodan、URLScan.io、NVD、CISA KEV、EPSS |
| 📄 日志解析 | 从纯文本/日志文件中自动提取 IOC,并原生支持 Zeek、Suricata eve.json、Sysmon(JSON) 以及通用 JSONL |
| 🧭 CVE 决策卡片 | 针对每个 CVE 给出确定性、可解释的 修补 / 隔离 / 监控 / 不受影响 建议,依据 CISA KEV、EPSS、CVSS 以及关联的资产暴露情况 |
| 🗂️ 资产清单 | 导入包含主机/IP、关键性及互联网暴露状态的 CSV;与 CVE 结果进行关联 |
| 📤 SIEM 导出 | 可选导出至 Splunk HEC、Elastic _bulk 和 Microsoft Sentinel(现代日志摄取 API) |
| 🧾 证据包 | 将调查结果导出为 ZIP,并附带 SHA-256 清单,以实现基本的证据链 |
| 📊 报告 | Excel(彩色编码)、JSON、CSV |
| 💾 本地缓存 | 带可配置 TTL 的 SQLite 缓存——跳过对已知 IOC 的重复查询,另含缓存的 CISA KEV 数据源(24 小时 TTL) |
| 🔐 隐私控制 | 标准、被动、仅限已批准提供商和仅本地模式;在外部查询前移除敏感的 URL 查询参数 |
| 👁️ IOC 监控列表 | 带过期时间、手动扫描以及判定和风险信号变更跟踪的本地 SQLite 监控列表 |
| 🧠 调查记忆 | 搜索已保存的 IOC 观察记录,比较判定/来源历史,查找在先前调查中共同出现的 IOC,并管理本地保留/导出 |
| 🛡️ 安全 | 重定向阻止、主机允许列表、日志中的 API 密钥脱敏、电子表格公式中和、CSV/日志 DoS 限制 |
| 🔒 锁文件 | 带 SHA-256 哈希的 requirements.lock,用于可复现安装 |
| 💻 CLI 体验 | 丰富的进度条、彩色表格和清晰的判定摘要 |
| 🧩 架构 | 模块化的丰富器/解析器/导出器、类型化模型、严格的关注点分离 |
| ✅ 已测试 | 使用 pytest 的 192 个单元与集成测试;通过 GitHub Actions 进行 CI |
| ⚡ 弹性 | 单个 API 或 SIEM 目标失败绝不会阻塞其他目标——错误被隔离并记录 |
# 1. Clone & install
git clone https://github.com/AbdaullahAG/threatlens.git
cd threatlens
pip install -r requirements.txt
# 2. Configure your API keys
cp config/keys.env.example config/keys.env
# → edit config/keys.env and fill in your keys
# 3. Run your first scan
python main.py -i 45.33.32.156
💡 NVD(CVE 查询)开箱即用,无需 API 密钥。 其他所有 API 都提供免费套餐,注册时间不到 2 分钟——请参阅下方的 API 密钥。
pip install --require-hashes -r requirements.lock
| 基本的单 IOC 查询 |
| 在一次运行中混合搭配多种 IOC 类型 |
| 直接从原始日志进行批量调查 |
| 面向流水线的机器可读输出 |
| 将富化限制在选定的来源 |
| 单次运行输出 Excel + JSON + CSV |
| 通过 NIST NVD 进行 CVE 富化(免费,无需密钥) |
| 用于故障排查的完整请求/响应日志记录 |
| 修补 / 隔离 / 监控 / 不受影响建议 |
| SOC 日志摄取 → SIEM 导出 |
| 包含 SHA-256 清单的 ZIP,用于证据链 |
| 标志 | 描述 |
|---|---|
-i, --ip | 要调查的 IP 地址 |
-d, --domain | 要调查的域名 |
-s, --hash | 文件哈希 — MD5 / SHA1 / SHA256 |
-c, --cve | CVE ID,例如 CVE-2021-44228 |
--file | 用于自动提取 IOC 的日志/文本文件路径 |
--log-format | --file 的格式:auto(默认)| text | zeek | suricata | sysmon | jsonl |
--apis | 将富化限制为特定的一组 API(现在包括 cisa_kev、epss) |
--format | 输出格式:excel(默认)| json | csv | all |
--output | 保存报告的目录(默认:./output) |
--no-report | 仅将结果打印到终端;调查历史仍可能被存储 |
--import-assets | 导入资产清单 CSV(hostname/ip、criticality、internet_facing、owner、product) |
--decision-cards | 为每个 CVE 结果生成 Patch/Isolate/Monitor/Not-affected 卡片 |
--export | 将结果发送到一个或多个 SIEM 目标:splunk | elastic | sentinel(需主动启用,必须在 config/keys.env 中配置) |
--export-insecure-tls | 为 SIEM 导出禁用 TLS 验证(仅用于测试;会记录醒目警告) |
--evidence-pack | 将调查打包为带 SHA-256 清单的 ZIP |
--cache-path | 本地缓存的 SQLite 路径(默认:.threatlens/investigations.db) |
--cache-ttl | 缓存有效期(秒)(默认:3600) |
--no-cache | 绕过 IOC 结果和提供商源缓存;历史和资产清单不受影响 |
--no-history | 不将本次运行保存到本地调查历史 |
--privacy-mode | 外部查询策略:standard | passive | approved-only | local-only |
--approved-apis | approved-only 模式所需的提供商允许列表(若提供,则与 --apis 合并) |
--privacy-preview | 在富化前显示原始和脱敏的 IOC、提供商及目标 |
--watchlist-add | 将提供的 IOC 添加到本地监视列表 |
--watchlist-list | 列出活跃的本地监视列表条目 |
--watchlist-remove | 从监视列表中移除一个或多个 TYPE:VALUE 条目 |
--watchlist-scan | 扫描活跃的监视列表条目并显示自上次存储观察以来的变化 |
--watchlist-ttl-days | 添加时监视列表的过期时间(1-3650 天;默认:90) |
--history-list | 列出最近保存的观察记录;可与历史过滤器组合使用 |
--history-search QUERY | 搜索已保存的 IOC 值和提供商名称 |
--history-ioc TYPE:VALUE | 显示单个 IOC 的已保存判定时间线和共现 IOC |
--history-type / --history-verdict / --history-severity | 按 IOC 类型、判定或 CVE 严重性过滤本地历史 |
--history-after / --history-before | 按包含的 ISO 日期或时间戳过滤本地历史 |
--history-limit | 将历史结果限制为 1-500 条观察记录(默认:50) |
--history-export PATH | 将匹配的历史导出为脱敏 JSON 到新文件 |
--history-delete ID | 按 UUID 删除一次调查及其历史索引 |
--history-prune-days DAYS | 显式删除早于指定天数的调查(1-36500 天) |
--max-requests | 每次运行的外部 API 调用上限(默认:250) |
--max-iocs | 每次运行的最大唯一 IOC 数(默认:1000) |
--allow-private-iocs | 允许私有/回环 IP(默认禁用) |
--delay | API 调用之间的延迟,用于速率限制调优 |
-v, --verbose | 启用调试日志记录 |
ThreatLens 可以超越 IOC 查询,进入轻量级 CVE 分诊和日志摄取: