Яндекс KIT через API и MCP: 165 методов конструктора магазина и почему ссылка на оплату — это не трата

Обзор

Яндекс KIT — конструктор интернет-магазинов «всё включено»: каталог, витрина, приём заказов и оплаты в одном интерфейсе, без своего сайта и разработчика. Осенью 2026 года у него появился публичный API — ещё в бете, но уже с полноценной документацией на 165 методов и токеном, который выпускается самому себе в личном кабинете за пару кликов.

Mira подключает этот API целиком — все 165 действий — и отдаёт его в Claude через MCP. Документация Яндекс KIT устроена необычно: единого файла OpenAPI нет, зато у каждого метода есть машиночитаемая Markdown-страница с той же разметкой, которой сайт рисует таблицы полей. Мы разобрали все 165 страниц скриптом, а не вручную, и сверили таблицу вызовов с этим разбором тестом — чтобы ни один метод не потерялся и ни одно обязательное поле не забылось.

Что доступно

Почему тратящих действий нет вообще

У Авито есть платное продвижение объявлений, у ЮKassa и Модульбанка — платежи и возвраты. У Яндекс KIT в этом бета-API — ни одного. Метод get_order_payment_link отдаёт уже существующую ссылку на оплату заказа: он ничего не создаёт и не списывает, покупатель заплатит сам, когда перейдёт по ссылке, — и поэтому это чтение (GET), а не запись. Приём платежей настраивается в личном кабинете KIT через подключённого провайдера, вне этого API вовсе.

Барьер записи здесь устроен проще, чем у финансовых коннекторов: он не делит действия на «меняет» и «ещё и тратит», потому что тратящих действий у KIT просто нет. Но «меняет» всё равно 94 действия из 165 — публикация карточки товара, изменение цены, отмена заказа видны покупателю ровно так же, как публикация объявления у Авито, и требуют разрешения на запись у источника.

Два действия исключены осознанно, а не забыты

Загрузка файла (UploadFile) и видео (UploadVideo) идут через multipart/form-data, а остальные 163 вызова — обычным JSON. Сложность здесь не в формате, а в том, что нейросеть не умеет передать байты: в параметрах вызова живёт текст. Поэтому загрузка принимает содержимое ссылкой (file_url — коннектор скачивает файл сам) или строкой base64, а multipart собирает уже сам инструмент. Без этого картинку в карточку товара положить было нечем: поле media принимает идентификатор файла, а взять его было неоткуда, кроме как загрузив файл руками в кабинете.

Скачивание по ссылке идёт через тот же ограничитель исходящих запросов, что и остальные адреса, приходящие снаружи: ссылку называет нейросеть, а значит — в конечном счёте любой текст, который она прочитала. Ссылка на служебный адрес внутренней сети получит отказ, а не превратится в «картинку» в вашем магазине. Размер файла ограничен 25 мегабайтами и считается по ходу скачивания, а не по заголовку, который присылает чужой сервер.

Безвозвратное удаление — отдельно от архивирования

У товаров KIT два разных действия на прощание: archive_variant прячет товар с витрины обратимо (можно вернуть unarchive_variant), а delete_variant — «безвозвратное удаление АРХИВНОГО товара», дословно из документации. Оба под барьером записи как любое действие с методом, отличным от чтения, но необратимость delete_variant названа отдельно, чтобы не потеряться в общем списке из полутора сотен методов.

Токен — self-service, без заявок

Доступ выдаётся в личном кабинете KIT: «Настройки» → вкладка «API» → «Сгенерировать токен» — без одобрения заявки, в этом Яндекс KIT ближе к Авито и Модульбанку, чем к рекламным API с developer-ключом по заявке. Токен показывается один раз, привязан к магазину, и заголовка Authorization: Bearer хватает на все 165 действий. Лимит поставщика — 3 запроса в секунду на магазин.