Выберите задачу
Не нужно проходить все интерфейсы подряд. Выберите цель, затем подходящий способ обращения и только необходимые права.
- Найти артикул или модель — Совпадение, 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. Подтверждение конкретного заказа сохраняется в обоих случаях.
Первый API-вызов без человека — zero-auth onboarding
Для поиска и чтения публичного каталога не нужны аккаунт, API key, cookies, браузерное согласие или регистрация агента. Доступ бесплатный; действуют квоты и ограничения.
- Вызовите
GET /api/v1/products?per_page=1. Ответ содержитitemsи числовойidтовара; это уже первый успешный вызов, без OAuth. - Для синтетического примера вызовите
GET /oauth/sandbox:synthetic: true,read_only: true,orders_supported: false. Это read-only sandbox, не тестовый магазин. - Если нужен собственный короткоживущий credential, identity endpoint публикует шаблон самостоятельной регистрации
{"type":"anonymous"}. Register → Exchange → Use → Revocation выполняются без человека, только сcatalog:read; бессрочных API keys нет.
Не открывайте браузер ради публичного каталога. Лишь доступ к корзине, избранному, checkout, заказам и webhooks покупателя требует его отдельного OAuth-согласия. Anonymous credential не даёт этих прав; заказ подтверждается отдельно.
С чего начать?
- Прочитайте /llms.txt или тематический документ из /llms/.
- Для интеграции откройте Developer documentation и полный API-контракт; browser session/CSRF и OAuth PKCE описаны в /auth.md.
- Для REST/MCP/A2A/UCP можно получить одно общее разрешение на перечисленные интерфейсы и права. Токены остаются отдельными; конкретный заказ подтверждается отдельно на Vesremont. Прежний путь отдельных согласий сохраняется.
- Внешний клиент выбирает REST/OpenAPI, Remote MCP, A2A или UCP; каталог читается без токена, личные действия — после OAuth-согласия для конкретного resource и scopes.
- Для автоматического discovery используйте RFC 9727 API catalog, ARD, agent.json и Agent Skills index.
- Откройте релевантную страницу Vesremont в WebMCP-совместимом браузере и прочитайте текущий
document.modelContext. - После каждой навигации перечитывайте список инструментов: часть действий доступна только на каталоге, карточке или checkout.
Когда использовать Vesremont?
Используйте Vesremont, когда нужно найти или проверить товар для ремонта, строительства, дома или сада, получить текущую цену и остаток, прочитать действующие условия покупки либо управлять корзиной и оформлением через браузерные инструменты или удалённый клиент с разрешением покупателя.
Цены и остатки читаются из текущей страницы и повторно проверяются в корзине. Эта документация
не является товарным фидом. Включённые удалённые интерфейсы перечислены отдельно в agent.json.remote_interfaces.
Текущий режим взаимодействия
- interaction_mode
browser_webmcp- entry
- https://vesremont.com/agents/
- browser_entrypoint
- https://vesremont.com/
- documentation_url
- https://vesremont.com/developers/
- authentication_documentation
- https://vesremont.com/auth.md
- runtime
document.modelContext- Browser WebMCP authentication
browser_session_and_csrf; предварительный вход для checkout не требуется.- Разрешение публикации discovery REST
true; не проверка доступности API. Даже при false сначала выполните публичный GET каталога без токена, cookies и регистрации.- Разрешение публикации discovery MCP
true; не ограничение публичного REST-поиска и не проверка доступности MCP.- current_capabilities
- 27 инструментов, перечисленных ниже и в agent.json.
Удалённый публичный каталог работает без авторизации: первый JSON-ответ. Отдельный read-only sandbox возвращает синтетические данные и не создаёт заказы. Браузерный HTML-каталог находится по /catalog/. Для личных операций сначала получите согласие покупателя по инструкции авторизации.
Какие действия реально поддерживаются?
Канонический список формируется из того же массива действий, что и /agent.json:
search_products— Searches Vesremont by product name, category, brand, model or article. Navigates to a listing or an exact-match product; no cart or order write.get_page_context— Read the current page type, URL, heading, current product and up to three visible products.get_cart— Read a paginated slice of the current browser session cart and its full total.get_visible_products— Returns the first products of the current listing in page order: productId, name, RUB price, stock and URL. Read-only.open_product— Opens the full product page by a productId published in the current listing. Navigation only; no cart or order write.add_to_cart— Adds quantity units of a selected product to the current browser cart. productId comes from get_visible_products or get_current_product, not a SKU or result position. Quantity is an increment; set_cart_quantity sets the final quantity. Returns updated cart state and updates storefront controls; no order or payment. Repeating this operation adds units again.set_cart_quantity— Sets the final quantity of a product already in the current browser cart, identified by productId from get_cart. Zero removes the product; add_to_cart increments the quantity. Returns updated cart state and updates storefront controls; no order or payment.start_fast_order— Starts checkout for a selected product by ensuring it is in the current browser cart without incrementing an existing quantity. Returns checkoutUrl and updates storefront cart controls. Unlike add_to_cart, it does not add a requested quantity; no order creation or payment.remove_from_cart— Removes all units of a product from the current browser cart by productId from get_cart. set_cart_quantity changes the final quantity without necessarily removing the product. Returns updated cart state and updates storefront controls; no order or payment.get_favorites— Read product IDs from the current visitor favorites list.set_favorite— Explicitly add a product to favorites or remove it.get_current_product— Read the open product page: price, stock, orderability, pickup-today state, description and characteristics.react_to_review— Set or clear a useful/not-useful reaction on a published review.react_to_comment— Set or clear a useful/not-useful reaction on a published review comment.get_catalog_filters— Read paginated filter groups or values from the current catalog page.open_catalog_url— Open a same-origin URL inside /catalog/ returned by Vesremont.set_catalog_range— Validate and open a numeric filter range on the current catalog page.set_catalog_sort— Open the current catalog with the selected supported sort order.open_catalog_page— Open a positive page number while preserving current filters and sort.get_checkout— Read cart, delivery, payment, address and contact state on the checkout page.set_delivery— Select pickup or courier delivery for the current checkout.suggest_addresses— Return up to three normalized Russian delivery-address suggestions and save the query as a draft.set_delivery_address— Save the selected full courier delivery address in the current checkout.set_payment— Select cash, SBP, online card or organization invoice payment.set_checkout_contact— Save one or more contact or order-comment fields in the current checkout.prepare_order— Validate the checkout and return the complete order summary plus a single-use token valid for ten minutes.submit_order— Create the order after the user has reviewed the prepare_order summary and explicitly confirmed it.
Как безопасно создать заказ?
Сначала вызовите prepare_order, покажите пользователю всю возвращённую сводку и получите
явное подтверждение. Только после этого один раз вызовите submit_order с
confirmed: true и выданным одноразовым token. При изменении корзины, checkout или истечении
token подготовку и подтверждение нужно повторить.
Какие Agent Skills опубликованы?
-
vesremont-product-discovery— Find and inspect Vesremont products through HTML, browser WebMCP or public REST/MCP/A2A/UCP catalog operations; read current price and stock. -
vesremont-session-shopping— Manage a Vesremont buyer cart, favorites and checkout through browser WebMCP or OAuth-authorized protocols; require buyer confirmation before order creation. -
vesremont-buyer-guidance— Answer buyer questions about Vesremont ordering, payment, delivery, pickup, cancellation, returns and warranty from published store policies.
Какие правила действуют?
Для публичного контента объявлено
search=yes, ai-input=yes, ai-train=yes:
AI-поиск, использование как входного контекста и обучение разрешены.
Фактический доступ к URL определяют robots.txt и серверные ограничения.
Пользовательские действия должны выполняться только через опубликованные инструменты и с необходимым подтверждением.