User Scanner

強力な 2-in-1 OSINTスイートです。深い Eメール／ユーザー名インテリジェンス を実現するために設計されました。

380以上のスキャンベクター（155以上のメール統合サイトと225以上のユーザー名プラットフォームを含む）により、デジタルフットプリントのマッピング、ターゲットの行動分析、興味の特定、ユーザー名の完全なメタデータ取得、アカウント登録の確認を数秒で行えます。

💖 スポンサー提供

アカウント列挙を超えて。 WebVettedはメールアドレスやユーザー名を、ディープOSINTエンリッチメント、侵害インテル、AI分析、インタラクティブなアイデンティティグラフを備えた完全な身元調査に変えます。
調査を開始する →

✨ 主な機能

• 🔎 ディープなメール／ユーザー名OSINT： メール登録情報を検索し、380以上のプラットフォームにわたって高度なユーザー名プロファイリングを実行。
• 👤 リッチなメタデータスクレイピング： アバター、自己紹介文、フォロワー数、UID、出品者ステータス、アカウント属性を取得。
• 🔀 クロススキャン＆ピボットエンジン： 初期スキャンからハンドル、プロフィールリンク、公開されたメールアドレスを抽出し、セカンダリのターゲットベクターへ自動的にピボット。
• 🛡️ Hudson Rock Infostealer侵害インテル： --hudson フラグを使用してインフォスティーラー型マルウェアの侵害ログを照会し、優先度の高いターゲットの関連付けを行います。
• ⚡ 高スループット並列エンジン： httpx と curl_cffi を基盤とし、自動TLSフィンガープリント偽装による最大限の並行処理を実現。
• 🔀 順列＆エイリアスジェネレーター： ワイルドカードベースのユーザー名バリエーション生成により、タイポスクワッティングや代替エイリアスを検出。
• 📂 マルチフォーマットレポート： パイプライン統合のため、PDF（プロフィール写真付き）、JSON、CSV への自動エクスポート。
• 🌐 高度なプロキシピボット： プロトコル自動検出（http、socks5）とスキャン前のヘルス検証（--validate-proxies）を備えた内蔵プロキシローテーション。
• 🎨 レスポンシブなターミナルUI： 動的な進行状況トラッキング、自己適応型カテゴリグリッド（-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 は、ターゲットのプロフィールから公開されたハンドル、プロフィールリンク、セカンダリのメールアドレスを抽出し、一致するすべてのプラットフォームにわたってマルチパス偵察へ自動的にピボットします：

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. バルクファイルスキャン

入力ファイルから複数のターゲットをスキャンします（1行に1ターゲット）：

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())

💡 完全なPython APIドキュメントとバッチカテゴリチェックの例については、docs/USAGE.md を参照してください。

💖 プロジェクトを支援する

Webプラットフォームは常に認証フローを更新しています。380以上のスキャンモジュールを維持するには、スイートを信頼性高く、サイバーセキュリティコミュニティに無料で提供し続けるための24時間体制のコミットメントが必要です。

user-scanner が手動でのピボット作業の何時間も節約してくれたり、調査を支援してくれたなら、プロジェクトへの支援を検討してください：

👉 GitHubでスポンサーになる

プロジェクトスポンサー

user-scanner の継続的な開発を支援してくださっている素晴らしいスポンサーに心から感謝します！

📜 コントリビューション

コミュニティからの貢献を歓迎します！ PRを開いたり、新しいスキャンモジュールを提出する前に、コントリビューションガイドライン をお読みください。

⚠️ 免責事項

このツールは、教育目的、許可されたセキュリティ研究、および防御的なOSINT調査のためにのみ提供されます。開発者は一切の責任を負わず、本ソフトウェアの導入によって生じた誤用、意図しない結果、または法的措置について責任を負いません。