User Scanner

User Scanner 徽标

一个强大的二合一 OSINT 套件，专为深度邮箱与用户名情报分析而设计。

凭借 380+ 个扫描向量—包括 155+ 个邮箱集成站点和 225+ 个用户名平台—您可以在几秒钟内绘制数字足迹、分析目标行为、发掘兴趣点、获取用户名的完整元数据并验证账户注册情况。

💖 赞助商

超越账户枚举。 WebVetted 通过深度 OSINT 数据丰富、泄露情报、AI 分析和交互式身份图谱，将邮箱或用户名转化为完整的身份调查。
开始调查 →

✨ 主要功能

🔎 深度邮箱与用户名 OSINT： 跨 380+ 平台查询邮箱注册情况并执行高级用户名画像分析。
👤 丰富元数据抓取： 抓取头像、个人简介、粉丝数、UID 编号、卖家状态和账户属性。
🔀 交叉扫描与跳转引擎： 从初始扫描中挖掘用户名、个人资料链接和暴露的邮箱地址，自动跨次级目标向量进行跳转。
🛡️ Hudson Rock 信息窃取恶意软件泄露情报： 使用 --hudson 标志查询信息窃取型恶意软件泄露日志，用于高优先级目标关联。
⚡ 高吞吐并行引擎： 由 httpx 和 curl_cffi 驱动，通过自动 TLS 指纹模拟实现最大并发。
🔀 排列与别名生成器： 基于通配符生成用户名变体，以捕捉拼写仿冒或替代别名。
📂 多格式报告： 自动导出为 PDF（含头像照片）、JSON 和 CSV，便于管道集成。
🌐 高级代理跳转： 内置代理轮换，支持协议自动检测（http、socks5）和扫描前健康验证（--validate-proxies）。
🎨 自适应终端界面： 动态进度跟踪、自适应类别网格（-lu/-le）和清晰的状态报告。

🚀 安装

🐍 通过 PyPI（推荐）

# Upgrade pip and install user-scanner
python3 -m pip install --upgrade pip
pip install user-scanner

📦 虚拟环境设置

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\Activate.ps1

# Install package
pip install user-scanner

❄️ 通过 Nix（Linux 和 macOS）

# Run instantly without installing permanently
nix run github:kaifcodec/user-scanner/main -- --help

# Drop into a temporary shell with user-scanner active
nix shell github:kaifcodec/user-scanner/main

💻 使用指南

1. 基本用户名与邮箱扫描

在所有可用平台模块中扫描单个用户名或邮箱地址：

user-scanner -u johndoe             # Single username scan
user-scanner -e [email protected]   # Single email scan

2. 交叉扫描与跳转情报

邮箱扫描能证明账户存在，但很少能揭示用户名。--cross-scan 会从目标资料中挖掘暴露的用户名、个人资料链接和次要邮箱地址，并在所有匹配平台上进行多轮侦察跳转：

跳转方向	挖掘内容
`-e` → 用户名	邮箱注册资料上暴露的用户名或社交链接
`-u` → 用户名	目标社交资料中展示的次级别名
`-u` → 邮箱	目标个人资料页面上公布的公开邮箱地址
`-e` → 邮箱	初始邮箱资料暴露的次级地址

user-scanner -u johndoe --cross-scan                                  # Pivot from username scan
user-scanner -e [email protected] --cross-scan                        # Pivot from email scan
user-scanner -e [email protected] --cross-scan --cross-links verified # Platform-verified links only
user-scanner -u johndoe --cross-scan --cross-depth 2        # Follow links two hops deep

💡 有关置信度评分、链接分类规则和成本模型，请参阅 docs/CROSS_SCAN.md。

3. Hudson Rock 恶意软件泄露情报

检查目标用户名或邮箱地址是否已暴露在信息窃取型恶意软件感染日志中：

user-scanner -u johndoe --hudson             # Username malware log check
user-scanner -e [email protected] --hudson   # Email malware log check

🖼️ 要查看输出终端截图和可视化预览，请参阅 docs/EXAMPLES.md。

4. 定向类别与模块扫描

扫描特定类别或单个模块，或以自适应网格形式列出可用模块：

user-scanner -u johndoe -c dev                # Developer platforms only
user-scanner -e [email protected] -m github   # Single module check
user-scanner -u johndoe -m github,instagram   # Specific comma-separated modules

user-scanner -lu                              # List user categories & modules grid
user-scanner -le                              # List email categories & modules grid

5. 批量文件扫描

从输入文件中扫描多个目标（每行一个目标）：

user-scanner -uf usernames.txt   # Bulk username scan
user-scanner -ef emails.txt      # Bulk email scan

6. 报告导出、选项与代理

# Export results to PDF, JSON, or CSV
user-scanner -u johndoe -f pdf -o report.pdf
user-scanner -u johndoe -f json -o results.json

# Verbose URL reporting and show all results (including not found)
user-scanner -u johndoe -v --all

# Rotate proxies with pre-scan validation check
user-scanner -u johndoe -P proxies.txt --validate-proxies

📚 文档中心

浏览 docs/ 目录中的详细文档指南：

📋 CLI 标志参考 — 每个 CLI 标志和选项的完整说明。
🔀 交叉扫描与跳转指南 — 多轮交叉扫描侦察的深入指南。
🔀 模式语法指南 — 用于用户名生成的通配符和排列模式。
🐍 库模式指南 — 在您自己的脚本中以编程方式调用 Python 引擎。
🌐 代理与网络指南 — 代理轮换格式、健康检查和区域 VPN 故障排除。
🖼️ 媒体与输出图库 — 视频演示、终端录制和截图预览。

🐍 Python 库模式

将 User Scanner 引擎直接集成到您的 Python 脚本中：

import asyncio
from user_scanner.core import engine
from user_scanner.email_scan.shopping import etsy

async def main():
    # Engine validates target against module and returns Result object
    result = await engine.check(etsy, "[email protected]")
    print(result.to_json())

asyncio.run(main())