FootprintHunter 是一款轻量级、零外部依赖的跨平台数字足迹侦察引擎。只需输入一个用户名,即可在 200+ 个主流平台上自动检测该用户名是否已被注册,快速绘制目标用户的数字足迹画像。

🎯 解决的痛点:

• 安全研究人员需要快速了解一个用户名在多个平台上的存在情况
• 开源情报(OSINT)分析中需要批量检测用户名占用
• 品牌方需要监控用户名是否被恶意抢注
• 现有工具(如 Maigret)依赖大量第三方库,安装配置复杂

✨ 自研差异化亮点:

• 🚫 零外部依赖 — 仅使用 Python 标准库,无需 pip install 任何第三方包
• ⚡ 异步并发 — 内置智能并发控制和速率限制,检测速度快
• 🌍 200+ 平台覆盖 — 社交媒体、开发者平台、视频、音乐、游戏、安全等 21 个分类
• 📊 多格式报告 — 支持 JSON / Markdown / HTML / CSV 四种报告格式
• 🔧 YAML 自定义站点 — 支持用户自行扩展检测站点
• 🌐 代理支持 — 支持 HTTP/HTTPS 代理,适应各种网络环境
• 🇨🇳 中国平台覆盖 — 内置微博、知乎、CSDN、掘金、Gitee、B站等国内平台

环境要求: Python 3.8+(无需安装任何第三方依赖)

# 克隆仓库
git clone https://github.com/gitstq/FootprintHunter.git
cd FootprintHunter
# 直接运行(无需安装依赖!)
python src/cli.py hunt <用户名>
# 示例:检测用户名 johndoe
python src/cli.py hunt johndoe

# 检测单个用户名
python src/cli.py hunt johndoe
# 指定分类检测
python src/cli.py hunt johndoe --categories "Social Media" "Developer"
# 指定特定站点检测
python src/cli.py hunt johndoe --sites github twitter reddit
# 使用代理
python src/cli.py hunt johndoe --proxy http://127.0.0.1:7890
# 自定义超时和并发
python src/cli.py hunt johndoe --timeout 15 --concurrency 30 --rate-limit 20

# 生成所有格式报告
python src/cli.py hunt johndoe --output ./results
# 指定报告格式
python src/cli.py hunt johndoe --output ./results --format json html markdown
# 静默模式(仅保存文件,不输出终端)
python src/cli.py hunt johndoe --output ./results --quiet

# 查看所有支持的站点
python src/cli.py list
# 按分类查看站点
python src/cli.py list --category Developer
# 查看所有分类
python src/cli.py categories

# 使用自定义站点配置文件
python src/cli.py hunt johndoe --custom-sites sites/custom_sites.yaml

设计理念: 以"零依赖、开箱即用"为核心理念,让安全研究人员和开发者无需配置复杂环境即可快速进行用户名侦察。

技术选型原因:

• 选择 Python 标准库(urllib + asyncio)替代 requests/aiohttp,实现真正的零依赖
• 使用线程池 + asyncio 混合模式,兼顾并发性能和代码简洁性
• 内置 SSL 上下文配置,适应各种网络环境

后续迭代计划:

• 增加 GUI 图形界面版本
• 支持从 Sherlock/Maigret 导入站点配置
• 增加头像指纹匹配功能
• 支持批量用户名检测
• 增加 API 服务模式

欢迎贡献代码!请遵循以下步骤:

1. Fork 本仓库
2. 创建功能分支:git checkout -b feat/your-feature
3. 提交更改:git commit -m 'feat: 添加某功能'
4. 推送分支:git push origin feat/your-feature
5. 提交 Pull Request

提交规范: 使用 Angular 提交规范(feat/fix/docs/refactor)

本项目基于 MIT License 开源。

FootprintHunter 是一款輕量級、零外部依賴的跨平台數位足跡偵察引擎。只需輸入一個使用者名稱,即可在 200+ 個主流平台上自動偵測該使用者名稱是否已被註冊,快速繪製目標使用者的數位足跡畫像。

🎯 解決的痛點:

• 安全研究人員需要快速了解一個使用者名稱在多個平台上的存在情況
• 開源情報(OSINT)分析中需要批量偵測使用者名稱佔用
• 品牌方需要監控使用者名稱是否被惡意搶註
• 現有工具依賴大量第三方函式庫,安裝配置複雜

✨ 自研差異化亮點:

• 🚫 零外部依賴 — 僅使用 Python 標準函式庫,無需 pip install 任何第三方套件
• ⚡ 非同步並發 — 內建智慧並發控制和速率限制,偵測速度快
• 🌍 200+ 平台覆蓋 — 社群媒體、開發者平台、影片、音樂、遊戲、安全等 21 個分類
• 📊 多格式報告 — 支援 JSON / Markdown / HTML / CSV 四種報告格式
• 🔧 YAML 自訂站點 — 支援使用者自行擴展偵測站點
• 🌐 代理支援 — 支援 HTTP/HTTPS 代理,適應各種網路環境
• 🇨🇳 中國平台覆蓋 — 內建微博、知乎、CSDN、掘金、Gitee、B站等國內平台

