User Scanner

심층 이메일 및 사용자 이름 인텔리전스를 위해 설계된 강력한 2-in-1 OSINT 스위트입니다.

380개 이상의 총 스캔 벡터(155개 이상의 이메일 통합 사이트 및 225개 이상의 사용자 이름 플랫폼 포함)를 통해 디지털 발자국을 매핑하고, 대상 행동을 분석하며, 관심사를 파악하고, 사용자 이름의 전체 메타데이터를 확인하고, 계정 등록 여부를 몇 초 만에 검증할 수 있습니다.

💖 후원

계정 열거를 넘어서세요. WebVetted는 이메일이나 사용자 이름을 심층 OSINT 강화, 침해 인텔, AI 분석 및 대화형 신원 그래프를 갖춘 완전한 신원 조사로 전환합니다.
조사 시작하기 →

✨ 주요 기능

• 🔎 심층 이메일 및 사용자 이름 OSINT: 380개 이상의 플랫폼에서 이메일 등록을 조회하고 고급 사용자 이름 프로파일링을 수행합니다.
• 👤 풍부한 메타데이터 수집: 아바타, 바이오 설명, 팔로워 수, UID 번호, 판매자 상태 및 계정 속성을 수집합니다.
• 🔀 교차 스캔 및 피벗 엔진: 초기 스캔에서 핸들, 프로필 링크 및 노출된 이메일 주소를 채굴하여 보조 대상 벡터를 자동으로 피벗합니다.
• 🛡️ Hudson Rock 인포스틸러 침해 인텔: --hudson 플래그를 사용하여 인포스틸러 악성코드 침해 로그를 조회함으로써 우선순위가 높은 대상과의 연관성을 파악합니다.
• ⚡ 고처리량 병렬 엔진: 최대 동시성과 자동 TLS 지문 위장을 위해 httpx 및 curl_cffi 기반으로 구동됩니다.
• 🔀 순열 및 별칭 생성기: 타이포스쿼팅 또는 대체 별칭을 잡아내기 위한 와일드카드 기반 사용자 이름 변형 생성.
• 📂 다중 형식 보고서: 파이프라인 통합을 위해 (프로필 사진 포함) PDF, JSON, CSV로 자동 내보내기.
• 🌐 고급 프록시 피벗: 프로토콜 자동 감지(http, socks5) 및 사전 스캔 상태 검증(--validate-proxies)을 갖춘 내장 프록시 순환.
• 🎨 반응형 터미널 UI: 동적 진행 추적, 자동 적응형 카테고리 그리드(-lu/-le) 및 명확한 상태 보고.

🚀 설치

🐍 PyPI 이용 (권장)

# Upgrade pip and install user-scanner
python3 -m pip install --upgrade pip
pip install user-scanner

📦 가상 환경 설정

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\Activate.ps1

# Install package
pip install user-scanner

❄️ Nix 이용 (Linux 및 macOS)

# Run instantly without installing permanently
nix run github:kaifcodec/user-scanner/main -- --help

# Drop into a temporary shell with user-scanner active
nix shell github:kaifcodec/user-scanner/main

💻 사용 가이드

1. 기본 사용자 이름 및 이메일 스캔

사용 가능한 모든 플랫폼 모듈에서 단일 사용자 이름 또는 이메일 주소를 스캔합니다:

user-scanner -u johndoe             # Single username scan
user-scanner -e [email protected]   # Single email scan

2. 교차 스캔 및 피벗 인텔리전스

이메일 스캔은 계정이 존재한다는 것은 증명하지만 핸들을 거의 드러내지 않습니다. --cross-scan 은 대상 프로필에서 노출된 핸들, 프로필 링크 및 보조 이메일 주소를 채굴하여 일치하는 모든 플랫폼에서 다중 패스 정찰로 피벗합니다:

user-scanner -u johndoe --cross-scan                                  # Pivot from username scan
user-scanner -e [email protected] --cross-scan                        # Pivot from email scan
user-scanner -e [email protected] --cross-scan --cross-links verified # Platform-verified links only
user-scanner -u johndoe --cross-scan --cross-depth 2        # Follow links two hops deep

💡 신뢰도 점수, 링크 분류 규칙 및 비용 모델에 대한 자세한 내용은 docs/CROSS_SCAN.md 를 참조하세요.

