Индекс документации: https://vesremont.com/llms.txt
Связь этого раздела с задачей
Задача: Выбрать кратчайший поддерживаемый маршрут под задачу и возможности клиента.
Что нужно на входе: Намерение пользователя и доступный инструмент: чтение страниц, HTTP, MCP или браузерный WebMCP.
Результат: Один выбранный путь, его границы и следующий документ; проходить все протоколы подряд не требуется.
Другая цель? Карта всех задач и режимов. Права личного доступа — auth.md; это не обязательный шаг для публичного чтения.
Следующий раздел по теме: Поиск по сайту — начать публичный подбор · Корзина и оформление — работать с подборкой/корзиной/заказом · Public API — подключить выбранный протокол.
Выберите задачу: карта документации
Начните с нужной строки. Следующий документ нужен по смыслу задачи, а не как обязательный дополнительный тест. REST, MCP, A2A, UCP и browser WebMCP — альтернативные способы работы, не пять последовательных этапов.
| Задача | Сначала | Затем / уточнение | Что считается результатом |
|---|---|---|---|
| Найти артикул или модель | search.md | products.md | Совпадение, ID и ссылка на товар; не первый похожий результат. |
| Подобрать по категории и характеристикам | catalog.md | filters.md | Подборка по текущим фасетам; затем проверка каждой карточки. |
| Выбрать бренд | brands.md | catalog.md | Ассортимент нужного бренда, не смешение brand.id и product_id. |
| Сравнить цену, наличие и отзывы | products.md | availability.md | Отдельные проверенные факты; отзывы — в reviews.md. |
| Прислать готовую ссылку на корзину | purchase.md | products.md | Опубликованная /buy/ ссылка или share_url; GET не изменяет личную корзину. |
| Изменить личную корзину или избранное | purchase.md | api.md | Состояние перечитано после записи; remote — с OAuth, browser — session/CSRF. |
| Оформить конкретный заказ | purchase.md | delivery.md | Сводка → отдельное подтверждение → проверенное сохранение; не автоматическая оплата. |
| Узнать статус заказа и получать события | api.md | purchase.md | Доступ только к разрешённым заказам; webhook проверяется и дедуплицируется. |
| Ответить о доставке, оплате, возврате | delivery.md | home.md | Ответ по публичному источнику; условия не равны статусу конкретного заказа. |
| Прочитать или отправить отзыв/вопрос | reviews.md | products.md | Чтение публично; запись через browser с подтверждением и модерацией. |
| Подключить SDK, CLI, MCP, A2A или UCP | api.md | capabilities.md | Выбран один подходящий интерфейс, его schema и минимальные права. |
| Обойти сайт или обновить интеграцию | sitemaps.md | changelog.md | Канонические URL и актуальная версия, не выгрузка личных данных. |
Права, формат и источник — отдельные решения
- Публичные товары, отзывы и условия: без OAuth. HTML, JSON и Markdown — альтернативные представления, а не разные права. Поиск и запасные пути.
- Только ссылка на подборку: без OAuth; перенос в собственную корзину выполняет сайт защищённым POST после открытия покупателем. Передача подборки.
- Личные remote-операции: auth.md — выбор метода, одно согласие, отдельные audience-bound tokens и отзыв. Browser WebMCP использует свою сессию/CSRF, не этот Bearer token.
- Настоящий заказ: отдельное подтверждение конкретной сводки. Общее разрешение и sandbox его не заменяют. Оформление.
- API access, бесплатные режимы и квоты: pricing.md; цена товара и его доступность: availability.md.
- Правила использования публичного контента: AI-policy; это не разрешение на личные данные. Организация/контакты: identity.json; покупательские условия: faq-ai.txt.
Если путь остановился
Не читается JSON — используйте опубликованный Markdown или HTML того же товара. Не найден точный артикул — уточните запрос, не выдумывайте ID. 401 у личной корзины — выберите buyer auth, а не отказывайтесь от публичного поиска. 403 — проверьте права, не обходите защиту. 429 — соблюдайте Retry-After. Неизвестен результат записи — сначала перечитайте состояние; неопределённый заказ не отправляйте новым Idempotency-Key. Контракты ошибок.
Документация объясняет сценарий; актуальные schemas определяют поля. Live discovery определяет публикацию интерфейса; старый changelog — историю. Динамические цена/остаток/checkout читаются заново. Если источники расходятся, укажите конкретное расхождение, не объявляйте всю функцию отсутствующей.
Карту возможностей читайте по выбранному режиму
Выберите маршрут в карте задач выше, затем один из режимов ниже. Публичный каталог и условия не требуют доступа к покупателю. Если нужен только ответ или ссылка на товар, завершите задачу на этом результате — переход в корзину не обязателен. Задача «найди артикул и пришли корзину» использует поиск → проверку товара → передачу подборки, без buyer OAuth.
Таблица ниже описывает главным образом браузерный UI/WebMCP. Отсутствие переносимого протокола у конкретной JS-кнопки не означает отсутствия отдельного cart-link или remote API. Для личной корзины внешнего клиента — OAuth, для подтверждения заказа — отдельный просмотр сводки. Режимы не наследуют права друг друга.
Статусы браузерных действий:
supported— надёжный обычный link/form/URL-интерфейс;browser-js— доступно через семантический DOM и JavaScript, но нет переносимого link/form/URL протокола;partial— чтение доступно, действие или часть данных ограничены;webmcp— доступно через типизированный WebMCP-инструмент с runtime-валидацией.declarative-webmcp— HTML-форма опубликована как инструмент и сохраняет пользовательский контроль отправки.
| Возможность | Метод сейчас | Статус | Примечание |
|---|---|---|---|
| Понять назначение сайта | /llms.txt, HTML | supported | Корневой AI-маршрутизатор |
| Начать работу агенту | /agents/ | supported | Единая карта capabilities, policies и discovery |
| Обнаружить действия агента | /agent.json | supported | AWP v0.2-манифест фактических WebMCP-инструментов |
| Обнаружить программный интерфейс | /.well-known/api-catalog | supported | RFC 9727 Linkset: browser WebMCP, agent.json, документация и skills |
| Обнаружить Agent Skills | /.well-known/agent-skills/index.json | supported | Discovery v0.2.0, SHA-256 каждого SKILL.md |
| Навигация по категориям | a[href] | supported | Использовать опубликованные URL |
| Открыть бренд | a[href], brand sitemap | supported | /catalog/brand/{code}/ |
| Открыть товар | a[href], card sitemap | supported | /catalog/product/{section-code}/{product-code}/ |
| Категориальный фильтр | a[href] | supported | Path/query выбирает сервер |
| Несколько групп фасетов | последовательные href | supported | Одна выбранная величина на группу в штатном UI |
| Числовой диапазон | data-contract + URL grammar | supported | Повторяемый range |
| Несколько диапазонов | URL grammar | supported | Повторяемый range с разными ID |
| Сортировка товаров | a[href], sorts | supported | id_sort, price_min, price_max |
| Пагинация товаров | a[href], page | supported | Положительное целое |
| Поиск | GET HTML form | supported | Параметр search |
| Прочитать товар | Product/Offer HTML | supported | Цена, SKU, бренд, характеристики, остаток |
| Передать корзину по ссылке | Видимый ID и /buy/{id}:{qty} в карточке; cart-drafts share_url | supported | Без OAuth; browser POST при открытии покупателем, не создание заказа |
| Прочитать аналоги | товарные ссылки | supported | Подбор по характеристикам/разделу |
| Прочитать отзывы и вопросы | HTML + AJAX load | partial | Начальные записи доступны без внутреннего API |
| Отзывы категории: сортировка/фильтр | URL query + JS | supported | otziv_* параметры документированы |
| Избранное | get_favorites, set_favorite | webmcp | Явные add/remove, session + CSRF |
| Добавить в корзину | add_to_cart | webmcp | Проверка ID и количества |
| Изменить количество/удалить | set_cart_quantity, remove_from_cart | webmcp | Удаление идемпотентно |
| Быстрый заказ | start_fast_order | webmcp | Возвращает checkout URL, заказ не отправляет |
| Просмотр корзины | get_cart | webmcp | Постраничные товары и полный итог; продолжение через nextOffset |
| Выбрать получение | set_delivery | webmcp | pickup или courier |
| Указать адрес | suggest_addresses, set_delivery_address | webmcp | Подсказки и явное сохранение |
| Выбрать оплату | set_payment | webmcp | cash/sbp/card/invoice |
| Отправить заказ | prepare_order → submit_order | webmcp | Одноразовый подтверждающий токен |
| Оставить отзыв/вопрос | аннотированные HTML forms | declarative-webmcp | Без auto-submit, медиа, модерация |
| Реакции/комментарии | imperative reactions + forms | webmcp | Session/rate limit |
| Полный discovery | sitemap index | supported | brand/card/filtr shards |
Удалённые интерфейсы, SDK и CLI
| Интерфейс | Контракт | Авторизация и назначение |
|---|---|---|
| REST v1 | /api/v1, /openapi.json | Каталог без токена; корзина, избранное, checkout, заказы и webhooks по OAuth scopes |
| OAuth | /.well-known/oauth-authorization-server | Authorization Code + PKCE S256; CIMD, одно общее либо отдельные согласия, отдельный resource каждого токена и отзыв |
| Remote MCP | /mcp, /.well-known/mcp.json | Streamable HTTP; tools из общего API-реестра, отдельный audience |
| A2A 1.0 | /a2a/message:send, /.well-known/agent-card.json | Синхронные Messages для реальных операций и buyer guidance |
| UCP 2026-08-25 | /ucp/v1, /.well-known/ucp | Catalog, permalink, реальная корзина, checkout с завершением покупателем |
| Cart-draft | /api/v1/cart-drafts/, /cart/claim/ | Подписанные ID/количества; CSRF-перенос в браузерную корзину, без создания заказа |
| Webhooks | /api/v1/webhooks | HTTPS challenge, Standard Webhooks HMAC, дедупликация и история deliveries |
| JS/TypeScript, Python, Go, Ruby; Node CLI | Опубликованные реестры и /developers/downloads/ | Клиенты REST; CLI — в npm-пакете, подключение MCP не требует SDK |
Полное руководство содержит схемы, scopes, ограничения, PKCE и порядок подтверждения заказа. 26 browser WebMCP tools не равны реестру удалённых операций. Один Bearer token нельзя использовать для разных аудиторий или вместо browser CSRF. Дополнительное общее согласие позволяет ограниченным token exchange получить отдельные токены REST/MCP/A2A/UCP без повторных нажатий; только для явно разрешённых покупателем интерфейсов, без расширения прав и продления срока. Прежние согласия и отдельное подтверждение каждого заказа сохраняются.
Публичный каталог читает актуальные данные магазина без регистрации и cookies. Для безопасного знакомства с форматом есть отдельный бесплатный read-only sandbox: синтетические данные, без корзины, оформления, оплаты и отправки в 1С. Sandbox для настоящих заказов не предоставляется; покупательские операции относятся к production и требуют действующих разрешений и подтверждений. Самостоятельный anonymous credential необязателен и ограничен catalog:read; он не даёт прав покупателя. Восемь этапов авторизации, режимы доступа и квоты. A2A не предоставляет фоновые tasks или push lifecycle, UCP не принимает банковские реквизиты.
agent.json.documented_interfaces описывает полный реализованный контракт; remote_interfaces — опубликованный сейчас набор по серверной конфигурации. Руководство может описывать интерфейс, временно выключенный в live discovery: это не обещание его текущей доступности и не выдача прав. Browser WebMCP, cart-link и remote API проверяются раздельно. Историческое «remote: false» в changelog не описывает состояние сегодня.
agent.json.capabilities_context равен browser_webmcp: его batch_actions: false, webhooks: false и idempotency: false относятся только к этому браузерному интерфейсу, не ко всему магазину. У удалённых операций отдельные контракты: публичный get_products_batch читает до 10 товаров, webhooks требуют разрешения покупателя, а поддержка ключа идемпотентности определяется конкретной операцией в OpenAPI и API guide. current_capabilities — инвентарь browser tools для разных типов страниц, не обещание регистрации всех инструментов на главной. Живой набор — в document.modelContext текущей страницы.
WebMCP runtime
Инструменты регистрируются через document.modelContext только там, где они релевантны странице. Корзина и избранное доступны глобально; каталог, карточка и checkout добавляют контекстные инструменты. get_current_product возвращает остаток, независимую возможность заказа и pickupToday. Обычные чтения ограничивают размер ответа и используют nextOffset, а prepare_order возвращает полную транзакционную сводку. Браузеры без WebMCP используют прежний HTML/JS интерфейс.
Проверенный пример ответа document.modelContext
25 сентября 2026 года внешний WebMCP-клиент открыл публичную карточку товара, получил зарегистрированные страницей инструменты через document.modelContext и вызвал read-only инструмент get_cart с аргументами:
{"offset":0,"limit":3}Фактически полученный DOMString:
{"empty":true,"items":[],"totalItems":0,"offset":0,"nextOffset":null,"totalQuantity":0,"totalPrice":0,"currency":"RUB"}Это зафиксированный реальный ответ production, а не обещание постоянных значений. Содержимое корзины зависит от текущей браузерной сессии; поля и ограничения инструмента определяются актуальной schema, зарегистрированной страницей, и сверяются с agent.json.
Agent Web Protocol manifest
https://vesremont.com/agent.json публикует AWP v0.2-манифест этих же инструментов для первичного discovery. Поле operation точно совпадает с именем WebMCP-инструмента. Сам манифест не является отдельным HTTP API: агент открывает подходящую страницу Vesremont, читает актуальный document.modelContext и вызывает зарегистрированный там инструмент. Доступность каталожных, товарных и checkout-инструментов зависит от контекста страницы.
Манифест генерируется тем же AI generator, что /.well-known/ai.txt, llms-full.txt и HTML-зеркала. Проверка сопоставляет каждую объявленную операцию с исходным WebMCP-модулем, поэтому документация не должна обещать несуществующий инструмент.
API catalog
https://vesremont.com/.well-known/api-catalog публикует RFC 9727 Linkset с MIME application/linkset+json. Каталог связывает browser WebMCP с /agent.json, /agents/ и Agent Skills index. Отдельные удалённые интерфейсы добавляются генератором только после их явного включения и публикации на сервере. Текущее состояние, авторизация и схемы описаны в Public API; их нельзя выводить из перечня browser WebMCP tools.
Agent Skills и единая точка входа
https://vesremont.com/agents/ объединяет фактические точки discovery, политику и правила безопасного вызова инструментов. Индекс https://vesremont.com/.well-known/agent-skills/index.json публикуется в формате Agent Skills Discovery v0.2.0. Каждый skill строится генератором из действующей capability model, а его digest вычисляется по точным байтам опубликованного SKILL.md.
Опубликованы три области Agent Skills: поиск и чтение товаров, управление корзиной/checkout и ответы по действующим покупательским условиям. Skills описывают browser WebMCP и выбор удалённого интерфейса с OAuth. Удалённые протоколы не наследуют browser-session авторизацию; схемы и scopes — в Public API.