User Scanner

User Scanner Logo

深いメールおよびユーザー名インテリジェンスのために設計された強力な2-in-1 OSINTスイート。

合計465以上のスキャンベクター—175以上のメール連携サイトと290以上のユーザー名プラットフォームを含む—により、デジタルフットプリントをマッピングし、ターゲットの行動を分析し、興味関心を明らかにし、ユーザー名の完全なメタデータを取得し、アカウント登録を数秒で検証できます。

💖 スポンサー

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

プロの調査員とアナリストのための包括的なOSINTプラットフォーム。 250以上のモジュールにわたるメール、電話番号、ユーザー名の逆引き検索。強力なツールでインテリジェンス収集を自動化します。
始める →

初心者向けのオープンソースイシューを見つけて、今日最初のプルリクエストを送りましょう。
始める →

✨ 主な機能

🔎 深いメールおよびユーザー名OSINT: メール登録の検索と、465以上のプラットフォームにわたる高度なユーザー名プロファイリングを実行します。
👤 リッチメタデータのスクレイピング: アバター、プロフィール説明、フォロワー数、UID番号、出品者ステータス、アカウント属性をスクレイピングします。
🔀 クロススキャンおよびピボットエンジン: 初回スキャンからハンドル、プロフィールリンク、露出したメールアドレスを抽出し、二次ターゲットベクターへ自動的にピボットします。
🤖 Model Context Protocol (MCP) サーバー: Claude Desktop、Cursor、Antigravity、LLM向けのネイティブAIエージェント統合により、自律的なOSINTスキャンと再帰的ピボットを実行します。
🛡️ 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

# Optional: Install with MCP Server support for AI agents
pip install "user-scanner[mcp]"

📦 仮想環境のセットアップ

# 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` → username	メールの登録プロフィールで露出しているハンドルまたはソーシャルリンク
`-u` → username	ターゲットのソーシャルプロフィール全体で宣伝されている二次エイリアス
`-u` → email	ターゲットのプロフィールページで公開されているメールアドレス
`-e` → email	初回メールプロフィールによって露出した二次アドレス

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

7. AIおよびLLMエージェント統合（MCPサーバー）

Model Context Protocol (MCP) を介して user-scanner をAIコーディングアシスタントやLLMプラットフォームに直接接続します。これにより、AIエージェント（Claude Desktop、Cursor、Antigravity、Open-WebUI）がハンドルやメールを自律的に調査し、露出したプロフィールにピボットし、デジタルフットプリントを分析できるようになります。

サーバーの起動

# Start the MCP server over standard I/O (stdio)
user-scanner-mcp

# Optional: Enable verbose logging to stderr
user-scanner-mcp -v

MCPクライアント設定

クライアント設定（例：claude_desktop_config.json または mcp_config.json）に user-scanner を追加します：

{
  "mcpServers": {
    "user-scanner": {
      "command": "user-scanner-mcp"
    }
  }
}

公開されているAIツール

ツール	説明	機能
`scan_username`	プラットフォーム全体にわたる深いユーザー名OSINTおよびプロフィールエンリッチメント	対象スキャン（`category`、`module`）、再帰的 `cross_scan`、プロキシ注入、ラウドネストグル
`scan_email`	プラットフォーム全体にわたる深いメール検証およびアカウント発見	ターゲットスコープ、自動リンクピボット（`cross_scan`）、カスタムプロキシ、ラウドネストグル
`list_available_modules`	動的カタログおよびモジュール発見	AIエージェントがサポートされているすべてのプラットフォームとカテゴリを動的に照会可能

📚 ドキュメントハブ

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