UserScanner는 모든 인기 사이트에서 고유한 사용자 이름을 선택하도록 도와주는 CLI 도구입니다.
Overview
User Scanner는 하나의 명령으로 여러 소셜, 개발자 및 크리에이터 플랫폼에서 사용자 이름의 사용 가능 여부를 확인하는 커맨드‑라인 도구입니다. 새로운 사이트 지원을 쉽게 추가할 수 있어 사용자 이름에 대한 협업 OSINT 유틸리티로 활용됩니다.
Features
- ✅ 소셜 네트워크, 개발자 플랫폼, 크리에이터 커뮤니티 전반에 걸쳐 사용자 이름을 확인합니다.
- ✅ 각 플랫폼에 대해 Available / Taken / Error 결과를 명확히 표시합니다.
- ✅ 완전 모듈식 – 새로운 플랫폼 모듈을 손쉽게 추가할 수 있습니다.
- ✅
pip install후 바로 사용할 수 있는 CLI 제공. - ✅ 사용자 이름 OSINT 도구로 활용 가능.
Installation
pip install user-scanner
Basic Usage
전체 지원 플랫폼에서 사용자 이름을 스캔합니다:
user-scanner -u <username>
Optional Flags
-
카테고리 스캔 (예: 개발자 사이트):
user-scanner -u <username> -c dev -
모든 모듈 목록 보기:
user-scanner -l -
단일 모듈 스캔 (예: GitHub):
user-scanner -u <username> -m github
Example Output
johndoe078 사용자 이름에 대해 도구를 실행하면 다음과 같은 결과가 출력됩니다:
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
프로젝트 모듈은 카테고리별로 구성됩니다:
user_scanner/
├── dev/ # 개발자 플랫폼 (GitHub, GitLab 등)
├── social/ # 소셜 플랫폼 (Twitter/X, Reddit, Instagram 등)
├── creator/ # 크리에이터 플랫폼 (Hashnode, Dev.to, Medium 등)
├── community/ # 커뮤니티 플랫폼 (포럼, 니치 사이트)
├── gaming/ # 게임 사이트 (chess.com 등 – 향후 추가 예정)
Contributing Guidelines
각 모듈은 사용자 이름을 받아 다음과 같이 반환하는 validate_() 함수를 정의해야 합니다:
| Return Code | Meaning |
|---|---|
1 | Available |
0 | Taken |
2 | Error / Could not check |
Implementation Notes
- HTTP 요청에는 httpx를 사용합니다.
- 컬러 터미널 출력에는 colorama를 사용합니다.
- 모듈이 별도 인자를 지원하는 경우 선택적으로 CLI 파서를 정의할 수 있습니다.
- 자세한 예시는 저장소의
CONTRIBUTING.md를 참고하십시오.
Dependencies
httpxcolorama
License
이 프로젝트는 MIT License 하에 라이선스됩니다.
Call for Help
community/와 gaming/ 카테고리는 아직 규모가 작습니다. 플랫폼 커버리지를 확대하기 위한 기여를 환영합니다.