UserScanner a CLI tool to help you select a unique username across all popular sites.

Overview

User Scanner is a command‑line tool that checks the availability of a username across multiple social, developer, and creator platforms in a single command. It’s easy to contribute new site support, making it a collaborative OSINT utility for usernames.

Features

• ✅ Check usernames across social networks, developer platforms, and creator communities.
• ✅ Clear Available / Taken / Error output for each platform.
• ✅ Fully modular – add new platform modules easily.
• ✅ Ready‑to‑use CLI after pip install.
• ✅ Can be used as a username OSINT tool.

Installation

pip install user-scanner

Basic Usage

Scan a username across all supported platforms:

user-scanner -u <username>

Optional Flags

• Category scan (e.g., developer sites):

  user-scanner -u <username> -c dev

• List all modules:

  user-scanner -l

• Single module scan (e.g., GitHub):

  user-scanner -u <username> -m github

Example Output

Running the tool for the username johndoe078 produces:

Checking username: johndoe078

== DEV SITES ==
  [✔] Codeberg: Available
  [✔] Cratesio: Available
  [✔] Dockerhub: Available
  [✘] Github: Taken
  [✔] Gitlab: Available
  [✔] Launchpad: Available
  [✔] Npmjs: Available
  [✔] Replit: Available

== SOCIAL SITES ==
  [✔] Bluesky: Available
  [✘] Instagram: Taken
  [✔] Mastodon: Available
  [✔] Pinterest: Available
  [✘] Reddit: Taken
  [✔] Snapchat: Available
  [✔] Telegram: Available
  [✘] Threads: Taken
  [✔] X (Twitter): Available
  [✔] Youtube: Available

== CREATOR SITES ==
  [✔] Devto: Available
  [✔] Hashnode: Available
  [✔] Kaggle: Available
  [✔] Medium: Available
  [✔] Patreon: Available

== COMMUNITY SITES ==
  [✔] Coderlegion: Available

== GAMING SITES ==
  [✔] Chess_com: Available
  [✔] Osu: Available
  ...
  ...
  ...

Module Organization

The project’s modules are grouped 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, and many more – upcoming)

Contributing Guidelines

Each module must define a validate_() function that accepts a username and returns:

Implementation Notes

• Use httpx for HTTP requests.
• Use colorama for colored terminal output.
• Modules may optionally define a CLI parser if they support custom arguments.
• See CONTRIBUTING.md in the repository for detailed examples.

Dependencies

• httpx
• colorama

License

This project is licensed under the MIT License.

Call for Help

The community/ and gaming/ categories are still small. Contributions are welcome to expand platform coverage.