TGSherlock

OSINT de Telegram en un panel web local: monitoreo en vivo, alertas, seguimiento de usuarios y barridos de palabras clave.

Instalación

pipx install tgsherlock

Última versión desde GitHub: pipx install git+https://github.com/emrekybs/tgsherlock.git (si después no se encuentra tgsherlock, ejecuta pipx ensurepath y abre una nueva terminal).

Ejecución

tgsherlock

El panel se abre en tu navegador en http://127.0.0.1:8765. En Linux, la primera ejecución también añade TGSherlock a tu menú de aplicaciones, para que puedas iniciarlo con un clic.

Primera ejecución: crea una aplicación en my.telegram.org → API development tools, introduce tu API ID y tu API Hash, y luego escanea el código QR con Telegram (Ajustes → Dispositivos → Vincular dispositivo de escritorio). También está disponible el inicio de sesión con número de teléfono.

Funciones

• Monitor en vivo: mensajes en tiempo real de los usuarios, grupos y canales elegidos, con descarga opcional de multimedia.
• Alertas: vigila a un usuario, un grupo o todos los chats para cualquier mensaje, palabras clave, regex, multimedia o indicadores. Recibe notificaciones en la aplicación, en el escritorio, por correo electrónico (SMTP) o por webhook, con limitación de resúmenes.
• Perfil de usuario: biografía, nombres de usuario, flags, grupos compartidos, primera y última vez visto por grupo, actividad por horas y una línea temporal de mensajes con fechas.
• Búsqueda: usuarios, grupos y canales, mostrados con sus fotos de perfil.
• Historial de grupos · Barrido de palabras clave · Rastreador de usuarios: tareas en segundo plano con progreso y gestión automática de FloodWait.
• Entidades: correos electrónicos, teléfonos, URLs, IPs, carteras de criptomonedas, enlaces de invitación y hashtags, extraídos automáticamente.
• Archivo y exportación: filtra todo lo que has recopilado y expórtalo como CSV, JSON o un informe HTML.
• Múltiples cuentas: añade, cambia y cierra sesión desde la barra lateral.

Actualización: pipx upgrade tgsherlock

Opciones: --port 8790, --no-browser, --install-desktop, --uninstall-desktop. Los datos permanecen locales: ~/.config/tgsherlock (ajustes, sesiones) y ~/.local/share/tgsherlock (bases de datos, multimedia).

Uso responsable

Creado para OSINT defensivo e inteligencia de amenazas. TGSherlock solo ve lo que tu propia cuenta de Telegram puede ver. Cumple la legislación local y los Términos de Servicio de Telegram.

Licencia

MIT