Одна строка BOT_TOKEN = "..." в публичном репозитории отдаёт вашего бота незнакомцу, а вебхук, установленный без secret_token, позволяет любому, кто найдёт URL, отправить поддельное обновление, якобы пришедшее от вашего администратора. На стороне Mini App сервер, который берёт id пользователя из initData, не проверяя подпись, позволяет одному покупателю действовать от имени другого. Этот навык находит такие ошибки и другие перечисленные ниже ошибки Telegram-ботов и Mini Apps до развёртывания и объясняет, как исправить каждую.

Ваш агент запускает сканер для кода вашего бота и Mini App (python-telegram-bot, aiogram, pyTelegramBotAPI, Telegraf, grammY, node-telegram-bot-api и боты на PHP, а также бэкенды Mini App на Express, FastAPI и подобных фреймворках), файлов .env и конфигурации в JSON, YAML и TOML. Он пропускает комментарии, отслеживает текст из чата через простые присваивания, знает настройки вебхуков по умолчанию в каждой библиотеке (секретный путь в Telegraf, путь с токеном в node-telegram-bot-api) и типичные защиты (сравнение секретного заголовка, секретные пути, проверяющий middleware, filters.User, F.from_user.id, getChatMember, html.escape, safe_parse_webapp_init_data), учитывает список разрешённых сетей Telegram в nginx внутри проекта и проверяет тестовые папки только на токены. Он никогда не запускает бота и не обращается к Telegram. Результат: BLOCK, REVIEW или NOT FLAGGED, с указанием файла, строки, причины и более безопасного подхода. Токены никогда не выводятся.

Что проверяется

BLOCK (исправить до выпуска)

• T01: токены ботов в коде, конфигурационных файлах, файлах .env.example, URL api.telegram.org или переменных VITE_ и NEXT_PUBLIC_, которые попадают в браузер
• T02: вебхуки, установленные или обслуживаемые без секретного токена: setWebhook без secret_token, run_webhook, start_webhook, SimpleRequestHandler или webhookCallback без него, либо маршруты, которые никогда не проверяют заголовок X-Telegram-Bot-Api-Secret-Token
• T03: initData из Mini App, разобранные на сервере без использующей их проверки подписи, или initDataUnsafe, прочитанные из запроса
• T04: текст сообщения, аргументы команд или callback data, переданные в eval, exec или оболочку

REVIEW (проверить перед релизом)

• T11: админ-команды (/ban, /broadcast, /restart, /sql и подобные) без проверки пользователя
• T12: имена пользователей и текст сообщений, отправленные как HTML или Markdown без экранирования
• T13: токены ботов в логах: выведенные токены, ссылки на файлы и логирование URL запросов httpx в python-telegram-bot
• T14: pre-checkout-запросы, одобренные без проверки заказа
• T15: пути загрузки или файлов, построенные из имени файла отправителя или текста сообщения
• T16: фронтенды Mini App, которые отправляют в API id пользователей из initDataUnsafe
• T17: init data из Mini App, принимаемые любого возраста (без проверки auth_date)

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)
• Руководство по правилам с причиной, более безопасным подходом и официальным источником для каждого правила
• Рискованный и безопасный примеры проектов (бот, фронтенд и бэкенд Mini App), а также реальный отчёт сканера по рискованному

Ограничения

Сканер читает каждый файл в том виде, в каком он написан: проверки, находящиеся в другом файле (middleware, проверяющий заголовок вебхука или init data, админ-фильтр, добавленный в другом месте), правила обратного прокси, кроме списка разрешённых адресов nginx в проекте, настройки BotFather и значения, собранные из нескольких модулей, не отслеживаются. NOT FLAGGED не является гарантией.

Содержимое

Один ZIP-файл с 21 файлом: SKILL.md, сканер в scripts/ (8 файлов Python), references/rules.md (каждое правило с причиной и более безопасным подходом) и examples/ (10 файлов примеров плюс report.md, реальный результат работы сканера на рискованном примере).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить ваш проект. Скрипты также работают самостоятельно с Python 3.9 или новее, ничего устанавливать не нужно. Они только читают ваши файлы: без доступа к сети, и ничего никуда не отправляется.