Kay0k1/telegram-dev

**Русский · English**
Русский
**Дайте своему AI-агенту документацию Telegram и правила, как по ней разрабатывать.**
Telegram Dev — открытый скилл и MCP-сервер для **Codex, Claude Code и Cursor**. Он помогает агенту выбрать подходящий API, проверить актуальные возможности Telegram и реализовать именно то поведение, которое вы попросили.
«Сделай красную кнопку», «добавь premium emoji», «отправляй видео кружком» — такие задачи требуют проверки конкретного API, формата и ограничений. Telegram Dev задаёт агенту этот порядок работы и даёт инструменты для поиска официальных источников.
Скачать релиз · Сообщить об ошибке · Инструкции скилла
> **Статус: public preview.** Независимый проект сообщества. Документация загружается по запросу; качество ответа зависит и от агента. Проект не связан с Telegram и не является его официальным продуктом.
**Навигация:** Установка · Примеры · Возможности · Как работает · Обновление · Проблемы · Разработка
Быстрый старт
Понадобятся uv и папка проекта, в котором вы работаете с агентом. Для получения публичной документации **не нужны токен бота, Telegram-аккаунт или платный сервис поиска**. Для первой загрузки страниц нужен интернет.
**1. Скачайте Telegram Dev.** Клонируйте репозиторий или распакуйте ZIP со страницы релизов.
**2. Выполните одну команду для своего агента.** Замените путь в кавычках на полный путь к существующему рабочему проекту. Команду запускайте из папки Telegram Dev.
| Агент | Значение --agent | Что устанавливается в рабочий проект |
| --- | --- | --- |
| Codex | codex | MCP в .codex/config.toml, скилл в .agents/skills/telegram-dev |
| Claude Code | claude | MCP в .mcp.json, скилл в .claude/skills/telegram-dev |
| Cursor | cursor | MCP в .cursor/mcp.json, скилл в .cursor/skills/telegram-dev |
На Windows путь выглядит, например, так: --project "C:\Users\you\Projects\my-bot".
Установщик подключает MCP и копирует скилл. Посторонние настройки сохраняются, для существующего файла конфигурации создаётся резервная копия. Повторная установка поверх существующего подключения или скилла останавливается с объяснением.
**3. Откройте новую сессию агента.** Разрешите подключение проектного MCP, если приложение запросит это. В Codex проект должен быть доверенным. Оставьте папку Telegram Dev и её .venv на месте: подключение использует абсолютные пути к ним. На другой машине установщик нужно запустить заново.
**4. Дайте первое задание.** Например:
> Используй telegram-dev. Проверь состояние базы, загрузи актуальную документацию Bot API и найди, как сделать красную inline-кнопку с custom emoji. Прочитай требования и покажи ссылки на источники. Пока ничего не отправляй в Telegram.
При первом запуске база пустая — это ожидаемо. Агент должен проверить telegram_corpus_status, получить страницу через get_telegram_document и найти нужные разделы через search_telegram_docs.
Альтернатива: каталог Claude Code
Если uv доступен приложению, выполните внутри Claude Code:
Затем выполните предложенную приложением перезагрузку или откройте новую сессию. Имя скилла в плагине — /telegram-dev:telegram-dev.
Это собственный каталог проекта на GitHub. Выберите каталог **или** установщик выше, чтобы не создавать два подключения.
Альтернатива: каталог Codex
В Codex CLI с поддержкой плагинов:
Этот каталог проекта устанавливает скилл и локальный MCP; нужен uv. Он ещё не входит в официальную выдачу Codex. Для официальной подачи отдельно подготовлен **Telegram Dev Skill**: инструкции и справочники, которые используют уже доступные агенту инструменты проверки источников. Сервер ему не нужен. Пакет и порядок подачи.
Что попросить у агента
Примеры можно копировать и адаптировать к своему проекту.
**Кнопки и custom emoji**
> Используй telegram-dev. В существующем боте сделай кнопку «Удалить» красной и добавь custom emoji. Проверь текущий Bot API, ограничения для этого бота и поддержку полей нашей библиотекой. Внеси изменения в код и укажи, что проверено локально, а что нужно проверить в Telegram.
**Голосовые и кружки**
> Используй telegram-dev. Этот ролик должен отправляться как кружок. Проверь метод API и требования к файлу, доработай подготовку и отправку. Сохрани существующий стек проекта.
**Mini Apps**
> Используй telegram-dev. Проверь авторизацию нашей Mini App: как сервер проверяет initData, срок его действия и ошибки. Исправь найденные проблемы по официальной документации.
**Обновления Telegram**
> Используй telegram-dev. Найди официальные изменения Bot API, которые затрагивают клавиатуры и эмодзи. Сопоставь их с установленной версией нашей библиотеки и объясни, какие изменения нужны в проекте. Приведи источники и версии.