Claude API интеграция с Яндекс Лавкой: один разработчик собрал MCP-сервер за вечер

Проект неофициальный и использует тот же приватный веб-API, что и сайт lavka.yandex.ru. Автор опубликовал код на GitHub под лицензией MIT. Это значит, что любой разработчик может повторить интеграцию, но с оговорками: Яндекс может в любой момент изменить или закрыть доступ, а оформление заказа списывает реальные деньги.

Сам факт, что claude api интеграция с закрытым российским сервисом собрана одним человеком за вечер, показывает, насколько протокол MCP упростил подключение внешних инструментов к ИИ-ассистентам.

Что такое MCP и почему он здесь ключевой?

MCP (Model Context Protocol, протокол подключения внешних инструментов к языковой модели) работает так: вы описываете набор функций, например search_products, add_to_cart, checkout_preview, и модель сама вызывает нужную функцию по ходу диалога.

Задача автора свелась к двум вещам:

• Научиться общаться с бэкендом Лавки, у которого нет документации
• Завернуть это общение в аккуратные инструменты, которые не дадут модели случайно потратить ваши деньги

Что понадобится

• Claude Desktop или другой клиент с поддержкой MCP
• Python 3.10+ и менеджер зависимостей (pip или uv)
• Залогиненный аккаунт Яндекса с подключённой Лавкой и сохранённым адресом доставки
• Куки сессии из браузера (Session_id и сопутствующие)
• Примерно 30 минут на установку и настройку
• Готовность к тому, что заказ спишет реальные деньги с привязанной карты

Пошаговая инструкция

1. Клонируйте репозиторий с GitHub:

git clone https://github.com/Dudude-bit/yandex-lavka-mcp.git
cd yandex-lavka-mcp

1. Установите зависимости. Автор использует Python, достаточно стандартного pip:

pip install -r requirements.txt

1. Извлеките куки сессии из браузера. Откройте lavka.yandex.ru в Chrome, зайдите в DevTools (F12), вкладка Application, раздел Cookies. Скопируйте значения Session_id и связанных кук.

2. Пропишите куки в конфигурации MCP-сервера. Сервер при старте обращается к главной странице Лавки и с помощью регулярного выражения вытаскивает CSRF-токен (токен защиты от подделки запросов) из HTML:

_CSRF_RE = re.compile(r'"csrfToken"\s*:\s*"([^"]+)"')

async def _ensure_csrf(self, *, force=False):
    if self._csrf_token and not force:
        return
    resp = await self._client.get("/")
    m = _CSRF_RE.search(resp.text)
    if m:
        self._csrf_token = m.group(1)

Без этого токена и набора специальных заголовков (X-CSRF-Token, X-Lavka-Web-City, X-Lavka-Web-Locale и других) сервер Лавки возвращает ошибку 401, даже если куки корректны.

1. Подключите MCP-сервер к Claude Desktop через стандартную конфигурацию MCP-клиента. После подключения Claude получает доступ к инструментам: поиск товаров, добавление в корзину, предпросмотр заказа, подтверждение.

2. Проверьте работу простым запросом. Напишите Claude что-то вроде «найди молоко в Лавке». Если интеграция настроена верно, модель вызовет search_products и вернёт список товаров с ценами.

3. Оформление заказа работает в два шага, и это принципиально. Сначала checkout_preview показывает итог (товары, скидки, стоимость доставки, время), но ничего не списывает. Затем confirm_order оформляет заказ, но только если сумма совпадает с превью. Если между двумя вызовами корзина изменилась (цена, наличие, промоакция), заказ не уйдёт:

if abs(live_total - confirmed_total) > 0.01:
    raise LavkaApiError("Сумма изменилась — переоформи.")

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

Что делать с этим прямо сейчас?

Разработчику в РФ. Это рабочий пример claude api интеграции с закрытым российским сервисом. Тот же подход (реверс-инжиниринг веб-API плюс MCP-обёртка) применим к десяткам других сервисов без публичного API: Самокат, Вкусвилл, СберМаркет. Код открыт, берите как шаблон.

Автору Дзена. Тема «подключил ИИ к бытовому сервису» собирает просмотры, потому что понятна любому. Повторите эксперимент, запишите экран, покажите реальный заказ. Контент с живой демонстрацией работает лучше, чем пересказ чужого поста.

Предпринимателю. Если у вашего бизнеса есть веб-интерфейс, клиенты смогут подключить к нему ИИ-ассистента тем же способом, и вы это не контролируете. Стоит подумать, не лучше ли дать официальный API или MCP-сервер самим.

Пока этого не произошло, подобные неофициальные интеграции остаются единственным способом подружить Claude с российской инфраструктурой, и именно поэтому стоит разобрать код, пока он работает.