Skip to content
KitploitKITPLOIT
HerramientasExploitsBlog
Log in
Enviar
HerramientasExploitsBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

FeedsContactoPrivacidad© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
telegram-bot-dumper — Volcar un bot de Telegram. Navegarlo como Telegram Web. Herramienta CLI forense con interfaz web | Kitploit
Herramientas/GitHubGitHub/soxoj/telegram-bot-dumper
OSINT (Inteligencia de Fuentes Abiertas)Exfiltración de DatosRecopilación de Información
GitHubsoxoj/telegram-bot-dumper

telegram-bot-dumper

Volcar un bot de Telegram. Navegarlo como Telegram Web. Herramienta CLI forense con interfaz web

Ver Repositorio
24934100hace 3 díasRevisado por Kitploit
Compartir

telegram-bot-dumper

Documentation Status

Volcado sencillo de todo el contenido de un bot de Telegram.

Entrada: solo el token del bot.

Salida: nombre e información del bot, historial de texto y multimedia de todos los chats, información y fotos de los usuarios del bot.


Esta es una implementación en Python.

🚀 Versión rápida en Golang por ScBoln.

📖 Documentación completa: https://telegram-bot-dumper.readthedocs.io

Visor web

Una interfaz de navegador similar a Telegram Web para un volcado: lista de chats, historial completo de mensajes con multimedia en línea, perfiles de usuario con carrusel de fotos y búsqueda global en todas las conversaciones a la vez. Modo en vivo compatible: ejecuta el dumper en segundo plano y transmite los mensajes nuevos al navegador en tiempo real.

Abre una conversación y elige Download chat para guardar su historial, multimedia y fotos como dump_<bot_id>_<chat_id>.zip. El archivo conserva la estructura de directorios <bot_id>/<chat_id>/ y excluye otros chats y archivos de nivel de bot.

Caso de uso — pentesting de un token de bot filtrado. Los tokens de bots de Telegram aparecen constantemente en un encargo — codificados directamente en una aplicación móvil/de escritorio, incluidos en un repositorio, o presentes en un log de CI, un archivo de configuración o un bundle del lado del cliente. Por sí solo, un token parece un hallazgo de baja severidad; cargarlo aquí muestra el alcance real del impacto. Para un bot interno (mesa de soporte, asistente de IT/DevOps, asistente de IA) eso significa todas las conversaciones de los empleados con él — nombres de host internos, perfiles de VPN, credenciales y detalles de infraestructura — navegables y consultables, para que puedas delimitar el impacto y documentar el hallazgo en tu informe.

Visor web — volcado de un bot interno

Ejecutar desde una imagen precompilada (Docker Hub)

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" soxoj/telegram-bot-dumper-web

O compilar localmente

docker compose up --build      # builds and serves on http://127.0.0.1:8010

O sin Docker

pip install -r requirements.txt
python webapp/server.py        # serves dumps from the repository folder on :8010
./run-viewer.sh                # live mode + dumping new bots, API_ID/API_HASH from .env

Abre http://127.0.0.1:8010 y pega el token del bot para abrir su volcado: debe coincidir con el token guardado en el bot.json de ese volcado. La visualización de solo lectura no requiere credenciales de API. El modo en vivo requiere además API_ID/API_HASH de my.telegram.org, pasados a través del entorno — nunca incorporados en la imagen:

# one-off container
docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... soxoj/telegram-bot-dumper-web

# or with docker compose: put them in a local .env (see .env.example)
cp .env.example .env && $EDITOR .env && docker compose up

Las variables de entorno PORT y HOST sobrescriben los valores predeterminados (8010, 127.0.0.1).

Volcar un nuevo bot desde el visor

Por defecto, el visor solo abre bots que ya tienen un volcado. Inícialo con --allow-new-dumps (ALLOW_NEW_DUMPS=1 en Docker) y un token sin volcado todavía se verifica con Telegram, obtiene su carpeta y bot.json, y el modo en vivo vuelca todo su historial directamente en el navegador. Esto requiere API_ID/API_HASH.

Cualquiera que pueda abrir la página puede entonces hacer que tu servidor vuelque cualquier bot bajo tu API_ID, por lo que el visor se niega a iniciarse con esta opción activada en un HOST que no sea loopback. En Docker, HOST siempre es 0.0.0.0 dentro del contenedor, así que añade ALLOW_PUBLIC=1 (--allow-public) y mantén el puerto en loopback por tu cuenta:

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... -e ALLOW_NEW_DUMPS=1 -e ALLOW_PUBLIC=1 \
  soxoj/telegram-bot-dumper-web

