Tochka Bank Skill

Скилл для Точка Банк API

Скилл для AI-агентов для работы с REST API Точка.Банк. Работает с **любым агентом, поддерживающим стандарт skills** — Claude Code, Cursor, Codex, Gemini CLI, Goose, Windsurf, Roo Code, Cline и [40+ других агентов](https://skills.sh).

Что умеет

Python CLI (только стандартная библиотека) + структурированные знания для работы с REST API Точка.Банк (developers.tochka.com).

Возможности

• Счета на оплату — создание, автозагрузка PDF, отправка на email, проверка статуса оплаты, удаление
• Закрывающие документы — акт выполненных работ, УПД, ТОРГ-12, счёт-фактура
• Полная выписка через Open Banking (асинхронный flow с polling)
• Входящие платежи — СБП и карты через эквайринг
• Платёжные поручения — создание черновиков «На подпись»
• Платёжные ссылки для интернет-эквайринга (с two-stage capture, ОФД-чеками)
• Вебхуки — регистрация HTTPS-endpoint'а для push-уведомлений, тестовая отправка
• СБП QR-коды — регистрация мерчанта, статический / динамический / cash QR
• Реестр эквайринга — суточная сверка комиссий
• Диагностика OAuth — introspection согласий (consents) при 403

Особенности реализации

• Два потока аутентификации — личный JWT (просто, для чтения + черновиков платёжек) или OAuth 2.0 + Consent (для Invoice API, закрывающих документов и полной выписки)
• Безопасное хранение секретов — macOS Keychain / Linux secret-tool / Windows Credential Manager, файловый fallback; access_token OAuth автоматически обновляется
• Интерактивные визарды init и init --oauth с проверкой TTY, подсказками по регистрации приложения и локальным HTTPS-callback сервером (поддерживает mkcert)
• Флаг --format {json,id,url} у команд create-* — получить только ID или URL в stdout для shell-пайплайнов, без jq
• Опциональный хук подтверждения для Claude Code — permission-prompt с метками [PROD] / [SANDBOX] перед каждым изменяющим вызовом
• Offline OpenAPI-спека (OpenAPI 3.1.0, Tochka.