kaifcodec

Posted on Oct 26 • Edited on Dec 15

User Scanner : Find Your Perfect Username Across All Platforms in Seconds ⚡

#python #opensource #github #osint

🚀 User Scanner: Find Your Perfect Username Across All Platforms in Seconds ⚡

Tired of opening tabs and hunting site-by-site to see if your favorite username is taken?

user-scanner fixes that , fast, from your terminal, with clear color-coded output. Perfect for developers, creators, and anyone who wants a consistent online identity without the busywork.

Features

✅ Check usernames across social networks, developer platforms, and creator communities
✅ Clear Available / Taken / Error output for each platform
✅ Robust error handling: It prints the exact reason (e.g. Cannot use underscores, hyphens at the start/end)
✅ Fully modular: add new platform modules easily
✅ Wildcard-based username permutations for automatic variation generation using provided suffix
✅ Selection of results format (e.g. json, csv, console (default))
✅ Get the scanning results in preferred format (json/csv) in specified output file (suitable for power users)
✅ Command-line interface ready: works directly after pip install
✅ Can be used as username OSINT tool
✅ Very low and lightweight dependencies, can be run on any machine

Installation

pip install user-scanner

Usage

Scan a username across all platforms:

user-scanner -u <username>

Optionally, scan a specific category or single module:

user-scanner -u <username> -c dev
user-scanner -l # Lists all available modules
user-scanner -u <username> -m github

Also, the output file and format can be specified:

Errors and warnings will only appear when the format is set to "console"

user-scanner -u <username> -f console #Default format
user-scanner -u <username> -f csv
user-scanner -u <username> -f json
user-scanner -u <username> -f <format> -o <output-file>

Generate multiple username variations by appending a suffix:

user-scanner -u <username> -p <suffix>

Optionally, scan a specific category or single module with limit:

user-scanner -u <username> -p <suffix> -c dev
user-scanner -u <username> -p <suffix> -m github
user-scanner -u <username> -p <suffix> -s <number> # limit generation of usernames
user-scanner -u <username> -p <suffix> -d <seconds> # delay to avoid rate-limits (can be 0s-1s)

Screenshots:

Note*: New modules are constantly getting added so this might have only limited, outdated output:

Contributing:

Modules are organized by category:

user_scanner/
├── dev/        # Developer platforms (GitHub, GitLab, etc.)
├── social/     # Social platforms (Twitter/X, Reddit, Instagram, etc.)
├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
├── community/  # Community platforms (forums, niche sites)
├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
├── donation/   # Donation taking sites (buymeacoffe.com, similar...)

Module guidelines:
This project contains small "validator" modules that check whether a username exists on a given platform. Each validator is a single function that returns a Result object (see core/orchestrator.py).

Result semantics:

Result.available() → available
Result.taken() → taken
Result.error(message: Optional[str]) → error, blocked, unknown, or request failure (include short diagnostic message when helpful)

Follow this document when adding or updating validators.

Dependencies:

License

This project is licensed under the MIT License.

Top comments (14)

kaifcodec • Oct 26

Actively looking for feedbacks and contributions for improvement of it.

JA Proger • Nov 24

Great project!

kaifcodec • Nov 25

Thanks!
UserScanner is open to contributions and it's super easy to contribute, if you are familiar with networking and APIs you can add new popular site support which you prefer and think would make the project better.

JA Proger • Nov 25

Thank you for invitation! I'll think about it. I'm currently getting familiar with networking, so wouldn't bring anything nice 😉

Anony Mous • Oct 28

Looks like a nice project with unique.
The codebase is very contributor friendly.

kaifcodec • Oct 29

Thanks!

Splot Dev • Oct 28

This is really useful - but could you create a web based version? I think users would love that

kaifcodec • Oct 28

Thanks! Do you mean a hosted web version (like websites), or a local one that runs via Flask/FastAPI on localhost?

Splot Dev • Oct 28

A hosted web version would be really nice

kaifcodec • Oct 29

Thanks! A hosted version would be great, but the project’s still small, not enough supported sites yet. A public one would also need regular maintenance since sites change and rate limits hit often. For now, I’m keeping it CLI-focused until it’s bigger and more stable. If you’re into web requests or site integrations, feel free to contribute, more hands will speed things up.