User Scanner

User Scanner Logo

Discord

kaifcodec%2Fuser-scanner | Trendshift

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.

💖 Sponsored by

WebVetted Sponsor Banner
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 →

✨ Key Features

  • 🔎 Deep Email & Username OSINT: Look up email registrations and perform advanced username profiling across 380+ 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.
  • 🛡️ 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 health validation (--validate-proxies).
  • 🎨 Responsive Terminal UI: Dynamic progress tracking, self-adaptive category grids (-lu/-le), and clear status reporting.

🚀 Installation

🐍 Via PyPI (Recommended)

# Upgrade pip and install user-scanner
python3 -m pip install --upgrade pip
pip install user-scanner

📦 Virtual Environment Setup

# 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

❄️ Via 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

💻 Usage Guide

1. Basic Username & Email Scanning

Scan a single username or email address across all available platform modules:

user-scanner -u johndoe             # Single username scan
user-scanner -e johndoe@gmail.com   # Single email scan

2. Cross-Scan & Pivot Intelligence

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:

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 
user-scanner -u johndoe --cross-scan                                  # Pivot from username scan
user-scanner -e johndoe@gmail.com --cross-scan                        # Pivot from email scan
user-scanner -e johndoe@gmail.com --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.

3. Hudson Rock Malware Breach Intelligence

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 johndoe@gmail.com --hudson   # Email malware log check

🖼️ To view output terminal screenshots and visual previews, see docs/EXAMPLES.md.

4. Targeted Category & Module Scanning

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 johndoe@gmail.com -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. Bulk File Scanning

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

6. Report Exports, Options & Proxies

# 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

📚 Documentation Hub

Explore detailed documentation guides in the docs/ directory:

🐍 Python Library Mode

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, "test@gmail.com")
    print(result.to_json())

asyncio.run(main())

💡 For complete Python API documentation and batch category checking examples, see docs/USAGE.md.

💖 Support the Project

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:

👉 Sponsor on GitHub

Project Sponsors

Huge thanks to our amazing sponsors who support the ongoing development of user-scanner!

soxoj
@soxoj 		hienyimba
@hienyimba 		InDieTasten
@InDieTasten

📜 Contributing

We welcome community contributions! Please read our Contributing Guidelines before opening a PR or submitting new scan modules.

⚠️ Disclaimer

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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.5.0.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kaifcodec from gravatar.com kaifcodec

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Kaif

Requires

Python >=3.10

Provides Extra

dev pdf

Tags

osint email-osint username-osint python cli-tool cybersecurity threat-intelligence security

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

user_scanner-1.5.0.tar.gz (245.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

user_scanner-1.5.0-py3-none-any.whl (485.7 kB view details)

Uploaded Python 3

File details

Details for the file user_scanner-1.5.0.tar.gz.

File metadata

  • Download URL: user_scanner-1.5.0.tar.gz
  • Upload date:
  • Size: 245.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.33.1

File hashes

Hashes for user_scanner-1.5.0.tar.gz
Algorithm Hash digest
SHA256 46336b7468006b3b745fa4b14faefed42a2e08e67e861909d3d7e70fb568e0ce
MD5 84824b47449b550481dbfe48b68e54f8
BLAKE2b-256 100a9d25309e3161e7bcaa000096cd09c7a2c127aa476edcef90c1f775513a5d

See more details on using hashes here.

File details

Details for the file user_scanner-1.5.0-py3-none-any.whl.

File metadata

  • Download URL: user_scanner-1.5.0-py3-none-any.whl
  • Upload date:
  • Size: 485.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.33.1

File hashes

Hashes for user_scanner-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9adf79c40c946cc6a1da7bdd61028780ecfc4d0f4af4126863aa1571cb466747
MD5 5d7776e75eb6b0ee1c56e24ef0c1f1bf
BLAKE2b-256 ae2692520e71460e80bf15d8cd53bb1088bd8719ec5d80ac2878ea789ee6e872

See more details on using hashes here.

Release history Release notifications | RSS feed

1.5.0.1

2 files

This release

1.5.0 This release

2 files

1.4.3.1

2 files

Yanked

1.4.3

2 files

Yanked reason: v1.4.3 contains a data-loss bug ignoring the media dictionary in result rendering and export pipelines. Use v1.4.3.1 or higher.

1.4.2.1

2 files

1.4.2

2 files

1.4.1.9

2 files

1.4.1.8

2 files

1.4.1.7

2 files

1.4.1.6

2 files

1.4.1.5

2 files

1.4.1.4

2 files

1.4.1.3

2 files

1.4.1.2

2 files

1.4.1.1

2 files

1.4.1

2 files

1.4.0.3

2 files

1.4.0.2

2 files

1.4.0.1

2 files

1.4.0

2 files

1.3.6.8

2 files

1.3.6.7

2 files

1.3.6.6

2 files

1.3.6.5

2 files

1.3.6.4

2 files

1.3.6.3

2 files

1.3.6.2

2 files

1.3.6.1

2 files

1.3.6

2 files

1.3.5.9

2 files

1.3.5.8

2 files

1.3.5.7

2 files

1.3.5.6

2 files

1.3.5.5

2 files

1.3.5.4

2 files

1.3.5.3

2 files

1.3.5.2

2 files

1.3.5.1

2 files

1.3.5

2 files

1.3.4.6

2 files

1.3.4.5

2 files

1.3.4.4

2 files

1.3.4.3

2 files

1.3.4.2

2 files

1.3.4.1

2 files

1.3.4

2 files

1.3.3.3

2 files

1.3.3.2

2 files

1.3.3.1

2 files

1.3.3

2 files

1.3.2.2

2 files

1.3.2.1

2 files

1.3.2

2 files

1.3.1.1

2 files

1.3.1

2 files

1.3.0.3

2 files

1.3.0.2

2 files

1.3.0.1

2 files

1.3.0

2 files

1.2.0.6

2 files

1.2.0.5

2 files

1.2.0.4

2 files

1.2.0.3

2 files

1.2.0.2

2 files

1.2.0.1

2 files

1.2.0

2 files

1.1.1.2

2 files

1.1.1.1

2 files

1.1.1.0

2 files

1.1.0.9

2 files

1.1.0.8

2 files

1.1.0.7

2 files

1.1.0.6

2 files

Yanked

1.1.0.5

2 files

Yanked reason: structure mismatch with standard rules

Yanked

1.1.0.4

2 files

Yanked reason: version mismatch with 1.1.0.2

Yanked

1.1.0.3

2 files

Yanked reason: version mismatch

1.1.0.2

2 files

1.1.0.1

2 files

1.1.0

2 files

1.0.10.3

2 files

1.0.10.2

2 files

1.0.10.1

2 files

1.0.10.0

2 files

1.0.9.1

2 files

1.0.9.0

2 files

1.0.8.1

2 files

1.0.8.0

2 files

1.0.7.0

2 files

1.0.6.0

2 files

1.0.5.0

2 files

1.0.4.2

2 files

1.0.4.1

2 files

1.0.4.0

2 files

1.0.3.1

2 files

1.0.3.0

2 files

1.0.2.1

2 files

1.0.2.0

2 files

1.0.1.6

2 files

1.0.1.5

2 files

1.0.1.4

2 files

1.0.1.3

2 files

1.0.1.2

2 files

1.0.1.1

2 files

1.0.1.0

2 files

1.0.0.9

2 files

1.0.0.8

2 files

1.0.0.7

2 files

1.0.0.6

2 files

1.0.0.5

2 files

1.0.0.4

2 files

1.0.0.3

2 files

1.0.0.2

2 files

1.0.0.1

2 files

1.0.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page