DEV Community

Cover image for Built a username checker which lets you check availability of a username across popular sites.
kaifcodec
kaifcodec

Posted on

Built a username checker which lets you check availability of a username across popular sites.

#python #cli #osint #opensource

User Scanner

Visit :GitHub
Scan a username across multiple social, developer, and creator platforms to see if it’s available.

Perfect for finding a unique username across GitHub, Twitter, Reddit, Instagram, and more, all in one command.

Looking for feedback and contributions

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.
  • ✅ Command-line interface ready: works directly after pip install.
  • ✅ Can be used as username OSINT tool.

Installation 

pip install user-scanner
Enter fullscreen mode Exit fullscreen mode

Usage

Scan a username across all platforms:

user-scanner -u <username>
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Example Output: 

 Checking username: johndoe07

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

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

== CREATOR SITES ==
  [✔] Devto: Available
  [✔] Hashnode: Available
  [✘] Kaggle: Taken
  [!] Medium: Error
  [✔] Patreon: Available

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

== GAMING SITES ==
  [✘] Chess_com: Taken

  ...
  ...
  ...
Enter fullscreen mode Exit fullscreen mode

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, and many more(upcoming))
Enter fullscreen mode Exit fullscreen mode

Module guidelines:

  • Each module must define a validate_<site>() function that takes a username and returns:
    • 1 → Available
    • 0 → Taken
    • 2 → Error / Could not check
  • Use httpx for requests, colorama for colored output.
  • Optional: modules can define a CLI parser if they support custom arguments.

See CONTRIBUTING.md for examples.

Dependencies:

⚠️ community/ and gaming/ are small, looking for contributions

Top comments (0)