Один рядок 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 або новішим, нічого встановлювати не потрібно. Вони лише читають ваші файли: без доступу до мережі, і нічого нікуди не надсилається.