Skip to content

amber009-js/user-scanner

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

User Scanner

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.


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

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

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 ==
  [✘] Instagram: Taken
  [✘] Pinterest: Taken
  [✘] Reddit: Taken
  [✘] Snapchat: Taken
  [✘] Threads: Taken
  [✘] X (Twitter): Taken
  [✔] Youtube: Available

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

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

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)

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


License

This project is licensed under the MIT License. See LICENSE for details.

⚠️ community/ is small looking for contributions

About

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.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%