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

Обзор

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

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

Что доступно

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

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

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

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

Загрузка файла (UploadFile) и загрузка видео (UploadVideo) идут через multipart/form-data — а все остальные 163 вызова этой таблицы уходят обычным JSON. Инструмент, который обещает multipart-загрузку, но умеет отправлять только JSON, не сработает ни разу — это хуже, чем прямо сказать, что действия нет. Поэтому загрузка бинарного файла исключена явно, с указанием причины, а не тихо забыта. Загрузка видео по ссылке (UploadVideoFromUrl) — не multipart, KIT сам скачивает файл по URL, — и она в таблице есть.

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

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

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

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

Живая проверка

Живых ключей от боевого личного кабинета Яндекс KIT нет — раздел появится, когда владелец магазина их даст. Разбор адреса и тела, барьер записи и Bearer-заголовок проверены против собственного HTTP-сервера в тестах (перехват на транспорте — тот же приём, что у Авито, Модульбанка и ЮKassa), а не против api.kit.yandex.net.