pardhu45/HunterOSINT
GitHub: pardhu45/HunterOSINT
一款基于 Python 的多平台用户名开源情报扫描工具,支持并发检索并生成多格式报告。
Stars: 0 | Forks: 0
# HunterOSINT




HunterOSINT 是一款命令行开源情报 (OSINT) 工具,用于跨多个在线平台搜索用户名。它支持并发扫描,在简洁的 Rich 驱动终端界面中显示结果,并生成 **JSON**、**HTML** 和 **CSV** 格式的报告。
# 功能
- 多平台用户名扫描
- 并发扫描以更快获取结果
- Rich 终端界面
- 生成 JSON 报告
- 生成 HTML 报告
- 生成 CSV 报告
- 使用 JSON 配置平台定义
- 用户名校验
- 响应时间测量
- 轻量级且易于扩展
# 截图
## 横幅

## 扫描结果

## 生成的报告

## HTML 报告

## CSV 报告

# 安装说明
## 前置条件
在安装 HunterOSINT 之前,请确保您具备:
- Python 3.10 或更高版本
- Git
- 互联网连接
验证您的 Python 安装:
```
python --version
```
或
```
python3 --version
```
## Windows
### 1. 克隆仓库
```
git clone https://github.com/YOUR_GITHUB_USERNAME/HunterOSINT.git
```
### 2. 导航至项目目录
```
cd HunterOSINT
```
### 3. 创建虚拟环境
```
python -m venv .venv
```
### 4. 激活虚拟环境
**PowerShell**
```
.venv\Scripts\Activate.ps1
```
**命令提示符**
```
.venv\Scripts\activate.bat
```
### 5. 安装依赖
```
pip install -r requirements.txt
```
### 6. 运行 HunterOSINT
```
python hunterosint.py
```
## Linux
### 1. 克隆仓库
```
git clone https://github.com/YOUR_GITHUB_USERNAME/HunterOSINT.git
```
### 2. 导航至项目目录
```
cd HunterOSINT
```
### 3. 创建虚拟环境
```
python3 -m venv .venv
```
### 4. 激活虚拟环境
```
source .venv/bin/activate
```
### 5. 安装依赖
```
pip install -r requirements.txt
```
如果您的系统使用 `pip3`:
```
pip3 install -r requirements.txt
```
### 6. 运行 HunterOSINT
```
python3 hunterosint.py
```
# 验证安装
如果一切安装正确,您应该会看到:
```
╭────────────────────────────────────────────╮
│ HunterOSINT │
│ Multi-Platform Username Intelligence Tool │
│ Version 1.0.0 │
╰────────────────────────────────────────────╯
Available Modules
[1] Username Intelligence
[0] Exit
```
# 使用说明
启动应用程序:
```
python hunterosint.py
```
选择 Username Intelligence 模块:
```
Select Module > 1
```
输入用户名:
```
Enter Username > torvalds
```
HunterOSINT 将会:
- 校验用户名
- 扫描支持的平台
- 在终端中显示结果
- 自动生成报告
生成的报告将保存在:
```
output/
```
# 支持的平台
| 平台 | 状态 |
|----------|:------:|
| GitHub | ✅ |
| GitLab | ✅ |
| Reddit | ✅ |
| HackerOne | ✅ |
| Dev.to | ✅ |
| Docker Hub | ✅ |
| Kaggle | ✅ |
# 输出格式
HunterOSINT 会自动生成:
- JSON 报告
- HTML 报告
- CSV 报告
报告存储在 **output/** 目录中。
# 项目结构
```
HunterOSINT/
│
├── assets/
│ ├── banner.png
│ ├── scan_results.png
│ ├── reports.png
│ ├── html_report.png
│ └── csv_report.png
│
├── core/
│ ├── platform_scanner.py
│ ├── requester.py
│ ├── scanner.py
│ └── validator.py
│
├── modules/
│ └── username.py
│
├── platforms/
│ ├── github.json
│ ├── gitlab.json
│ ├── reddit.json
│ ├── hackerone.json
│ ├── devto.json
│ ├── dockerhub.json
│ └── kaggle.json
│
├── utils/
│ ├── console.py
│ ├── report.py
│ ├── html_report.py
│ └── csv_report.py
│
├── output/
├── hunterosint.py
├── menu.py
├── requirements.txt
├── README.md
├── LICENSE
└── .gitignore
```
# 已知的限制
部分平台实施了反机器人保护机制,例如 Cloudflare 或类似的安全机制。
当出现这种情况时,HunterOSINT 可能会返回:
```
UNKNOWN
```
而不是 `FOUND` 或 `NOT FOUND`。
# 路线图
## 版本 1.0.0
- [x] Username Intelligence
- [x] 并发扫描
- [x] Rich 终端界面
- [x] JSON 报告
- [x] HTML 报告
- [x] CSV 报告
- [x] 可配置的平台定义
## 未来计划
- [ ] 更多平台
- [ ] 改进的检测引擎
- [ ] 命令行参数
- [ ] 插件系统
- [ ] 导出为 PDF
- [ ] 异步扫描
- [ ] PyPI 包
- [ ] 自动化测试
# 贡献
欢迎贡献代码。
如果您想改进 HunterOSINT:
1. Fork 该仓库
2. 创建功能分支
3. 提交您的更改
4. 发起 Pull Request
对于重大更改,请先提一个 issue 来讨论您的提案。
# 许可证
本项目基于 **MIT License** 授权。
详情请参阅 `LICENSE` 文件。
标签:ESC4, Homebrew安装, OSINT, Python, 多平台扫描, 无后门, 逆向工具