Покупателям
Инструмент Электрика и свет Ручной инструмент Офис и дом Строительные материалы Спецодежда и СИЗ Расходные материалы Складское оборудование Крепёж Климатическое оборудование Сантехника Автосервисное оборудование Строительное оборудование Спорт и туризм Станки Всё для сада Клининговое оборудование

Возможности AI-агентов на Vesremont

Техническая карта agent-facing surface

Vesremont предоставляет публичный HTML и Markdown для чтения, а в совместимом браузере — 27 реальных WebMCP-инструментов через document.modelContext. Инструменты используют текущую браузерную сессию и серверную CSRF-проверку. Удалённые REST, MCP, A2A и UCP описаны в Public API documentation; отдельно доступен stateless handoff подборки товаров в настоящую браузерную корзину покупателя.

Business name: Vesremont. Brand: Vesremont. Legal entity: ООО «Афганец». Vesremont — русскоязычный интернет-магазин товаров для ремонта, строительства, дома и сада: инструмента, электрики, стройматериалов, крепежа, сантехники, оборудования, спецодежды и товаров для профессиональных задач. Публичный каталог содержит актуальные страницы категорий, брендов и товаров; цены, остатки и возможность заказа проверяются на текущей странице и в корзине. Services: инструменты, электрика, строительные материалы, крепёж, сантехника, оборудование, спецодежда, товары для дома и сада.

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

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

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

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

Для этой задачи не нужны 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, браузерное согласие или регистрация агента. Доступ бесплатный; действуют квоты и ограничения.

  1. Вызовите GET /api/v1/products?per_page=1. Ответ содержит items и числовой id товара; это уже первый успешный вызов, без OAuth.
  2. Для синтетического примера вызовите GET /oauth/sandbox: synthetic: true, read_only: true, orders_supported: false. Это read-only sandbox, не тестовый магазин.
  3. Если нужен собственный короткоживущий credential, identity endpoint публикует шаблон самостоятельной регистрации {"type":"anonymous"}. Register → Exchange → Use → Revocation выполняются без человека, только с catalog:read; бессрочных API keys нет.

Не открывайте браузер ради публичного каталога. Лишь доступ к корзине, избранному, checkout, заказам и webhooks покупателя требует его отдельного OAuth-согласия. Anonymous credential не даёт этих прав; заказ подтверждается отдельно.

С чего начать?

  1. Прочитайте /llms.txt или тематический документ из /llms/.
  2. Для интеграции откройте Developer documentation и полный API-контракт; browser session/CSRF и OAuth PKCE описаны в /auth.md.
  3. Для REST/MCP/A2A/UCP можно получить одно общее разрешение на перечисленные интерфейсы и права. Токены остаются отдельными; конкретный заказ подтверждается отдельно на Vesremont. Прежний путь отдельных согласий сохраняется.
  4. Внешний клиент выбирает REST/OpenAPI, Remote MCP, A2A или UCP; каталог читается без токена, личные действия — после OAuth-согласия для конкретного resource и scopes.
  5. Для автоматического discovery используйте RFC 9727 API catalog, ARD, agent.json и Agent Skills index.
  6. Откройте релевантную страницу Vesremont в WebMCP-совместимом браузере и прочитайте текущий document.modelContext.
  7. После каждой навигации перечитывайте список инструментов: часть действий доступна только на каталоге, карточке или 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 и серверные ограничения. Пользовательские действия должны выполняться только через опубликованные инструменты и с необходимым подтверждением.