START
Единая точка входа агента
Реальные возможности, discovery endpoints, policies и правила безопасного подтверждения действий.
Документация Vesremont для AI-агентов
Технический справочник для AI-агентов
Здесь собраны правила, по которым AI-агент может находить страницы Vesremont, читать данные каталога и товаров и выполнять поддерживаемые действия. Документация описывает стабильные интерфейсы browser WebMCP, REST/OpenAPI, OAuth, Remote MCP, A2A и UCP; динамические данные проверяются через актуальную страницу или API и повторно в корзине.
Markdown-источники автоматически собираются один раз в сутки. Текущая версия: 1.14.26. Ревизия: sha256:9b31a3f6f6f337be31af63c1e9c6d02d851af36439c7548189f21792b9963e9d.
Выберите задачу
Не нужно проходить все интерфейсы подряд. Выберите цель, затем подходящий способ обращения и только необходимые права.
- Найти артикул или модель — Совпадение, 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. Подтверждение конкретного заказа сохраняется в обоих случаях.
С чего начать
1
Как начать
Рекомендуемый порядок работы: поиск, навигация по каталогу, фильтры, карточка товара, действия и заказ.
AI
Карта документации
llms.txt — короткий машинно-читаемый индекс развивающейся конвенции с базовыми правилами и ссылками на тематические инструкции.
Навигация и данные
H
Главная в Markdown
Одно содержательное представление главной доступно через Accept: text/markdown, /llms/home.md и прямой /index.md.
К
Навигация по каталогу
Как переходить по разделам и фасетным состояниям, не угадывая структуру path.
URL
URL и параметры
Канонические маршруты, query-параметры, сортировка, пагинация и ограничения построения URL.
F
Фильтры и диапазоны
Категориальные фасеты, числовые диапазоны и опубликованный data-* контракт.
Т
Данные карточки товара
Идентичность, цена, характеристики, schema.org, отзывы и доступные действия.
₽
Цена и возможность заказа
Как различать локальный остаток, schema availability и фактическую возможность заказа.
?
Поиск по сайту
Публичный GET-поиск, параметр search и ограничения страницы результатов.
B
Навигация по брендам
Индекс брендов, страницы брендов и рекомендуемые способы поиска.
Действия и оформление заказа
C
Корзина и оформление
Session, CSRF, checkout и безопасная последовательность prepare_order → подтверждение → submit_order.
Д
Доставка и оплата
Информационные страницы и доступные варианты получения и оплаты в checkout.
★
Отзывы и вопросы
Чтение, отправка, комментарии, ответы и реакции с сохранением пользовательского контроля.
Интерфейсы агента и обнаружение URL
A
Поддерживаемые возможности
Какие операции поддерживаются через HTML, browser JavaScript, WebMCP и declarative WebMCP.
V
Версии и изменения
Версия AI-контракта, изменения agent.json и WebMCP-инструментов, правила публикации и кэширования.
ARD
Agent Resource Discovery
Единый ARD-манифест для актуального discovery и аудита Lighthouse 13.5.
JSON
Agent manifest
AWP v0.2-манифест фактически доступных WebMCP-действий, их аргументов и требований безопасности.
API
Public API и discovery
REST/OpenAPI, OAuth PKCE, Remote MCP, A2A, UCP, корзина, заказы, webhooks, SDK и CLI.
SKILL
Agent Skills
Три фактических skill-документа для поиска товаров, session shopping и покупательских условий; индекс содержит SHA-256 каждого файла.
M
Инструменты взаимодействия
WebMCP, document.modelContext, stateful-действия, session/CSRF и финальное подтверждение заказа.
S
Sitemap и обнаружение URL
Sitemap index и shards для массового discovery публичных URL каталога, брендов и товаров.
ALL
Вся документация
Сводная HTML-версия llms-full.txt, если весь AI-контекст нужен одной страницей.
P
AI-policy и robots.txt
Политика использования публичного контента, группы AI-агентов и фактические правила обхода.
Описание · ai.txt · ai.json · robots.txt
HTTP discovery
В HTML <head> и HTTP-заголовках Link публикуются указатели на
/llms.txt, /.well-known/api-catalog, /.well-known/ard.json, /.well-known/agent-skills/index.json и /for_ai/. Для распознанных AI-агентов и прямых запросов
AI-документации сервер дополнительно указывает /agents/, /agent.json, /.well-known/ai.txt, /.well-known/ai.json, /llms-full.txt, /robots.txt
и HTML-зеркала служебных ресурсов. Это позволяет новым или неизвестным User-Agent начать с
базовой карты, а известным агентам сразу получить расширенный discovery.
Ресурсы для машинного чтения
- /llms.txt — краткий индекс AI-документации.
- /llm.txt и /llms.html — совместимые имена того же текстового и HTML-представления без отдельных копий.
- /agents/ — единая точка входа агента.
- /developers/ — публичный каталог, корзина по ссылке, REST/MCP/A2A/UCP и browser WebMCP.
- /auth.md — OAuth для личного API, browser session/CSRF и отдельное подтверждение заказа; для передачи корзины по ссылке не требуется.
- /index.md — прямое Markdown-представление главной.
- /llms/ — каталог канонических Markdown-источников и текущая ревизия.
- /llms-full.txt — полный AI-контекст одним текстовым ресурсом.
- /.well-known/ard.json — канонический ARD-манифест; /.well-known/ai-catalog.json отдаёт тот же документ для Lighthouse 13.5.
- /.well-known/api-catalog — RFC 9727 Linkset браузерного и удалённых интерфейсов.
- /agent.json — AWP v0.2-манифест реальных WebMCP-инструментов Vesremont.
- /.well-known/ai.txt — каноническая AI-policy; /.well-known/ai.json — канонический JSON, /ai.txt и /ai.json — совместимые корневые URL тех же generated-файлов.
- /docs/llms.txt — компактный scoped-индекс задач и поддерживаемых интерфейсов.
- /.well-known/agent-skills/index.json — Agent Skills Discovery v0.2.0.
- /identity.json, /brand.txt, /faq-ai.txt, /developer-ai.txt, /robots-ai.txt, /pricing.md — generated compatibility-представления общей модели данных.
- /.well-known/security.txt — контакт для сообщений о безопасности по RFC 9116.
- /robots.txt — правила обхода · HTML-версия.
- /sitemap.xml — совместимая корневая точка; перенаправляет на основной sitemap index.
- /sitemaps/sitemap_page.xml — основной sitemap index Vesremont.