anubhavmohandas/CyberTrace
GitHub: anubhavmohandas/CyberTrace
一款多层 OSINT 调查框架，能够自动识别输入类型并在表网、深网和暗网中进行综合搜索，帮助安全人员高效收集和分析目标的数字足迹。
Stars: 0 | Forks: 0
# CyberTrace
多层 OSINT 调查工具 - 同时搜索表网、深网和暗网。
## 功能
- **自动检测**输入类型（电子邮件、电话、用户名、域名、比特币、印度身份证件）
- 区块链分析（公开数据）具有 **95% 的可靠性**
- 用户名枚举（通过 Maigret 在 2500+ 个网站上）具有 **90% 的可靠性**
- 域名情报（WHOIS、DNS、crt.sh）具有 **85% 的可靠性**
- 电子邮件 OSINT 和暗网搜索具有 **70% 的可靠性**
- 印度特定数据库（MCA、GST、eCourts、Indian Kanoon）
## 安装
```
# 克隆仓库
git clone https://github.com/anubhavmohandas/cybertrace.git
cd cybertrace
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate
# 安装 CyberTrace
pip install -e .
# 安装可选 OSINT 工具
pip install maigret sherlock-project holehe
```
## 快速入门
```
# 自动检测输入类型并搜索
cybertrace search "user@example.com"
# 搜索特定类型
cybertrace search "hackerman123" --type username
# 输出为 JSON
cybertrace search "example.com" --output json
# 保存结果到文件
cybertrace search "1A1zP1..." --save report.json
# Rich 彩色输出
cybertrace search "MH12AB1234" --output rich
```
## 模块
| 模块 | 成功率 | 描述 |
|--------|--------------|-------------|
| bitcoin | 95% | 区块链分析（BTC、ETH） |
| username | 90% | 用户名枚举（3000+ 个网站） |
| domain | 85% | WHOIS、DNS、SSL、子域名 |
| email | 70% | Gravatar、Holehe、GitHub 提交 |
| darkweb | 70% | Ahmia、DarkSearch（表网） |
| indian | 60-70% | MCA、GST、eCourts、车辆查询 |
## 配置
创建 `.env` 文件配置 API 密钥（可选，可增强结果）：
```
cp .env.example .env
# 使用您的 API 密钥编辑 .env
```
可改善结果的免费 API 密钥：
- VirusTotal (500/天)：https://virustotal.com
- Shodan (100/月)：https://shodan.io
- URLScan (5000/天)：https://urlscan.io
- GitHub (5000/小时)：https://github.com/settings/tokens
- EmailRep (100/天)：https://emailrep.io
## CLI 命令
```
# 主搜索命令
cybertrace search TARGET [OPTIONS]
# 快捷命令
cybertrace email EMAIL
cybertrace username USERNAME
cybertrace domain DOMAIN
cybertrace btc ADDRESS
cybertrace indian TARGET
# 配置
cybertrace config --check # Check API key status
cybertrace modules # List available modules
```
## 输入类型
CyberTrace 会自动检测以下输入类型：
| 输入 | 示例 | 模块 |
|-------|---------|--------|
| 电子邮件 | user@example.com | email |
| 电话（印度） | +919876543210 | phone |
| 用户名 | hackerman123 | username |
| 域名 | example.com | domain |
| 比特币 | 1A1zP1eP5Q... | bitcoin |
| 以太坊 | 0x742d35Cc... | bitcoin |
| 车辆（印度） | MH12AB1234 | indian |
| PAN（印度） | ABCDE1234F | indian |
| GSTIN | 22AAAAA0000A1Z5 | indian |
## 法律声明
CyberTrace 仅访问**公开可用的**信息。它不会：
- 入侵系统
- 绕过身份验证
- 访问私有数据库
- 拦截通信
请负责任地将其用于合法的 OSINT 研究。
## 文档
获取完整的技术文档，包括：
- 架构概述
- 模块 API 参考
- 开发指南
- 故障排除
请参阅 [docs/TECHNICAL_DOCUMENTATION.md](docs/TECHNICAL_DOCUMENTATION.md)
## 测试
```
# 运行测试套件
pytest tests/ -v
# 快速测试
python -m cybertrace search "MH12AB1234" --output json
```
## 许可证
MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
标签：Ask搜索, DNS分析, ESC4, GitHub, GitHub安全工具, Holehe, Maigret, OSINT, Sherlock, VirusTotal, WHOIS查询, 区块链分析, 协议探测, 印度数据库, 域名情报, 威胁情报, 实时处理, 开发者工具, 数字足迹分析, 文档结构分析, 暗网搜索, 比特币追踪, 深度网络, 用户名枚举, 网络安全, 表层网络, 赛博追踪, 逆向工具, 邮箱侦察, 隐私保护