Vimal007Vimal/CyberNinja
GitHub: Vimal007Vimal/CyberNinja
CyberNinja 是一款通过用户名和电话号码跨多个平台进行快速侦察的 OSINT 开源情报工具,帮助调查人员追踪数字足迹。
Stars: 4 | Forks: 1
## 概述
CyberNinja 是一款专为数字调查员、安全研究员和隐私爱好者设计的强大 OSINT(开源情报)工具。它能够通过用户名跨多个社交媒体平台进行快速侦察,以追踪数字足迹。
## 功能
- 🚀 **极速**:跨数百个平台并发搜索
- 🛡️ **隐私优先**:内置 Tor 支持以进行匿名搜索
- 🔍 **全面覆盖**:跨主流社交网络、论坛和网站进行搜索
- 📱 **电话号码情报**:收集有关电话号码的信息,包括运营商、位置和关联服务
- 📊 **灵活输出**:支持以 JSON、CSV 或文本格式导出结果
- 🌐 **代理支持**:自定义代理配置以增强隐私
- 🔧 **高度可配置**:自定义超时、详细程度和搜索参数
- 🐳 **Docker 就绪**:通过容器化支持实现轻松部署
## 安装
```
# 克隆 repository
$ git clone https://github.com/omarkdev/cyberninja.git
# 导航到 project 目录
$ cd cyberninja
# 安装所需 dependencies
$ python3 -m pip install -r requirements.txt
```
## 用法
```
$ python3 cyberninja --help
usage: cyberninja [-h] [--version] [--verbose] [--folderoutput FOLDEROUTPUT]
[--output OUTPUT] [--tor] [--unique-tor] [--csv]
[--site SITE_NAME] [--proxy PROXY_URL] [--json JSON_FILE]
[--timeout TIMEOUT] [--print-all] [--print-found] [--no-color]
[--browse] [--local]
USERNAMES [USERNAMES ...]
CyberNinja: Advanced Social Media Intelligence Tool (Version 1.0.0)
positional arguments:
USERNAMES One or more usernames to investigate
optional arguments:
-h, --help Show this help message and exit
--version Display version information
--verbose, -v Enable detailed debugging output
--output OUTPUT Save results to specified file
--tor, -t Enable Tor routing for anonymous searching
--csv Export results in CSV format
--json JSON_FILE Load custom site data from JSON file
--timeout TIMEOUT Custom request timeout in seconds
```
### 基础示例
```
# 搜索单个 username
$ python3 cyberninja username123
# 搜索多个 username
$ python3 cyberninja user1 user2 user3
# 搜索 phone number 信息
$ python3 cyberninja --phone +1234567890
# 搜索带有 country code 的 phone number
$ python3 cyberninja --phone --country US 1234567890
# 启用 Tor routing 进行匿名搜索
$ python3 cyberninja --tor username123
# 导出 results 到 CSV
$ python3 cyberninja --csv --output results.csv username123
```
## 电话号码搜索
CyberNinja 包含强大的电话号码情报功能:
- **运营商信息**:识别电信运营商
- **位置数据**:获取与该号码相关的地理位置信息
- **号码类型**:确定其是移动电话、固定电话还是 VoIP
- **风险评估**:检查是否有垃圾电话或欺诈报告
- **关联服务**:查找关联的社交媒体和在线账户
- **历史数据**:查看过往的关联和使用模式
电话号码搜索输出示例:
```
📱 Phone Number Analysis: +1234567890
----------------------------------
✓ Carrier: Example Telecom
✓ Location: New York, United States
✓ Type: Mobile
✓ Time Zone: EST (UTC-5)
✓ Format: Valid International
```
## 模块
安装它
```
#pip install cyberninja
```

使用它
```
cyberninja user1 user2
```


## Docker
CyberNinja 可以使用 Docker 运行,以便于部署并保持跨平台的一致性。
```
# 构建 Docker image
$ docker build -t cyberninja .
# 在 container 中运行 CyberNinja
$ docker run -it cyberninja username123
```
拉取 Docker 镜像
```
$ docker pull vimald/cyberninja02:latest
```

#运行容器
```
$ docker run -it vimald/cyberninja02:latest username123
```

使用 Docker Compose:
```
$ docker-compose run cyberninja username123
```
Docker Hub 链接
[**vimald/cyberninja02:latest**](https://hub.docker.com/repository/docker/vimald/cyberninja02/general)
## 隐私与安全
CyberNinja 在设计时充分考虑了隐私保护:
- 所有请求均可通过 Tor 路由
- 支持自定义代理以增强匿名性
- 无数据收集或外部 API 依赖
- 仅进行本地结果存储
## 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 [LICENSE](LICENSE) 文件。
## 致谢
- 感谢所有帮助塑造 CyberNinja 的贡献者
- 特别感谢 OSINT 社区提供的宝贵反馈
- 由 CyberNinja 团队构建
标签:ESC4, OSINT, Python, 无后门, 社交媒体情报, 社工侦查, 请求拦截, 逆向工具