Logotipo do TGSherlock

TGSherlock

OSINT do Telegram em um painel web local: monitoramento ao vivo, alertas, rastreamento de usuários e varreduras por palavras-chave.

Painel Perfil do usuário

Instalação

pipx install tgsherlock

Versão mais recente do GitHub: pipx install git+https://github.com/emrekybs/tgsherlock.git (se tgsherlock não for encontrado depois, execute pipx ensurepath e abra um novo terminal).

Execução

tgsherlock

O painel abre no seu navegador em http://127.0.0.1:8765. No Linux, a primeira execução também adiciona o TGSherlock ao menu de aplicativos, para que você possa iniciá-lo com um clique.

Primeira execução: crie um aplicativo em my.telegram.org → API development tools, insira seu API ID e API Hash, depois escaneie o código QR com o Telegram (Configurações → Dispositivos → Conectar dispositivo desktop). O login por número de telefone também está disponível.

Recursos

Monitor ao Vivo: mensagens em tempo real de usuários, grupos e canais escolhidos, com download opcional de mídia.
Alertas: monitore um usuário, um grupo ou todos os chats para qualquer mensagem, palavras-chave, regex, mídia ou indicadores. Receba notificações no aplicativo, na área de trabalho, por e-mail (SMTP) ou por webhook, com limitação de resumos.
Perfil do Usuário: bio, nomes de usuário, sinalizadores, grupos compartilhados, primeira e última visualização por grupo, atividade por hora e uma linha do tempo de mensagens com datas.
Busca: usuários, grupos e canais, exibidos com suas fotos de perfil.
Histórico de Grupo · Varredura por Palavras-chave · Rastreador de Usuários: tarefas em segundo plano com progresso e tratamento automático de FloodWait.
Entidades: e-mails, telefones, URLs, IPs, carteiras de criptomoedas, links de convite e hashtags, extraídos automaticamente.
Arquivo e exportação: filtre tudo o que você coletou e exporte como CSV, JSON ou um relatório HTML.
Múltiplas contas: adicione, alterne e saia pela barra lateral.

Atualização: pipx upgrade tgsherlock

Opções: --port 8790, --no-browser, --install-desktop, --uninstall-desktop. Os dados permanecem locais: ~/.config/tgsherlock (configurações, sessões) e ~/.local/share/tgsherlock (bancos de dados, mídia).

Uso responsável

Criado para OSINT defensivo e inteligência de ameaças. O TGSherlock só vê o que sua própria conta do Telegram pode ver. Siga a legislação local e os Termos de Serviço do Telegram.

Licença

MIT

tgsherlock