Características

  • Volcar los mensajes del bot con contenido multimedia recorriendo los ids de mensaje hacia arriba (por defecto) o hacia abajo (--down / --start-from-id).
  • Modo de escucha en vivo (--listen-only): recibir mensajes nuevos en tiempo real y ofrecer volcar el historial hacia abajo desde el primer id observado.
  • Resolver la información del usuario tanto para los mensajes entrantes como para las respuestas salientes del bot.
  • Modos ligeros para una enumeración rápida de usuarios: omitir multimedia, omitir el historial de texto por chat, escribir los usuarios en un único CSV.
  • Los mensajes de grupo / supergrupo se etiquetan con [from:USER][group:CHAT]. Los mensajes directos salientes del bot se etiquetan con [to:USER].
  • Monitoreo de grupos: si el bot ha sido añadido a un grupo/supergrupo Y su modo privacidad está deshabilitado, el bot recibe todos los mensajes del grupo — no solo comandos y respuestas — y --listen-only los volcará en tiempo real. Con el modo privacidad habilitado (el valor por defecto) el bot solo ve comandos, menciones y respuestas.

Requisitos

  • Python >= 3.6
  • Telethon (consulte requirements.txt para la versión fijada)
  • Registrar una aplicación de Telegram para obtener API_ID y API_HASH

Uso como herramienta CLI

pip install -r requirements.txt

# Telegram API credentials from https://my.telegram.org (read from the environment)
export API_ID=123456
export API_HASH=abc...

Inicio rápido — volcado completo (comportamiento predeterminado)

Recorre los ids 1..∞ hacia arriba en lotes de 200, descargando cada mensaje, todos los medios y todas las fotos de perfil de usuario. De forma predeterminada, el volcador sigue escuchando nuevos mensajes entrantes después de que finaliza el volcado. Para salir inmediatamente después del volcado del historial (ideal para scripts y tareas cron), pase --no-listen.

./dumper.py --token 12345678:ABCe2rPVteUWZ7wLeCqCb3CH3ilUY_fLabc

Volcar hacia abajo desde el mensaje más reciente

Para un bot activo, el recorrido ascendente se topa con un largo tramo de ids antiguos podados (eliminados/expirados) y se rinde. Recorrer hacia abajo desde el id más reciente es mucho más productivo. --down sondea automáticamente el límite superior (potencias de 10 hasta 10⁹) y comienza desde el id no vacío más alto que encuentra:

./dumper.py --token TOKEN --down

Nota. Telegram no conserva el historial de mensajes de los bots para siempre. Empíricamente, solo los últimos cientos de miles de mensajes permanecen accesibles — en nuestras pruebas, un bot con mucho tráfico exponía aproximadamente los últimos 500K mensajes antes de que messages.getMessages comenzara a devolver solo MessageEmpty para los ids más antiguos. Si tu bot ha procesado históricamente más tráfico que eso, el historial más antiguo simplemente ya no existe en el servidor y ninguna opción podrá recuperarlo.

Si ya conoces un id de mensaje reciente (por ejemplo, uno que viste en tiempo real), puedes omitir la sonda y comenzar exactamente desde él:

./dumper.py --token TOKEN --start-from-id 11922524

Modo escucha

No vuelques nada; solo observa lo que llega. En el primer mensaje entrante, el script ofrecerá iniciar un volcado descendente desde ese id:

./dumper.py --token TOKEN --listen-only
Descargar herramienta

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 El kit de herramientas OSINT definitivo: grafo de investigación, puntuación de confianza, familias de alias, mapa, línea de tiempo e informes. 49 módulos, más de 400 sitios, sin necesidad de claves API.

    696
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Aplicación de Ejecución con un Solo Toque GhostLock (CVE-2026-43499)

    499
  • 3

    ARTEX

    baarai/artex

    Plataforma de pruebas de penetración autónoma multiagente basada en LLM con agentes planificadores/trabajadores, grafos de activos y de exploración, registro de tráfico MITM y reevaluación de vulnerabilidades.

    396
  • 4

    redforge

    cybersecurity91/redforge

    Kit de herramientas de red team del lado del navegador con 102 herramientas offline para reconocimiento, generación de payloads, ataques de credenciales, criptografía, codificación y elaboración de informes de compromiso.

    340
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    El sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.

    258
  • 6

    antifox

    antifox-ai/antifox

    Plataforma de pruebas de penetración autónoma con múltiples agentes de IA que ejecuta reconocimiento, descubrimiento de superficie de ataque, validación de explotación y entrega de informes respaldados por evidencia.

    257

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →