kaifcodec/user-scanner🕵️♂️ (2-in-1) Email & Username OSINT suite for deep data extraction just from a single Email/Username. Analyzes 400+ actively maintained scan vectors (170+ email / 230+ username) for security research, investigations, and digital footprinting.
A powerful 2-in-1 OSINT suite engineered for deep Email and Username Intelligence.
With 380+ total scan vectors—including 155+ email-integrated sites and 225+ username platforms—you can map digital footprints, analyze target behavior, uncover interests, full metadata of usernames and verify account registrations in seconds.
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 →
--hudson flag for high-priority target correlation.httpx and curl_cffi for maximum concurrency with automated TLS fingerprint impersonation.http, socks5) and pre-scan health validation (--validate-proxies).-lu/-le), and clear status reporting.# 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
# 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
Scan a single username or email address across all available platform modules:
user-scanner -u johndoe # Single username scan
user-scanner -e [email protected] # Single email scan
An email scan proves an account exists but rarely reveals a handle. --cross-scan mines exposed handles, profile links, and secondary email addresses from target profiles, pivoting into multi-pass reconnaissance across all matching platforms:
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
💡 For confidence scoring, link classification rules, and cost models, see docs/CROSS_SCAN.md.
Check if a target username or email address has been exposed in infostealer malware infection logs:
user-scanner -u johndoe --hudson # Username malware log check
user-scanner -e [email protected] --hudson # Email malware log check
🖼️ To view output terminal screenshots and visual previews, see docs/EXAMPLES.md.
Scan specific categories or individual modules, or list available modules in a responsive grid:
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
Scan multiple targets from an input file (one target per line):
user-scanner -uf usernames.txt # Bulk username scan
user-scanner -ef emails.txt # Bulk email scan
# 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
Explore detailed documentation guides in the docs/ directory:
Integrate the User Scanner engine directly into your Python scripts:
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())
💡 For complete Python API documentation and batch category checking examples, see docs/USAGE.md.
Web platforms constantly update authentication flows. Maintaining over 380+ scan modules requires around-the-clock commitment to keep the suite reliable and free for the cybersecurity community.
If user-scanner has saved you hours of manual pivoting or aided your investigations, consider supporting the project:
Huge thanks to our amazing sponsors who support the ongoing development of user-scanner!
We welcome community contributions! Please read our Contributing Guidelines before opening a PR or submitting new scan modules.
This tool is provided strictly for educational purposes, authorized security research, and defensive OSINT investigations. The developers assume no liability and are not responsible for any misuse, unintended consequences, or legal actions resulting from the deployment of this software.
| Pivot Direction | What it Mines |
|---|
-e → username | Handles or social links exposed on an email's registered profile |
-u → username | Secondary aliases advertised across target social profiles |
-u → email | Public email addresses published on target profile pages |
-e → email | Secondary addresses exposed by initial email profiles |
@soxoj |
@hienyimba |
@InDieTasten |