TheSkullNetwork/skullscrape
GitHub: TheSkullNetwork/skullscrape
一款零配置的单文件 OSINT 工具，用于从目标网页快速提取邮箱、电话、社交媒体资料和外部链接等信息。
Stars: 0 | Forks: 0
# SkullScrape
SkullScrape 是一个单文件 OSINT 工具，旨在快速发现目标网页中的电子邮件、电话号码、社交媒体资料和外部链接。它配备了零配置依赖引导程序和自动 GitHub 更新功能，无需任何手动设置。
## 🌟 核心功能
- 🚀 **零配置引导程序：** 在启动时自动检测并安装所需的依赖项（`requests`、`beautifulsoup4`、`rich`）——无需使用 `requirements.txt` 或手动执行 `pip` 命令。
- 🔄 **自主 GitHub 更新：** 在启动时与 GitHub 主分支同步，无缝获取并安装最新的脚本版本。
- 🌐 **预运行连接测试：** 在执行网络请求之前验证活跃的互联网连接，以避免进程挂起。
- 🛡️ **稳健的输入清理：** 执行 TLD 和域名验证，并在输入格式错误时提供持续的回退提示。
- 📊 **灵活的数据导出：** 将提取到的情报直接导出为结构化的 `.log`、`.csv` 或 `.json` 格式。
- 🖥️ **跨平台兼容性：** 配置了强制的 UTF-8 标准输出，确保在 Windows PowerShell/CMD、macOS 和 Linux 终端上都能完整渲染。
- ⚡ **适应流水线的静默模式 (`-q`)：** 禁用交互式 UI 元素并输出原始 JSON 到 stdout，便于轻松集成到自动化工作流以及 `jq` 等工具中。
## ⚙️ 安装说明
克隆代码仓库并直接运行脚本。缺失的包会在执行时自动安装。
```
git clone https://github.com/theskullnetwork/skullscrape.git
cd skullscrape
python scraper.py
```
*(可选)* 在 Linux/macOS 上授予执行权限：
```
chmod +x scraper.py
```
## 💻 用法与示例
### 交互模式
不带参数启动以进入交互式控制台：
```
python scraper.py
```
### 命令行界面 (CLI)
使用标准标志以非交互方式运行，适用于 CI/CD 流水线或脚本：
```
# 基础单目标扫描
python scraper.py -u example.com
# 自动将扫描输出保存到 CSV，无需交互式提示
python scraper.py -u example.com --save -f csv
# 静默模式，将干净的 JSON 输出到 stdout
python scraper.py -u example.com -q
# 运行时不检查 GitHub 脚本更新
python scraper.py -u example.com --no-update
```
## 🚩 命令行参数
| 短标志 | 长标志 | 描述 |
| --- | --- | --- |
| `-u` | `--url` | 目标 URL（跳过交互式提示） |
| `-f` | `--format` | 输出文件格式：`log`、`json`、`csv` *(默认：`log`)* |
| | `--save` | 无需用户提示即可自动保存输出文件 |
| `-q` | `--quiet` | 抑制终端 UI 并向 stdout 输出原始 JSON |
| | `--no-update` | 启动时跳过自动 GitHub 发布版本检查 |
| `-h` | `--help` | 显示完整的帮助文档并退出 |
## 📁 输出目录结构
扫描日志会根据目标域名分类并存储在独立的文件夹中：
```
logs_example_com/
├── 20260721_120000.log
├── 20260721_120512.csv
└── 20260721_121045.json
```
### JSON 输出示例 Schema
```
{
"url": "[https://example.com](https://example.com)",
"elapsed_seconds": 0.38,
"title": "Example Domain",
"description": "Domain description metadata",
"emails": [
"contact@example.com"
],
"phones": [
"+1 (555) 019-2834"
],
"social": [
"[https://twitter.com/example](https://twitter.com/example)"
],
"links": [
"[https://external-resource.com](https://external-resource.com)"
]
}
```
## 📄 许可证
本软件为开源软件，基于 [MIT 许可证](LICENSE) 发布。
标签：ESC4, OSINT, Python, 无后门, 误配置预防, 逆向工具