README

User Scanner


  



  
  
  
     
  
  
     
  




  
    
  


---

A powerful 2-in-1 OSINT suite engineered for deep Email and Username Intelligence.

With 2720+ total scan vectors—including 210+ email-integrated sites and 2510+ username platforms—you can map digital footprints, analyze target behavior, uncover interests, full metadata of usernames and verify account registrations in seconds.

---

 💖 Sponsored by


  
    
  
  
  Go beyond account enumeration. WebVetted turns an email or username into a complete identity investigation with deep OSINT enrichment, breach intel, AI analysis, and an interactive identity graph.
  
  Start an Investigation →


---


  
    
  
  
  Comprehensive OSINT platform for professional investigators and analysts. Reverse email, phone number, and username search across 250+ modules. Automate your intelligence gathering with our powerful tools.
  
  Get Started →


---


  
    
  
  
  Get reliable proxies for web scraping and automation. Use promo code KAIF15 for 15% OFF!
  
  Get Started with 15% OFF →


---


  🔍 Looking for Phone Number OSINT? Check out our other project phonsint to uncover accounts, masked emails, and profile photos with zero SMS alerts. 
  Explore phonsint →


 ✨ Key Features

- 🔎 Deep Email & Username OSINT: Look up email registrations and perform advanced username profiling across 2710+ platforms.
- 👤 Rich Metadata Scraping: Scrapes avatars, bio descriptions, follower counts, UID numbers, seller statuses, and account attributes.
- 🔀 Cross-Scan & Pivot Engine: Mines handles, profile links, and exposed email addresses from initial scans, automatically pivoting across secondary target vectors.
- 🤖 Model Context Protocol (MCP) Server: Native AI agent integration for Claude Desktop, Cursor, Antigravity, and LLMs to run autonomous OSINT scans and recursive pivots.
- 🛡️ Hudson Rock Infostealer Breach Intel: Query infostealer malware breach logs using the --hudson flag for high-priority target correlation.
- ⚡ High-Throughput Parallel Engine: Powered by httpx and curl_cffi for maximum concurrency with automated TLS fingerprint impersonation.
- 🔀 Permutation & Alias Generator: Wildcard-based username variation generation to catch typosquatting or alternative aliases.
- 📂 Multi-Format Reports: Automated exports to PDF (with profile photos), JSON, and CSV for pipeline integration.
- 🌐 Advanced Proxy Pivoting: Built-in proxy rotation with protocol auto-detection (http, socks5) and pre-scan reachability check (--validate-proxies).
- 🎨 Responsive Terminal UI: Dynamic progress tracking, self-adaptive category grids (-lu/-le), and clear status reporting.

---

 🚀 Installation

 🐍 Via PyPI (Recommended)

bash
 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]"


 📦 Virtual Environment Setup

bash
 Create and activate virtual environment
python3 -m venv .venv
so