MAX API Python: пишем бота с нуля — pip install maxapi, код, деплой

Меня зовут Павел Гордеев, и сегодня — MAX API Python: пишем бота для мессенджера MAX с нуля.

После блокировки Telegram в России в апреле 2026 года интерес к MAX резко вырос. Мессенджер от VK Group — с сентября 2025 предустановлен на все смартфоны в России, уже 100+ млн пользователей. Разработчики активно переезжают с aiogram. Разберём что за библиотеки есть, как их установить и как написать первого бота.

Важное ограничение перед стартом

Прежде чем писать код — ключевой факт: регистрация бота на платформе MAX доступна только для юридических лиц и ИП-резидентов РФ. Это официальное требование платформы (dev.max.ru).

Физическому лицу бота не зарегистрировать — нужен ИП или ООО. Если есть — продолжаем.

Три библиотеки MAX API для Python

Библиотека	pip install	Тип	Статус
max-botapi-python	pip install max-botapi-python	Официальная	Активно развивается
maxapi	pip install maxapi	Сообщество	Популярная, активная
aiomax	pip install aiomax	Сообщество	Асинхронная

Сначала разберём maxapi — она чаще всего встречается в поиске и имеет лучшую документацию от сообщества.

Установка maxapi

mkdir max-bot
cd max-bot
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install maxapi python-dotenv

Проверь установку:

pip show maxapi

Файл .env:

MAX_TOKEN=ВАШ_ТОКЕН_БОТА_MAX

Токен получается при регистрации бота в личном кабинете dev.max.ru (требуется ИП/юрлицо).

Первый бот на maxapi: echo-бот

from dotenv import load_dotenv
import os
from maxapi import Bot, types

load_dotenv()
bot = Bot(token=os.environ["MAX_TOKEN"])

@bot.on.message()
async def echo_handler(message: types.Message):
    await message.answer(f"Ты написал: {message.text}")

bot.run_forever()

Запусти:

python bot.py

Если токен верный — бот начнёт принимать сообщения.

Обработка команд и ключевых слов

@bot.on.message(text=["/start", "начать", "старт"])
async def start_handler(message: types.Message):
    await message.answer(
        "Привет! Я бот на MAX.\n\n"
        "Доступные команды:\n"
        "• /help — помощь\n"
        "• /price — цены\n"
    )

@bot.on.message(text=["/help", "помощь"])
async def help_handler(message: types.Message):
    await message.answer("Напиши /price чтобы узнать цены, или задай вопрос — отвечу.")

@bot.on.message(text=["/price", "цена", "стоимость"])
async def price_handler(message: types.Message):
    await message.answer("Наши услуги:\n• Услуга А — от 1000 руб\n• Услуга Б — от 2500 руб")

@bot.on.message()
async def fallback_handler(message: types.Message):
    await message.answer("Не понял. Напиши /help для списка команд.")

Клавиатуры и кнопки в MAX

from maxapi import Bot, types
from maxapi.types import InlineKeyboardMarkup, InlineKeyboardButton

bot = Bot(token=os.environ["MAX_TOKEN"])

def get_main_keyboard():
    keyboard = InlineKeyboardMarkup(inline_keyboard=[
        [
            InlineKeyboardButton(text="💰 Цены", callback_data="price"),
            InlineKeyboardButton(text="📝 Записаться", callback_data="booking"),
        ],
        [
            InlineKeyboardButton(text="❓ Вопрос", callback_data="question"),
        ]
    ])
    return keyboard

@bot.on.message(text=["/start", "начать"])
async def start_handler(message: types.Message):
    await message.answer(
        "Добро пожаловать! Выберите действие:",
        reply_markup=get_main_keyboard()
    )

@bot.on.callback_query(data="price")
async def price_callback(callback: types.CallbackQuery):
    await callback.message.answer("Наши цены: ...")
    await callback.answer()

