About this project

User Scanner is a powerful command-line OSINT tool designed for deep email and username intelligence gathering. It provides 1080+ actively maintained scan vectors — 200+ email-integrated sites and 880+ username platforms — enabling security researchers and investigators to map digital footprints, analyze target behavior, and verify account registrations. Key capabilities include rich metadata scraping (avatars, bios, follower counts, UIDs), a cross-scan and pivot engine that mines handles, profile links, and exposed emails from initial results for multi-pass reconnaissance, and native Model Context Protocol (MCP) server integration for AI agents like Claude Desktop and Cursor to run autonomous OSINT scans. It also queries Hudson Rock infostealer malware breach logs for high-priority target correlation. The tool uses a high-throughput parallel engine powered by httpx and curl_cffi with automated TLS fingerprint impersonation. It supports wildcard-based username permutation generation, multi-format exports (PDF with profile photos, JSON, CSV), advanced proxy rotation with health validation, and a responsive terminal UI with dynamic progress tracking and adaptive category grids. Installation is available via PyPI (pip install user-scanner), Nix, or virtual environments. Usage covers basic scans, cross-scan pivoting, Hudson Rock breach checks, targeted category/module scanning, bulk file processing, and report exports. A Python library mode allows programmatic integration. Comprehensive documentation covers CLI flags, cross-scan guides, pattern syntax, library usage, proxy configuration, and output examples.