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 400+ total scan vectors—including 170+ email-integrated sites and 230+ 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 400+ 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 400+ 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:
Latest release

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.1.tar.gz (255.1 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.1-py3-none-any.whl (506.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for user_scanner-1.5.0.1.tar.gz
Algorithm Hash digest
SHA256 298d2e9a685f235a730625177317fe56d10ca6c808244b7bc6fc53ea453820bf
MD5 cecf9de4cd71318d619792183897d1f9
BLAKE2b-256 36c07b0aaa4e8ff1a6920018cb22197ac0a14ffa65e1225fb279f58917be0935

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for user_scanner-1.5.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1b9e9d74119eb4928714d70877d1f4659e98fe3310ebe43dd618424817eaf899
MD5 9bd12d6657851b70d65fb8b9e8a8bc6f
BLAKE2b-256 9df8a2e85228295f38453314fe253d1ecd1fe8f909737b4befb3b9daf0b287a2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.5.0.1 This release

2 files

1.5.0

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