User Scanner

Uma poderosa suíte OSINT 2 em 1 desenvolvida para Inteligência profunda de E-mail e Nome de Usuário.

Com mais de 380 vetores de varredura no total — incluindo mais de 155 sites integrados a e-mail e mais de 225 plataformas de nomes de usuário — você pode mapear pegadas digitais, analisar o comportamento do alvo, descobrir interesses, obter metadados completos de nomes de usuário e verificar registros de contas em segundos.

💖 Patrocinado por

Vá além da enumeração de contas. O WebVetted transforma um e-mail ou nome de usuário em uma investigação completa de identidade com enriquecimento profundo de OSINT, inteligência de violações, análise de IA e um grafo de identidade interativo.
Iniciar uma Investigação →

✨ Principais Recursos

• 🔎 OSINT profundo de E-mail e Nome de Usuário: Consulte registros de e-mail e realize perfilagem avançada de nomes de usuário em mais de 380 plataformas.
• 👤 Extração rica de metadados: Extrai avatares, descrições de bio, números de seguidores, números de UID, status de vendedor e atributos de conta.
• 🔀 Mecanismo de varredura cruzada e pivô: Minera handles, links de perfil e endereços de e-mail expostos em varreduras iniciais, fazendo pivô automaticamente entre vetores de alvo secundários.
• 🛡️ Inteligência de Violações Infostealer Hudson Rock: Consulte logs de violação de malware infostealer usando a flag --hudson para correlação de alvos de alta prioridade.
• ⚡ Mecanismo paralelo de alta taxa de transferência: Alimentado por httpx e curl_cffi para máxima concorrência com impersonação automática de impressão digital TLS.
• 🔀 Gerador de permutações e aliases: Geração de variações de nomes de usuário baseadas em curingas para detectar typosquatting ou aliases alternativos.
• 📂 Relatórios em múltiplos formatos: Exportações automáticas para PDF (com fotos de perfil), JSON e CSV para integração com pipelines.
• 🌐 Pivô avançado de proxies: Rotação de proxy integrada com detecção automática de protocolo (http, socks5) e validação de saúde pré-varredura (--validate-proxies).
• 🎨 Interface de terminal responsiva: Acompanhamento dinâmico de progresso, grades de categorias autoadaptáveis (-lu/) e relatórios de status claros.

🚀 Instalação

🐍 Via PyPI (Recomendado)

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

📦 Configuração de Ambiente Virtual

# 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

❄️ Via Nix (Linux e 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

💻 Guia de Uso

1. Varredura Básica de Nome de Usuário e E-mail

Escaneie um único nome de usuário ou endereço de e-mail em todos os módulos de plataforma disponíveis:

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

2. Varredura Cruzada e Inteligência de Pivô

Uma varredura de e-mail prova que uma conta existe, mas raramente revela um handle. O --cross-scan minera handles expostos, links de perfil e endereços de e-mail secundários dos perfis do alvo, fazendo pivô para reconhecimento multipasso em todas as plataformas correspondentes:

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

💡 Para pontuação de confiança, regras de classificação de links e modelos de custo, consulte docs/CROSS_SCAN.md.

3. Inteligência de Violações de Malware Hudson Rock

Verifique se um nome de usuário ou endereço de e-mail alvo foi exposto em logs de infecção por malware infostealer:

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

🖼️ Para ver capturas de tela do terminal de saída e prévias visuais, consulte docs/EXAMPLES.md.

4. Varredura Direcionada por Categoria e Módulo

Escaneie categorias específicas ou módulos individuais, ou liste os módulos disponíveis em uma grade responsiva:

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. Varredura em Massa a Partir de Arquivo

Escaneie vários alvos a partir de um arquivo de entrada (um alvo por linha):

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

6. Exportação de Relatórios, Opções e Proxies

# 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

📚 Centro de Documentação

Explore guias de documentação detalhados no diretório docs/:

• 📋 Referência de Flags da CLI — Detalhamento completo de cada flag e opção da CLI.
• 🔀 Guia de Varredura Cruzada e Pivô — Guia aprofundado sobre reconhecimento multipasso com varredura cruzada.
• 🔀 Guia de Sintaxe de Padrões — Padrões curinga e de permutação para geração de nomes de usuário.
• 🐍 Guia do Modo Biblioteca — Como chamar o mecanismo Python programaticamente a partir dos seus próprios scripts.
• 🌐 Guia de Proxy e Rede — Formatos de rotação de proxy, verificações de saúde e solução de problemas de VPN regional.
• 🖼️ Galeria de Mídia e Saída — Demonstrações em vídeo, gravações de terminal e prévias de capturas de tela.

🐍 Modo Biblioteca Python

Integre o mecanismo User Scanner diretamente em seus scripts 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())

💡 Para obter a documentação completa da API Python e exemplos de verificação de categorias em lote, consulte docs/USAGE.md.

💖 Apoie o Projeto

As plataformas web atualizam constantemente seus fluxos de autenticação. Manter mais de 380 módulos de varredura exige dedicação ininterrupta para manter a suíte confiável e gratuita para a comunidade de cibersegurança.

Se o user-scanner economizou horas de pivô manual ou auxiliou suas investigações, considere apoiar o projeto:

👉 Patrocinar no GitHub

Patrocinadores do Projeto

Muito obrigado aos nossos incríveis patrocinadores que apoiam o desenvolvimento contínuo do user-scanner!

📜 Contribuição

Aceitamos contribuições da comunidade! Leia nossas Diretrizes de Contribuição antes de abrir um PR ou enviar novos módulos de varredura.

⚠️ Aviso Legal

Esta ferramenta é fornecida estritamente para fins educacionais, pesquisa de segurança autorizada e investigações defensivas de OSINT. Os desenvolvedores não assumem nenhuma responsabilidade e não são responsáveis por qualquer uso indevido, consequências não intencionais ou ações legais resultantes da implantação deste software.