Un seul BOT_TOKEN = "..." dans un dépôt public livre votre bot à un inconnu, et un webhook configuré sans secret_token permet à quiconque trouve l'URL d'envoyer une fausse mise à jour prétendant venir de votre administrateur. Côté Mini App, un serveur qui lit l'id utilisateur dans initData sans vérifier sa signature permet à un acheteur de se faire passer pour un autre. Cette skill détecte ces erreurs et les autres erreurs de bots Telegram et de Mini Apps listées ci-dessous avant le déploiement, et vous indique comment corriger chacune d'elles.

Votre agent exécute un scanner sur le code de votre bot et de votre Mini App (python-telegram-bot, aiogram, pyTelegramBotAPI, Telegraf, grammY, node-telegram-bot-api et bots PHP, ainsi que les backends de Mini Apps sous Express, FastAPI et similaires), les fichiers .env et la configuration JSON, YAML et TOML. Il ignore les commentaires, suit le texte du chat à travers des affectations simples, connaît les valeurs par défaut des webhooks de chaque bibliothèque (le chemin secret de Telegraf, le chemin avec token de node-telegram-bot-api) et les protections habituelles (un en-tête secret comparé, des chemins secrets, un middleware de vérification, filters.User, F.from_user.id, getChatMember, html.escape, safe_parse_webapp_init_data), tient compte d'une liste d'autorisation nginx des réseaux Telegram dans le projet et ne vérifie les dossiers de test que pour les tokens. Il n'exécute jamais le bot et ne contacte pas Telegram. Il renvoie BLOCK, REVIEW ou NOT FLAGGED, avec le fichier, la ligne, la raison et une approche plus sûre. Les tokens ne sont jamais affichés.

Ce qui est vérifié

BLOCK (à corriger avant la mise en ligne)

• T01 : tokens de bot dans le code, les fichiers de configuration, les fichiers .env.example, les URL api.telegram.org ou les variables VITE_ et NEXT_PUBLIC_ envoyées au navigateur
• T02 : webhooks configurés ou servis sans token secret : setWebhook sans secret_token, run_webhook, start_webhook, SimpleRequestHandler ou webhookCallback sans token, ou routes qui ne vérifient jamais l'en-tête X-Telegram-Bot-Api-Secret-Token
• T03 : initData de Mini App parsées sur le serveur sans vérification de signature qui les utilise, ou initDataUnsafe lues depuis une requête
• T04 : texte de message, arguments de commande ou callback data passés à eval, exec ou un shell

REVIEW (à contrôler avant la publication)

• T11 : commandes d'administration (/ban, /broadcast, /restart, /sql et similaires) sans vérification de l'utilisateur
• T12 : noms d'utilisateur et texte de message envoyés en HTML ou en Markdown sans échappement
• T13 : tokens de bot dans les logs : tokens affichés, liens vers des fichiers et journalisation des URL de requêtes httpx dans python-telegram-bot
• T14 : requêtes pre-checkout approuvées sans examiner la commande
• T15 : chemins de téléchargement ou de fichiers construits à partir du nom de fichier de l'expéditeur ou du texte du message
• T16 : front-ends de Mini App qui envoient à l'API des id utilisateur issus d'initDataUnsafe
• T17 : init data de Mini App acceptées quel que soit leur âge (pas de vérification d'auth_date)

Ce qui est inclus

• Le scanner (Python 3.9+, bibliothèque standard uniquement)
• Un guide des règles avec la raison, une approche plus sûre et la source officielle pour chaque règle
• Un projet d'exemple à risque et un projet sûr (bot, front-end et backend de Mini App), ainsi que le rapport réel produit par le scanner sur le projet à risque

Limites

Il lit chaque fichier tel qu'il est écrit : les contrôles situés dans un autre fichier (un middleware qui vérifie l'en-tête du webhook ou les init data, un filtre d'administration ajouté ailleurs), les règles de reverse proxy autres qu'une liste d'autorisation nginx dans le projet, les paramètres de BotFather et les valeurs construites à travers plusieurs modules ne sont pas suivis. NOT FLAGGED n'est pas une garantie.

Contenu

Un fichier ZIP de 21 fichiers : SKILL.md, le scanner dans scripts/ (8 fichiers Python), references/rules.md (chaque règle avec sa raison et une approche plus sûre) et examples/ (10 fichiers d'exemple plus report.md, la sortie réelle du scanner sur l'exemple à risque).

Mode d'emploi : Il s'agit d'une skill pour agent : un dossier contenant un fichier SKILL.md et des scripts Python qu'un agent de programmation IA comme Claude Code, Cursor ou Codex CLI peut exécuter. Décompressez-le dans le dossier des skills de votre agent (pour Claude Code : ~/.claude/skills/), puis demandez à votre agent de vérifier votre projet. Les scripts fonctionnent aussi seuls avec Python 3.9 ou une version plus récente, sans rien à installer. Ils se contentent de lire vos fichiers : aucun accès réseau, et rien n'est envoyé nulle part.