Un solo BOT_TOKEN = "..." en un repositorio público entrega tu bot a un desconocido, y un webhook configurado sin secret_token permite que cualquiera que encuentre la URL envíe una actualización falsa que dice venir de tu administrador. En el lado de la Mini App, un servidor que lee el id de usuario de initData sin comprobar su firma permite que un comprador se haga pasar por otro. Esta skill encuentra esos errores y los demás errores de bots de Telegram y Mini Apps que se indican abajo antes de que despliegues, y te explica cómo corregir cada uno.

Tu agente ejecuta un escáner sobre el código de tu bot y tu Mini App (python-telegram-bot, aiogram, pyTelegramBotAPI, Telegraf, grammY, node-telegram-bot-api y bots en PHP, además de backends de Mini Apps con Express, FastAPI y similares), archivos .env y configuración en JSON, YAML y TOML. Omite los comentarios, sigue el texto del chat a través de asignaciones simples, conoce los valores por defecto de los webhooks de cada librería (la ruta secreta de Telegraf, la ruta con token de node-telegram-bot-api) y las protecciones habituales (un encabezado secreto comparado, rutas secretas, middleware de verificación, filters.User, F.from_user.id, getChatMember, html.escape, safe_parse_webapp_init_data), tiene en cuenta una lista de permitidos de nginx con las redes de Telegram en el proyecto y revisa las carpetas de pruebas solo en busca de tokens. Nunca ejecuta el bot ni contacta con Telegram. Devuelve BLOCK, REVIEW o NOT FLAGGED, con el archivo, la línea, el motivo y una alternativa más segura. Los tokens nunca se muestran.

Qué revisa

BLOCK (corregir antes de publicar)

• T01: tokens de bot en el código, archivos de configuración, archivos .env.example, URLs de api.telegram.org o variables VITE_ y NEXT_PUBLIC_ que llegan al navegador
• T02: webhooks configurados o servidos sin token secreto: setWebhook sin secret_token, run_webhook, start_webhook, SimpleRequestHandler o webhookCallback sin él, o rutas que nunca comprueban el encabezado X-Telegram-Bot-Api-Secret-Token
• T03: initData de Mini Apps parseados en el servidor sin una verificación de firma que los use, o initDataUnsafe leído de una petición
• T04: texto de mensajes, argumentos de comandos o callback data pasados a eval, exec o una shell

REVIEW (revisar antes del lanzamiento)

• T11: comandos de administración (/ban, /broadcast, /restart, /sql y similares) sin comprobación del usuario
• T12: nombres de usuario y texto de mensajes enviados como HTML o Markdown sin escapar
• T13: tokens de bot en los logs: tokens impresos, enlaces a archivos y el registro de URLs de peticiones httpx en python-telegram-bot
• T14: consultas pre-checkout aprobadas sin revisar el pedido
• T15: rutas de descarga o de archivos construidas a partir del nombre de archivo del remitente o del texto del mensaje
• T16: frontends de Mini Apps que envían a la API ids de usuario de initDataUnsafe
• T17: init data de Mini Apps aceptados sin importar su antigüedad (sin comprobar auth_date)

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar)
• Una guía de reglas con el motivo, una alternativa más segura y la fuente oficial para cada regla
• Un proyecto de ejemplo arriesgado y otro seguro (bot, frontend y backend de Mini App), y el informe real que genera el escáner sobre el arriesgado

Limitaciones

Lee cada archivo tal como está escrito: no sigue las comprobaciones que están en otro archivo (un middleware que verifica el encabezado del webhook o los init data, un filtro de administrador añadido en otro lugar), las reglas de proxy inverso aparte de una lista de permitidos de nginx en el proyecto, los ajustes de BotFather ni los valores construidos entre módulos. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 21 archivos: SKILL.md, el escáner en scripts/ (8 archivos de Python), references/rules.md (cada regla con su motivo y una alternativa más segura) y examples/ (10 archivos de ejemplo más report.md, la salida real del escáner sobre el ejemplo arriesgado).

Cómo usarlo: Es una skill para agentes: una carpeta con un archivo SKILL.md y scripts de Python que puede ejecutar un agente de programación con IA como Claude Code, Cursor o Codex CLI. Descomprímela en la carpeta de skills de tu agente (para Claude Code: ~/.claude/skills/) y luego pide a tu agente que revise tu proyecto. Los scripts también funcionan por sí solos con Python 3.9 o posterior, sin nada que instalar. Solo leen tus archivos: sin acceso a la red y sin enviar nada a ningún sitio.