# Сравнение с другими инструментами (/ru/docs/max/compare)

Сравните инструменты Telegram по задачам, вариантам подключения и лицензиям, чтобы выбрать подходящий.

Для MAX есть другие открытые инструменты. Эта страница ставит `max` рядом с пятью из них и сравнивает по задачам:
что вы можете сделать. По таблице видно, какой инструмент подходит под вашу работу. Отметки для `max` проверены по его
коду. Отметки для остальных взяты из документации и исходного кода их проектов, на 24 октября 2026.
Инструмент может уметь больше, чем описано в его документации.

Инструменты:

* **max**: этот инструмент. Командная строка и MCP-сервер для вашего аккаунта MAX и для ваших ботов.
* **[PyMax](https://github.com/MaxApiTeam/PyMax)**: библиотека на Python для личного аккаунта.
* **[tsmax](https://github.com/sibstark/tsmax)** (`@bruch/max-client`): библиотека на TypeScript для Bun, личный
  аккаунт.
* **[max-mcp](https://github.com/renosaza/max-mcp)**: MCP-сервер на PyMax, личный аккаунт, 8 инструментов.
* **[mcp-max-messenger](https://github.com/woyaxnini/mcp-max-messenger)**: MCP-сервер на официальном Bot API,
  21 инструмент.
* **[Bot API MAX](https://dev.max.ru/docs-api)** и его SDK: единственный официальный программный доступ. Работает
  от имени бота, не вашего аккаунта.

✅ да · 🟡 частично · ❌ нет · ➖ не описано в документации

Личный аккаунт работает через неофициальный протокол MAX. Официальный Bot API используют `max bot`[↗](/llms.mdx/docs/ru/max/commands-bot/content.md#max-bot "Справочник команды: max bot"),
mcp-max-messenger и официальные SDK.

## Что можно сделать [#что-можно-сделать]

В таблице: **max**, [PyMax](https://github.com/MaxApiTeam/PyMax), [tsmax](https://github.com/sibstark/tsmax),
[max-mcp](https://github.com/renosaza/max-mcp),
[mcp-max-messenger](https://github.com/woyaxnini/mcp-max-messenger), [Bot API](https://dev.max.ru/docs-api).

| Задача | max | PyMax | tsmax | max-mcp | mcp-max-messenger | Bot API |
| --- | :-: | :---: | :---: | :---: | :---: | :---: |
| **Разобрать накопившееся** | | | | | | |
| Увидеть непрочитанное во всех чатах одним запросом, не помечая его прочитанным |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| Узнать, кому вы не ответили и какие обещания висят |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| **Ответить и отправить** | | | | | | |
| Ответить, исправить, удалить, переслать сообщение |  ✅ |   ✅ |   ✅ |    🟡 |         🟡 |    ✅ |
| Отправить фото или файл |  ✅ |   ✅ |   ✅ |    ✅ |         🟡 |    ✅ |
| Отправить несколько фото одним сообщением |  ✅ |   ✅ |   ✅ |    ❌ |         ➖ |    ➖ |
| **Найти** | | | | | | |
| Найти сообщение в одном чате или во всех, на сервере MAX |  ✅ |   ➖ |   ❌ |    🟡 |         ❌ |    ❌ |
| Найти сообщение по смыслу, а не по словам |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| Искать без интернета по локальной копии |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| Найти присланный файл по имени, типу или тексту внутри (PDF, документ, скан) |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| **Файлы и голос** | | | | | | |
| Превратить голосовое в текст на вашем компьютере |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| Выгрузить чат в JSONL или Markdown, сделать зашифрованную копию |  ✅ |   ❌ |   ❌ |    🟡 |         ❌ |    ❌ |
| **Группы и каналы** | | | | | | |
| Создать группу, добавить людей, назначить админов |  ✅ |   ✅ |   🟡 |    ❌ |         🟡 |    🟡 |
| Посмотреть заявки на вступление, принять или отклонить |  ✅ |   ✅ |   ✅ |    ❌ |         ➖ |    ➖ |
| Обзор группы или канала за период: сообщения, активные люди, новички, ушедшие |  ✅ |   ❌ |   ❌ |    🟡 |         ❌ |    ➖ |
| Комментарии под постами канала |  🟡 |   ➖ |   ❌ |    ❌ |         ❌ |    ✅ |
| **Бот и автоматизация** | | | | | | |
| Писать от имени вашего бота из того же инструмента |  ✅ |   ❌ |   ❌ |    ❌ |         ✅ |    ✅ |
| Утренняя сводка по расписанию и автоответы |  ✅ |   ❌ |   ❌ |    ❌ |         ❌ |    ❌ |
| **Агенты и безопасность** | | | | | | |
| Агент читает и пишет в MAX через MCP |  ✅ |   ❌ |   ❌ |    ✅ |         ✅ |    ❌ |
| Агент с терминалом работает без MCP: навык объясняет команды |  ✅ |   ❌ |   ❌ |    🟡 |         ❌ |    ❌ |
| Ограничить агента только чтением |  ✅ |   ➖ |   ➖ |    ❌ |         ❌ |    ➖ |
| Настраиваемое подтверждение перед отправкой |  ✅ |   ➖ |   ➖ |    ❌ |         ❌ |    ➖ |
| Разрешить отправку только в список чатов |  ✅ |   ➖ |   ➖ |    ❌ |         ❌ |    ➖ |
| Ограничить число отправок в час |  ✅ |   ➖ |   ➖ |    ❌ |         ❌ |    ➖ |
| Повтор поддерживаемой отправки с тем же идентификатором операции |  ✅ |   ➖ |   ➖ |    ❌ |         ❌ |    ➖ |
| Токен лежит в ключнице системы, а не в файле (если ключницы нет, `max` пишет файл с правами 0600) |  ✅ |   ❌ |   ❌ |    🟡 |         🟡 |    ➖ |

**Ответить и отправить.** В `max` для альбома повторите `--photo`. Несколько файлов `--file` уходят отдельными сообщениями, видео и файл
нельзя смешивать с другими вложениями. У max-mcp нет изменения и удаления сообщений. У mcp-max-messenger нет пересылки,
а файлы уходят по ссылке.

**Найти.** У max-mcp поиск простой: по подстроке, и каждый вызов читает историю одного чата. У PyMax поиск по серверу назван в
списке кодов операций, а в документации его нет. Поиск по картинкам по тому, что на них видно, `max` умеет с моделью на
вашем компьютере. Её нужно включить отдельно.

**Файлы и голос.** У max-mcp выгрузка только для каналов, до 1000 постов за вызов.

**Группы и каналы.** У mcp-max-messenger и Bot API группы только те, где есть бот. У tsmax нет назначения админов. Обзор в `max` считается
по локальной копии, вход и выход людей `max` спрашивает у MAX. У max-mcp есть реакции и статистика постов канала, но не
обзор группы. Комментарии под постами `max` умеет только от имени бота, в личном аккаунте их нет. На все заявки на вступление в канал
`max` может ответить разом; отобрать заявки по ссылке-приглашению нельзя: MAX не сообщает, по какой ссылке пришла заявка.

**Агенты и безопасность.** Здесь PyMax, tsmax и Bot API получают ➖ там, где защиту должен написать автор программы: это библиотеки, готовых
настроек у них нет.
MCP-сервер `max` отдаёт агенту три инструмента: поиск команды, чтение и запись. Через них доступны выпущенные команды в пределах прав профиля, включая запись.
Права профиля действуют и для MCP. Для бота есть отдельный сервер. Вход и выход и команды, которые работают
без остановки (`watch`[↗](/llms.mdx/docs/ru/max/commands-setup/content.md#max-watch "Справочник команды: max watch"), `serve`[↗](/llms.mdx/docs/ru/max/commands-setup/content.md#max-serve "Справочник команды: max serve")), в MCP не предлагаются. Команды, которыми агент мог бы снять свои же ограничения
(список разрешённых чатов, права, автоответы, расписания), остаются в его списке команд с пометкой «недоступна»;
выполнить их позволяет `permissions.mcp.authority`, по умолчанию он `deny`. Сырые операции бота отдельно требуют `permissions.bot.api: allow` или `ask`. Подробнее в
[руководстве по MCP](/llms.mdx/docs/ru/max/mcp/content.md). Отправку определяют права профиля и настройки подтверждения в приложении агента; своей формы подтверждения у MCP нет. Настройте их до подключения агента. Лимит
по умолчанию: 30 отправок в час на профиль, в ошибке сказано, когда можно снова. У max-mcp одно ограничение: список
разрешённых папок для файлов. У max-mcp токен лежит в файле с правами 0600, у mcp-max-messenger это переменная
окружения `MAX_TOKEN`. У PyMax и tsmax токен в файле сессии `session.db`.

## Установка и лицензия [#установка-и-лицензия]

| Обязательность | max | PyMax | tsmax | max-mcp | mcp-max-messenger | Bot API |
| --- | --- | --- | --- | --- | --- | --- |
| Установка | npm, pnpm, Bun | библиотека Python | библиотека, только Bun | git, `uv` и скрипт входа | `npx` | SDK |
| MCP | stdio и HTTP, для агентов в браузере | нет | нет | stdio | stdio и HTTP | нет |
| Лицензия | Apache-2.0 | MIT | MIT | MIT | MIT с Commons Clause | бесплатно, только для проверенных организаций, ИП и самозанятых |

`max` нужен Node 22.16+ или 24+, либо Bun 1.3+. Установщика без Node пока нет. Агент в браузере, который управляет
`web.max.ru`, работает через интерфейс и вход в браузере. `max` обращается к MAX напрямую из командной строки, а
браузер нужен ему только для входа по QR-коду или SMS.

## Когда лучше другой инструмент [#когда-лучше-другой-инструмент]

* **Приложение MAX** ([web.max.ru](https://web.max.ru), десктоп, телефон): вам нужны звонки, кружки, статусы набора
  текста и никакой настройки. Приложение официальное, и правила MAX к нему не придираются.
* **PyMax или tsmax**: вы пишете свою программу и вам нужен файл вместе с фото и видео в одном
  сообщении (tsmax) или кружки (PyMax).
* **Bot API и mcp-max-messenger**: вы делаете официального бота для организации или нужен MCP-сервер только для бота,
  который запускается одной командой `npx`. Это единственный официальный путь, и он не нарушает правил MAX. Комментарии
  под постами канала там тоже есть.

## Откуда отметки [#откуда-отметки]

Отметки для остальных инструментов взяты из этих файлов, версии зафиксированы:
[PyMax](https://github.com/MaxApiTeam/PyMax/blob/53103f0/README.md),
[его чаты](https://github.com/MaxApiTeam/PyMax/blob/53103f0/src/pymax/api/chats/service.py) и
[сообщения](https://github.com/MaxApiTeam/PyMax/blob/53103f0/src/pymax/api/messages/service.py),
[tsmax](https://github.com/sibstark/tsmax/blob/fa3652f/README.md) и
[его API](https://github.com/sibstark/tsmax/tree/fa3652f/src/api),
[max-mcp](https://github.com/renosaza/max-mcp/blob/26eaf70/README.md) и
[его инструменты](https://github.com/renosaza/max-mcp/blob/26eaf70/docs/TOOLS.md),
[mcp-max-messenger](https://github.com/woyaxnini/mcp-max-messenger/blob/4a3233a/README.md) и
[его лицензия](https://github.com/woyaxnini/mcp-max-messenger/blob/4a3233a/LICENSE),
[Bot API](https://dev.max.ru/docs-api). Для `max` каждая отметка проверена по его коду: все команды перечислены в
[commands.md](/llms.mdx/docs/ru/max/commands/content.md).

Если `max` вам подходит, начните с [установки](/llms.mdx/docs/ru/max/installation/content.md). Чтобы подключить агента без терминала, см.
[MCP-сервер](/llms.mdx/docs/ru/max/mcp/content.md).