HackUnderway/WhatsOSINT
GitHub: HackUnderway/WhatsOSINT
一款用于查询 WhatsApp 号码状态、头像等公开信息的 OSINT 工具，支持多种缓存策略以降低 API 调用成本。
Stars: 309 | Forks: 65
# WhatsOSINT
查看 WhatsApp 号码的数据，包括其状态、头像等。 🕵🏽♂️
# 🔑 API Key
获取你的 API key。
名称 | Key |
| ------------------- |-------------- |
| [Whatsapp 数据](https://rapidapi.com/airaudoeduardo/api/whatsapp-data1) | 🔑 (必需) |
- 选择免费方案。
获取 API key 后，你可以将其添加到 **.env** 文件中，将 **"Your_Api_Key"** 替换为你实际的 RapidAPI key 并保存更改。
# ⚙️ 检查模式（节省成本）
默认情况下，WhatsOSINT 在每次查询时都会进行完整的**实时**检查。你可以通过 `.env` 中的环境变量切换到成本更低的策略：
| `CHECK_MODE` | 作用 | 成本 |
| --- | --- | --- |
| `live` (默认) | 始终执行全新的实时 WhatsApp 检查 | 最高 |
| `cache_first` | 优先读取缓存数据库；仅当号码尚未被缓存时才回退到实时检查 | 中等 |
| `cache_only` | 仅读取缓存数据库，从不进行实时检查 | 最低 |
你还可以使用 `CHECK_PROVIDER` 选择传输方式：
| `CHECK_PROVIDER` | 主机 | 认证 |
| --- | --- | --- |
| `rapidapi` (默认) | RapidAPI 市场 | `RAPIDAPI_KEY` |
| `native` | 直连 `checkleaked.cc` endpoint | `NATIVE_API_KEY`（独立的非 RapidAPI 凭证） |
实现最低成本检查的 `.env` 示例：
```
RAPIDAPI_KEY=your_rapidapi_key
CHECK_MODE=cache_only
```
所有设置都是可选的 —— 省略它们将完全复现原有的实时检查行为。你还可以设置 `CHECK_TIMEOUT_SECONDS`（默认为 `60`）来限制请求在放弃前的等待时间。
# 支持的发行版
|发行版 | 版本检查 | 支持 | 状态 |
----------|-------|------|-------|
|Kali Linux| 2024.3| 是| 正常运行 |
|Parrot Security OS| 6.0| 是 | 正常运行 |
|Windows| 11 | 是 | 正常运行 |
|BackBox| 8.1 | 是 | 正常运行 |
|Arch Linux| 2024.06.01 | 是 | 正常运行 |
# 用法
```
git clone https://github.com/HackUnderway/WhatsOSINT.git
```
```
cd WhatsOSINT
```
```
python3 WhatsOSINT.py
```
# 依赖要求
```
pip install -r requirements.txt
```
# 开发 / 测试
安装开发工具并运行单元测试（所有 HTTP 均已被 mock —— 不需要 API key 或网络）：
```
pip install -r requirements-dev.txt
python -m pytest tests/ -v
```
# 支持
如有问题、Bug 或建议，请联系：info@hackunderway.com
# 许可证
- [x] WhatsOSINT 已获得许可。
- [x] 查看 [LICENSE](https://github.com/HackUnderway/WhatsOSINT#MIT-1-ov-file) 了解更多信息。
# 安全研究员
* Victor Bancayan - [@VictorBancayan](https://twitter.com/VictorBancayan) - (**[Hack Underway](https://www.instagram.com/hackunderway/) CEO**)
## 🔗 链接
```
Fanpage: https://www.facebook.com/HackUnderway
X: https://twitter.com/JeyZetaOficial
Web site: https://hackunderway.com
Youtube: https://www.youtube.com/@JeyZetaOficial
```
[](https://www.facebook.com/HackUnderway/)
## ☕️ 支持本项目
[](https://www.buymeacoffee.com/hackunderway)
来自 
使用 
编写，由 
倾注： Victor Bancayan
© 2025
# 🔑 API Key
获取你的 API key。
名称 | Key |
| ------------------- |-------------- |
| [Whatsapp 数据](https://rapidapi.com/airaudoeduardo/api/whatsapp-data1) | 🔑 (必需) |
- 选择免费方案。
获取 API key 后，你可以将其添加到 **.env** 文件中，将 **"Your_Api_Key"** 替换为你实际的 RapidAPI key 并保存更改。
# ⚙️ 检查模式（节省成本）
默认情况下，WhatsOSINT 在每次查询时都会进行完整的**实时**检查。你可以通过 `.env` 中的环境变量切换到成本更低的策略：
| `CHECK_MODE` | 作用 | 成本 |
| --- | --- | --- |
| `live` (默认) | 始终执行全新的实时 WhatsApp 检查 | 最高 |
| `cache_first` | 优先读取缓存数据库；仅当号码尚未被缓存时才回退到实时检查 | 中等 |
| `cache_only` | 仅读取缓存数据库，从不进行实时检查 | 最低 |
你还可以使用 `CHECK_PROVIDER` 选择传输方式：
| `CHECK_PROVIDER` | 主机 | 认证 |
| --- | --- | --- |
| `rapidapi` (默认) | RapidAPI 市场 | `RAPIDAPI_KEY` |
| `native` | 直连 `checkleaked.cc` endpoint | `NATIVE_API_KEY`（独立的非 RapidAPI 凭证） |
实现最低成本检查的 `.env` 示例：
```
RAPIDAPI_KEY=your_rapidapi_key
CHECK_MODE=cache_only
```
所有设置都是可选的 —— 省略它们将完全复现原有的实时检查行为。你还可以设置 `CHECK_TIMEOUT_SECONDS`（默认为 `60`）来限制请求在放弃前的等待时间。
# 支持的发行版
|发行版 | 版本检查 | 支持 | 状态 |
----------|-------|------|-------|
|Kali Linux| 2024.3| 是| 正常运行 |
|Parrot Security OS| 6.0| 是 | 正常运行 |
|Windows| 11 | 是 | 正常运行 |
|BackBox| 8.1 | 是 | 正常运行 |
|Arch Linux| 2024.06.01 | 是 | 正常运行 |
# 用法
```
git clone https://github.com/HackUnderway/WhatsOSINT.git
```
```
cd WhatsOSINT
```
```
python3 WhatsOSINT.py
```
# 依赖要求
```
pip install -r requirements.txt
```
# 开发 / 测试
安装开发工具并运行单元测试（所有 HTTP 均已被 mock —— 不需要 API key 或网络）：
```
pip install -r requirements-dev.txt
python -m pytest tests/ -v
```
# 支持
如有问题、Bug 或建议，请联系：info@hackunderway.com
# 许可证
- [x] WhatsOSINT 已获得许可。
- [x] 查看 [LICENSE](https://github.com/HackUnderway/WhatsOSINT#MIT-1-ov-file) 了解更多信息。
# 安全研究员
* Victor Bancayan - [@VictorBancayan](https://twitter.com/VictorBancayan) - (**[Hack Underway](https://www.instagram.com/hackunderway/) CEO**)
## 🔗 链接
```
Fanpage: https://www.facebook.com/HackUnderway
X: https://twitter.com/JeyZetaOficial
Web site: https://hackunderway.com
Youtube: https://www.youtube.com/@JeyZetaOficial
```
[](https://www.facebook.com/HackUnderway/)
## ☕️ 支持本项目
[](https://www.buymeacoffee.com/hackunderway)
来自 使用 编写，由 倾注： Victor Bancayan
© 2025标签：ESC4, OSINT, Python, WhatsApp, 安全规则引擎, 数据查询, 无后门, 逆向工具