環境需求: Python 3.8+(無需安裝任何第三方依賴)

# 克隆倉庫
git clone https://github.com/gitstq/FootprintHunter.git
cd FootprintHunter
# 直接運行(無需安裝依賴!)
python src/cli.py hunt <使用者名稱>
# 範例:偵測使用者名稱 johndoe
python src/cli.py hunt johndoe

# 偵測單個使用者名稱
python src/cli.py hunt johndoe
# 指定分類偵測
python src/cli.py hunt johndoe --categories "Social Media" "Developer"
# 指定特定站點偵測
python src/cli.py hunt johndoe --sites github twitter reddit
# 使用代理
python src/cli.py hunt johndoe --proxy http://127.0.0.1:7890
# 自訂逾時和並發
python src/cli.py hunt johndoe --timeout 15 --concurrency 30 --rate-limit 20

# 產生所有格式報告
python src/cli.py hunt johndoe --output ./results
# 指定報告格式
python src/cli.py hunt johndoe --output ./results --format json html markdown
# 靜默模式(僅儲存檔案,不輸出終端)
python src/cli.py hunt johndoe --output ./results --quiet

# 查看所有支援的站點
python src/cli.py list
# 按分類查看站點
python src/cli.py list --category Developer
# 查看所有分類
python src/cli.py categories

歡迎貢獻程式碼!請遵循以下步驟:

1. Fork 本倉庫
2. 建立功能分支:git checkout -b feat/your-feature
3. 提交變更:git commit -m 'feat: 新增某功能'
4. 推送分支:git push origin feat/your-feature
5. 提交 Pull Request

提交規範: 使用 Angular 提交規範(feat/fix/docs/refactor)

本專案基於 MIT License 開源。

FootprintHunter is a lightweight, zero-dependency cross-platform digital footprint reconnaissance engine. Simply enter a username to automatically detect whether it's registered across 200+ major platforms, quickly mapping a user's digital footprint.

🎯 Problems Solved:

• Security researchers need to quickly check username existence across multiple platforms
• OSINT analysts need batch username detection capabilities
• Brand protection teams need to monitor username squatting
• Existing tools (like Maigret) require many third-party dependencies, making setup complex

✨ Key Differentiators:

• 🚫 Zero External Dependencies — Uses only Python standard library, no pip install needed
• ⚡ Async Concurrent Engine — Built-in smart rate limiting and concurrency control
• 🌍 200+ Platform Coverage — 21 categories: social media, developer, video, music, gaming, security, etc.
• 📊 Multi-format Reports — JSON / Markdown / HTML / CSV output formats
• 🔧 YAML Custom Sites — Extensible site detection via YAML configuration
• 🌐 Proxy Support — HTTP/HTTPS proxy support for various network environments
• 🇨🇳 Chinese Platform Coverage — Weibo, Zhihu, CSDN, Juejin, Gitee, Bilibili, etc.

Requirements: Python 3.8+ (no third-party dependencies needed)

# Clone the repository
git clone https://github.com/gitstq/FootprintHunter.git
cd FootprintHunter
# Run directly (no dependencies to install!)
python src/cli.py hunt <username>
# Example: detect username johndoe
python src/cli.py hunt johndoe

# Detect a single username
python src/cli.py hunt johndoe
# Filter by categories
python src/cli.py hunt johndoe --categories "Social Media" "Developer"
# Filter by specific sites
python src/cli.py hunt johndoe --sites github twitter reddit
# Use a proxy
python src/cli.py hunt johndoe --proxy http://127.0.0.1:7890
# Custom timeout and concurrency
python src/cli.py hunt johndoe --timeout 15 --concurrency 30 --rate-limit 20

# Generate all report formats
python src/cli.py hunt johndoe --output ./results
# Specify report formats
python src/cli.py hunt johndoe --output ./results --format json html markdown
# Quiet mode (save files only, no terminal output)
python src/cli.py hunt johndoe --output ./results --quiet

# List all supported sites
python src/cli.py list
# List sites by category
python src/cli.py list --category Developer
# List all categories
python src/cli.py categories

# Use a custom sites configuration file
python src/cli.py hunt johndoe --custom-sites sites/custom_sites.yaml

Design Philosophy: "Zero dependencies, ready to use" — enabling security researchers and developers to perform username reconnaissance without complex environment setup.

Technical Choices:

• Python standard library (urllib + asyncio) instead of requests/aiohttp for true zero-dependency
• Thread pool + asyncio hybrid model for balanced concurrency and code simplicity
• Built-in SSL context configuration for various network environments

Roadmap:

• GUI interface version
• Import sites from Sherlock/Maigret
• Avatar fingerprint matching
• Batch username detection
• API service mode

Contributions are welcome! Please follow these steps:

1. Fork this repository
2. Create a feature branch: git checkout -b feat/your-feature
3. Commit your changes: git commit -m 'feat: add some feature'
4. Push to the branch: git push origin feat/your-feature
5. Submit a Pull Request

Commit Convention: Use Angular commit convention (feat/fix/docs/refactor)

This project is licensed under the MIT License.