Как AI-агенту работать с Vesremont

Выберите задачу

Не нужно проходить все интерфейсы подряд. Выберите цель, затем подходящий способ обращения и только необходимые права.

• Найти артикул или модель — Совпадение, ID и ссылка на товар; не первый похожий результат.
• Подобрать по категории и характеристикам — Подборка по текущим фасетам; затем проверка каждой карточки.
• Выбрать бренд — Ассортимент нужного бренда, не смешение brand.id и product_id.
• Сравнить цену, наличие и отзывы — Отдельные проверенные факты; отзывы — в reviews.md.
• Прислать готовую ссылку на корзину — Опубликованная /buy/ ссылка или share_url; GET не изменяет личную корзину.
• Изменить личную корзину или избранное — Состояние перечитано после записи; remote — с OAuth, browser — session/CSRF.
• Оформить конкретный заказ — Сводка → отдельное подтверждение → проверенное сохранение; не автоматическая оплата.
• Узнать статус заказа и получать события — Доступ только к разрешённым заказам; webhook проверяется и дедуплицируется.
• Ответить о доставке, оплате, возврате — Ответ по публичному источнику; условия не равны статусу конкретного заказа.
• Прочитать или отправить отзыв/вопрос — Чтение публично; запись через browser с подтверждением и модерацией.
• Подключить SDK, CLI, MCP, A2A или UCP — Выбран один подходящий интерфейс, его schema и минимальные права.
• Обойти сайт или обновить интеграцию — Канонические URL и актуальная версия, не выгрузка личных данных.

Полная карта маршрутов и запасные пути · Выбор разрешения · Бесплатный доступ и квоты · Использование публичного контента. Политика контента не даёт доступа к личной корзине.

Найти товар → прислать ссылку на корзину

Для этой задачи не нужны OAuth, аккаунт, cookies или SDK. Найдите товар по артикулу или названию. В нижнем блоке карточки «Для AI-систем» опубликованы внутренний ID и конкретная ссылка https://vesremont.com/buy/{id}:1; текст доступен в серверном HTML и Markdown. Передайте эту ссылку покупателю; не подставляйте артикул вместо ID и не угадывайте число.

Способы поиска — альтернативы, а не обязательная цепочка: обычный HTML-поиск, Markdown-поиск по артикулу или GET /api/v1/products?q={артикул} с items[].id в JSON. Если ваш инструмент не читает JSON, используйте HTML/Markdown и опубликованную ссылку карточки. Блокировка HTTP-инструмента не означает отсутствия функции сайта.

Для подписанной подборки используйте публичный GET /api/v1/cart-drafts/?product_id={id}&quantity=1 и передайте share_url. Агентский GET не меняет личную корзину. Покупатель открывает ссылку, а сайт переносит товары защищённым POST в его браузерную корзину, повторно проверяя цену и возможность заказа. Заказ не создаётся.

Поиск → Товар и ID → Корзина по ссылке и оформление. Чтение или изменение личной корзины через API — отдельный OAuth-путь; браузерный WebMCP использует session/CSRF. Подтверждение конкретного заказа сохраняется в обоих случаях.