xdrew87/PhantomTrace
GitHub: xdrew87/PhantomTrace
一款面向合法 OSINT 研究的 Python 模块化 CLI 框架,用于聚合多源公开情报并生成可导出报告。
Stars: 1 | Forks: 0
# 🔍 PhantomTrace




🌐 **[osintintelligence.xyz/phantomtrace](https://osintintelligence.xyz/phantomtrace.php)** — 官方页面与专业版
**PhantomTrace** 是一个专业、模块化的 OSINT(开源情报)CLI 框架,用于收集有关个人和数字资产的公开情报。它使用 Python 和 Rich 构建,旨在提供简洁、生产级别的体验。
## 截图
### 主菜单


### 用户名查询

### IP 查询结果


### HTML 报告导出

## 功能
- **用户名查询** — 在 50 多个平台上搜索用户名是否存在
- **邮箱情报** — 泄露检测 (HIBP)、MX 记录、域名分析
- **IP 查询** — 通过 FrostedServices GeoIP + ip-api.com 进行地理定位,ASN、ISP、代理/VPN 检测
- **手机号查询** — 通过 `phonenumbers` + 可选的 NumVerify 查询运营商、地区、线路类型
- **域名查询** — WHOIS、DNS (A/MX/NS/TXT/SOA/CNAME)、HTTP 标头
- **社交媒体扫描** — 在 15 个主要平台上发现公开个人资料
- **全面档案扫描** — 针对单个目标运行所有模块
- **报告导出** — 将 JSON 和样式化的 HTML 报告保存在本地
- **评分系统** — 为每个模块提供风险/档案完整度评分
- **活动日志** — 所有会话均记录到 `logs/` 中
## 安装说明
```
git clone https://github.com/xdrew87/PhantomTrace.git
cd PhantomTrace
pip install -r requirements.txt
cp config/.env.example config/.env
# 编辑 config/.env 以配置你的可选 API keys
python main.py
```
## 配置说明
该工具**无需任何 API 密钥**即可运行 — 配置密钥可解锁更多数据源。
将 `config/.env.example` 复制到 `config/.env`,并根据需要添加密钥:
| 变量 | 服务 | 备注 |
|---|---|---|
| `HIBP_API_KEY` | HaveIBeenPwned | 邮箱泄露查询 |
| `NUMVERIFY_API_KEY` | NumVerify | 增强的手机号数据 |
| `HUNTER_API_KEY` | Hunter.io | 邮箱验证 |
IP 地理定位使用内置的 [FrostedServices GeoIP API](https://frostedservices.xyz/api/geoip/) — 无需密钥。
## 使用说明
```
python main.py
```
从交互式菜单中选择模块。结果将以格式化的表格显示,并可选择导出到 `reports/`。
## 项目结构
```
PhantomTrace/
├── main.py # Entry point & CLI menu
├── modules/ # OSINT modules (one per data type)
│ ├── username_lookup.py
│ ├── email_intel.py
│ ├── ip_lookup.py
│ ├── phone_lookup.py
│ ├── domain_lookup.py
│ └── social_media.py
├── utils/ # Helpers: API, logging, formatting, reporting
├── config/ # Settings & API key configuration
├── reports/ # Exported reports (JSON & HTML)
└── logs/ # Activity logs
```
## 免责声明
PhantomTrace 仅用于**合法的 OSINT 研究** — 适用于经过适当授权的渗透测试人员、安全研究人员、记者和调查员。作者对任何滥用行为不承担责任。
## 许可证
MIT — 详见 [LICENSE](LICENSE)
标签:CLI工具, ESC4, GitHub, OSINT, Python, 信息收集, 实时处理, 开源情报, 无后门, 网络调查