Ein einziges BOT_TOKEN = "..." in einem öffentlichen Repository übergibt Ihren Bot einem Fremden, und ein ohne secret_token gesetzter Webhook erlaubt jedem, der die URL findet, ein gefälschtes Update zu senden, das angeblich von Ihrem Admin stammt. Auf der Mini-App-Seite erlaubt ein Server, der die Benutzer-ID aus initData liest, ohne deren Signatur zu prüfen, einem Käufer, als ein anderer aufzutreten. Dieser Skill findet diese und die weiteren unten aufgeführten Fehler in Telegram-Bots und Mini Apps vor dem Deployment und erklärt Ihnen, wie Sie jeden davon beheben.

Ihr Agent führt einen Scanner auf dem Code Ihres Bots und Ihrer Mini App aus (python-telegram-bot, aiogram, pyTelegramBotAPI, Telegraf, grammY, node-telegram-bot-api und PHP-Bots sowie Mini-App-Backends mit Express, FastAPI und Ähnlichem), auf .env-Dateien und auf Konfiguration in JSON, YAML und TOML. Er überspringt Kommentare, verfolgt Chat-Text über einfache Zuweisungen, kennt die Webhook-Standards jeder Bibliothek (den geheimen Pfad von Telegraf, den Token-Pfad von node-telegram-bot-api) und die üblichen Schutzmaßnahmen (ein verglichener Secret-Header, geheime Pfade, verifizierende Middleware, filters.User, F.from_user.id, getChatMember, html.escape, safe_parse_webapp_init_data), berücksichtigt eine nginx-Allowlist der Telegram-Netze im Projekt und prüft Testordner nur auf Tokens. Er führt den Bot nie aus und kontaktiert Telegram nicht. Er liefert BLOCK, REVIEW oder NOT FLAGGED, mit Datei, Zeile, Begründung und einem sichereren Ansatz. Tokens werden nie ausgegeben.

Was geprüft wird

BLOCK (vor dem Ausliefern beheben)

• T01: Bot-Tokens in Code, Konfigurationsdateien, .env.example-Dateien, api.telegram.org-URLs oder VITE_- und NEXT_PUBLIC_-Variablen, die an den Browser ausgeliefert werden
• T02: Webhooks, die ohne Secret-Token gesetzt oder bedient werden: setWebhook ohne secret_token, run_webhook, start_webhook, SimpleRequestHandler oder webhookCallback ohne eines, oder Routen, die den Header X-Telegram-Bot-Api-Secret-Token nie prüfen
• T03: Mini-App-initData, die auf dem Server ohne eine sie nutzende Signaturprüfung geparst werden, oder initDataUnsafe, das aus einer Anfrage gelesen wird
• T04: Nachrichtentext, Befehlsargumente oder Callback-Daten, die an eval, exec oder eine Shell übergeben werden

REVIEW (vor dem Release prüfen)

• T11: Admin-Befehle (/ban, /broadcast, /restart, /sql und ähnliche) ohne Benutzerprüfung
• T12: Benutzernamen und Nachrichtentext, die ohne Escaping als HTML oder Markdown gesendet werden
• T13: Bot-Tokens in Logs: ausgegebene Tokens, Dateilinks und das Logging von httpx-Request-URLs in python-telegram-bot
• T14: Pre-Checkout-Anfragen, die genehmigt werden, ohne die Bestellung anzusehen
• T15: Download- oder Dateipfade, die aus dem Dateinamen des Absenders oder aus Nachrichtentext gebildet werden
• T16: Mini-App-Frontends, die Benutzer-IDs aus initDataUnsafe an die API senden
• T17: Mini-App-Init-Daten, die unabhängig von ihrem Alter akzeptiert werden (keine auth_date-Prüfung)

Was enthalten ist

• Der Scanner (Python 3.9+, nur Standardbibliothek)
• Ein Regelleitfaden mit Begründung, sichererem Ansatz und offizieller Quelle für jede Regel
• Ein riskantes und ein sicheres Beispielprojekt (Bot, Mini-App-Frontend und Backend) sowie der echte Bericht, den der Scanner für das riskante erzeugt

Grenzen

Er liest jede Datei so, wie sie geschrieben ist: Prüfungen in einer anderen Datei (eine Middleware, die den Webhook-Header oder die Init-Daten verifiziert, ein anderswo hinzugefügter Admin-Filter), Reverse-Proxy-Regeln außer einer nginx-Allowlist im Projekt, BotFather-Einstellungen und modulübergreifend zusammengesetzte Werte werden nicht verfolgt. NOT FLAGGED ist keine Garantie.

Inhalt

Eine ZIP-Datei mit 21 Dateien: SKILL.md, der Scanner in scripts/ (8 Python-Dateien), references/rules.md (jede Regel mit Begründung und sichererem Ansatz) und examples/ (10 Beispieldateien plus report.md, die echte Scanner-Ausgabe für das riskante Beispiel).

So verwenden Sie es: Dies ist ein Agent-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Coding-Agent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacken Sie ihn in den Skills-Ordner Ihres Agenten (für Claude Code: ~/.claude/skills/) und bitten Sie Ihren Agenten dann, Ihr Projekt zu prüfen. Die Skripte laufen auch eigenständig mit Python 3.9 oder neuer, ohne dass etwas installiert werden muss. Sie lesen nur Ihre Dateien: kein Netzwerkzugriff, und nichts wird irgendwohin gesendet.