BlackSpartan/email-recon
GitHub: BlackSpartan/email-recon
一款无需 API 密钥的轻量级电子邮件 OSINT 侦察工具,聚合泄露暴露、凭证风险判定、域名情报和邮件认证态势检查,支持批量组织级扫描。
Stars: 0 | Forks: 0
# email-recon
针对单个电子邮件地址的轻量级 OSINT 侦察工具。将数据泄露暴露、公开足迹和域名情报聚合到一份报告中 —— 作为一款完全基于免费 API 的工具构建(无需密钥)。
## 检查内容
| 模块 | 来源 | 备注 |
|----------------------|----------------------------------------|-------|
| 数据泄露暴露 | [XposedOrNot](https://xposedornot.com) `check-email` API | 免费,无需密钥,限制为 2 次请求/秒 |
| 数据泄露分析/风险 | XposedOrNot `breach-analytics` API | 风险评分、暴露的数据类型、密码强度 |
| 凭证判定 | 派生自泄露分析 | 标记泄露事件是否实际暴露了密码(对比仅暴露 PII),并将严重程度分级为 NONE/LOW/MEDIUM/HIGH/CRITICAL,同时提供建议操作 |
| Gravatar 足迹 | gravatar.com | 确认该地址是否拥有公开的头像/个人资料 |
| 域名情报 | DNS (MX) + WHOIS | 邮件提供商、注册商、域名年龄 |
| 电子邮件身份验证 | DNS (SPF/DMARC TXT, DKIM selector probe) | 防伪造态势;DKIM 检查是对常见 selector 名称的尽力探测,并非详尽无遗 |
## 安装
```
pip install -r requirements.txt
```
## 用法
```
python3 email_recon.py target@example.com
python3 email_recon.py target@example.com --json
python3 email_recon.py target@example.com --output report.txt
```
### 批量 / 组织扫描
扫描一份已知的组织电子邮件地址列表(每行一个),并获取聚合的暴露摘要,而不是个人报告:
```
python3 email_recon.py --batch-file staff_emails.txt
python3 email_recon.py --batch-file staff_emails.txt --json
python3 email_recon.py --batch-file staff_emails.txt --output org_report.txt
```
这**不会**发现某个域名下未知的员工电子邮件 —— XposedOrNot 真正的域名范围泄露搜索需要付费/经过验证的 API 密钥,这与本工具无密钥的设计相冲突。您需要提供地址列表(例如从您自己的目录中导出);该工具会针对每个地址检查免费的电子邮件端点,并将结果汇总到一份报告中:泄露计数、每个人的凭证暴露严重程度、整个组织中最常见的泄露来源,以及列表中每个唯一域名的 SPF/DMARC 态势。
每个地址需要消耗 2 次请求(check-email + breach-analytics),因此超过约 12 个地址的批量处理可能会触及免费层级 25 次/小时的上限 —— 该工具会提前警告您,并进行优雅降级(针对单个地址报错),而不是导致整个运行失败。
## 撰文注意事项
- XposedOrNot 免费层级的速率限制为每个 IP 2 次请求/秒、25 次/小时、100 次/天 —— 脚本在调用之间会进行短暂休眠,以保持在此限制之内。
- WHOIS 查询可能会根据 TLD 的 WHOIS 服务器而变得缓慢/不可靠;该工具会进行优雅降级并报告“Unknown”,而不是崩溃。
- 这完全基于免费、无需密钥、公开文档的 API 构建 —— 非常适合作为文章中“负责任的 OSINT”视角的论点。
- 可以提及/预告的潜在扩展功能:HIBP Pwned Passwords k-anonymity 检查、Have I Been Pwned 付费 API 集成、社交媒体用户名关联(例如通过 Sherlock),或对邮件服务器 IP 进行 Shodan 查询。
## 法律 / 道德声明
仅针对您拥有或获得明确授权进行调查的电子邮件地址运行此操作。泄露和足迹数据可能会暴露敏感的个人信息 —— 请谨慎处理结果。
标签:ESC4, OSINT, Python, 情报分析, 无后门, 电子邮件安全, 网络诊断, 逆向工具