@bot.on.callback_query(data="booking")
async def booking_callback(callback: types.CallbackQuery):
    await callback.message.answer("Для записи напишите имя и желаемую дату.")
    await callback.answer()

Официальная библиотека max-botapi-python

Официальная библиотека от команды MAX:

pip install max-botapi-python

from max_botapi import BotApi
import asyncio

TOKEN = "ВАШ_ТОКЕН"

async def main():
    api = BotApi(TOKEN)
    # Получить информацию о боте
    me = await api.get_me()
    print(f"Бот: {me.name}, ID: {me.user_id}")

asyncio.run(main())

Официальная библиотека ближе к «чистому» API без высокоуровневых абстракций — подходит если нужен полный контроль над запросами.

Библиотека aiomax

aiomax — полностью асинхронная альтернатива:

pip install aiomax

import aiomax
import asyncio

bot = aiomax.Bot("ВАШ_ТОКЕН")

@bot.on_message
async def handler(message):
    await bot.send_message(message.chat.chat_id, f"Ответ: {message.text}")

asyncio.run(bot.polling())

Сравнение трёх библиотек

	maxapi	aiomax	max-botapi-python
Установка	pip install maxapi	pip install aiomax	pip install max-botapi-python
Документация	Хорошая	Базовая	Официальная
Декораторы	Да	Да	Нет (низкоуровневая)
FSM	Встроенный	Нет	Нет
Похожа на	vkbottle / aiogram	aiogram	requests
Для новых проектов	✅ Рекомендую	Можно	Для нестандартных задач

Деплой на VPS

Процесс такой же как для VK-бота. Читай Деплой бота на сервер: systemd и nginx — шаги идентичны.

Кратко:

# requirements.txt
maxapi
python-dotenv

# systemd unit — замени пути под свой проект
# /etc/systemd/system/max-bot.service
[Unit]
Description=MAX Bot
After=network.target

[Service]
User=user
WorkingDirectory=/home/user/max-bot
EnvironmentFile=/home/user/max-bot/.env
ExecStart=/home/user/max-bot/.venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable max-bot
sudo systemctl start max-bot

FAQ

Что такое maxapi для Python?

maxapi — Python-библиотека для разработки ботов в мессенджере MAX (от VK Group). Устанавливается командой pip install maxapi. По архитектуре похожа на vkbottle и aiogram: декораторы для обработчиков, FSM, асинхронность.

pip install maxapi — что это и зачем?

pip install maxapi — команда установки Python-библиотеки для MAX Bot API. После установки можно писать ботов для мессенджера MAX: принимать сообщения, отвечать, добавлять кнопки.

Чем отличается maxapi от официальной библиотеки max-botapi-python?

maxapi — высокоуровневый фреймворк с декораторами и FSM, удобен для разработки ботов. max-botapi-python — официальная низкоуровневая обёртка над HTTP API, без высокоуровневых абстракций. Для большинства задач удобнее maxapi.

Можно ли использовать aiogram для ботов MAX?

Нет. aiogram работает только с Telegram Bot API. Для MAX нужны отдельные библиотеки: maxapi, aiomax или max-botapi-python.

Создание бота в MAX на Python — с чего начать если нет ИП?

Официально — никак: MAX требует ИП или юрлицо для регистрации бота. Если хочешь разрабатывать для других — можно использовать тестовый токен через аккаунт клиента.

Чем MAX Bot API отличается от VK Bot API?

MAX — отдельная платформа с собственным API. VK Bot API работает через сообщества ВКонтакте. Несмотря на общую компанию-владельца (VK Group), API разные и несовместимы. Сравнение платформ — в статье MAX vs VK: где запустить бота в 2026.

Что дальше

• Библиотеки для ботов MAX: обзор trёх вариантов — более подробный обзор
• MAX vs VK: где реально запустить бота в 2026 — сравнение платформ
• Как хранить токен VK/MAX API безопасно — .env и продакшн-хранение
• Деплой бота на VPS — systemd и автозапуск