3. Hudson Rock 악성코드 침해 인텔리전스

대상 사용자 이름 또는 이메일 주소가 인포스틸러 악성코드 감염 로그에 노출되었는지 확인합니다:

user-scanner -u johndoe --hudson             # Username malware log check
user-scanner -e [email protected] --hudson   # Email malware log check

🖼️ 출력 터미널 스크린샷과 시각적 미리보기를 보려면 docs/EXAMPLES.md 를 참조하세요.

4. 대상 카테고리 및 모듈 스캔

특정 카테고리나 개별 모듈을 스캔하거나, 사용 가능한 모듈을 반응형 그리드로 나열합니다:

user-scanner -u johndoe -c dev                # Developer platforms only
user-scanner -e [email protected] -m github   # Single module check
user-scanner -u johndoe -m github,instagram   # Specific comma-separated modules

user-scanner -lu                              # List user categories & modules grid
user-scanner -le                              # List email categories & modules grid

5. 대량 파일 스캔

입력 파일(줄당 하나의 대상)에서 여러 대상을 스캔합니다:

user-scanner -uf usernames.txt   # Bulk username scan
user-scanner -ef emails.txt      # Bulk email scan

6. 보고서 내보내기, 옵션 및 프록시

# Export results to PDF, JSON, or CSV
user-scanner -u johndoe -f pdf -o report.pdf
user-scanner -u johndoe -f json -o results.json

# Verbose URL reporting and show all results (including not found)
user-scanner -u johndoe -v --all

# Rotate proxies with pre-scan validation check
user-scanner -u johndoe -P proxies.txt --validate-proxies

📚 문서 허브

docs/ 디렉토리에서 상세 문서 가이드를 살펴보세요:

• 📋 CLI 플래그 참조 — 모든 CLI 플래그 및 옵션의 전체 분석.
• 🔀 교차 스캔 및 피벗 가이드 — 다중 패스 교차 스캔 정찰에 대한 심층 가이드.
• 🔀 패턴 구문 가이드 — 사용자 이름 생성을 위한 와일드카드 및 순열 패턴.
• 🐍 라이브러리 모드 가이드 — 자신의 스크립트에서 Python 엔진을 프로그래밍 방식으로 호출하기.
• 🌐 프록시 및 네트워크 가이드 — 프록시 순환 형식, 상태 점검 및 지역별 VPN 문제 해결.
• 🖼️ 미디어 및 출력 갤러리 — 비디오 데모, 터미널 녹화 및 스크린샷 미리보기.

🐍 Python 라이브러리 모드

User Scanner 엔진을 Python 스크립트에 직접 통합합니다:

import asyncio
from user_scanner.core import engine
from user_scanner.email_scan.shopping import etsy

async def main():
    # Engine validates target against module and returns Result object
    result = await engine.check(etsy, "[email protected]")
    print(result.to_json())

asyncio.run(main())

💡 전체 Python API 문서 및 일괄 카테고리 확인 예제는 docs/USAGE.md 를 참조하세요.

💖 프로젝트 후원하기

웹 플랫폼은 지속적으로 인증 흐름을 업데이트합니다. 380개 이상의 스캔 모듈을 유지 관리하려면 사이버 보안 커뮤니티를 위해 이 스위트를 안정적이고 무료로 유지하기 위한 24시간 헌신이 필요합니다.

user-scanner 가 수 시간의 수동 피벗 작업을 절약해 주었거나 조사에 도움이 되었다면, 프로젝트 후원을 고려해 주세요:

👉 GitHub에서 후원하기

프로젝트 후원자

user-scanner 의 지속적인 개발을 지원해 주시는 훌륭한 후원자분들께 큰 감사를 드립니다!

@soxoj

@hienyimba

@InDieTasten

📜 기여

커뮤니티 기여를 환영합니다! PR을 열거나 새 스캔 모듈을 제출하기 전에 기여 가이드라인 을 읽어 주세요.

⚠️ 면책 조항

이 도구는 교육 목적, 승인된 보안 연구 및 방어적 OSINT 조사를 위해서만 엄격히 제공됩니다. 개발자는 이 소프트웨어의 배포로 인해 발생하는 오용, 의도하지 않은 결과 또는 법적 조치에 대해 어떠한 책임도 지지 않으며 책임을 부인합니다.