---
title: "Документация Vesremont для AI-агентов"
description: "Техническая документация Vesremont для AI-агентов: навигация по каталогу, поиск, фильтры, данные товаров, действия, заказ и sitemap."
canonical: "https://vesremont.com/for_ai/"
last_modified: "2026-10-06T08:56:39+00:00"
---

# Документация Vesremont для AI-агентов

> Индекс документации: https://vesremont.com/llms.txt — используйте его для обнаружения остальных публичных страниц и машинных представлений Vesremont.

Каноническая HTML-страница: https://vesremont.com/for_ai/

Техническая документация Vesremont для AI-агентов: навигация по каталогу, поиск, фильтры, данные товаров, действия, заказ и sitemap.

[Главная](https://vesremont.com/)

AI-документация

[Обзор](https://vesremont.com/for_ai/)

[Выбор задачи и интерфейса](https://vesremont.com/for_ai/capabilities_ai/)

[Точка входа агента](https://vesremont.com/agents/)

[Vesremont API: разработчикам](https://vesremont.com/developers/)

[Vesremont Public API](https://vesremont.com/for_ai/api_ai/)

[OAuth и WebMCP: авторизация](https://vesremont.com/auth.md)

[OpenAPI: схемы и операции](https://vesremont.com/openapi.json)

[Remote MCP: описание](https://vesremont.com/.well-known/mcp.json)

[Начало работы](https://vesremont.com/for_ai/getting-started_ai/)

[Карта документации](https://vesremont.com/for_ai/llms_ai/)

[Agent manifest](https://vesremont.com/agent.json)

[API catalog](https://vesremont.com/.well-known/api-catalog)

[Agent Skills](https://vesremont.com/.well-known/agent-skills/index.json)

[Канонические Markdown](https://vesremont.com/llms/)

[Вся документация](https://vesremont.com/for_ai/full_ai/)

[AI-policy и robots.txt](https://vesremont.com/for_ai/robots_ai/)

[Главная в Markdown](https://vesremont.com/for_ai/home_ai/)

[Навигация по каталогу](https://vesremont.com/for_ai/catalog_ai/)

[URL и параметры](https://vesremont.com/for_ai/url-patterns_ai/)

[Фильтры и диапазоны](https://vesremont.com/for_ai/filters_ai/)

[Данные карточки товара](https://vesremont.com/for_ai/products_ai/)

[Цена и возможность заказа](https://vesremont.com/for_ai/availability_ai/)

[Поиск по сайту](https://vesremont.com/for_ai/search_ai/)

[Навигация по брендам](https://vesremont.com/for_ai/brands_ai/)

[Корзина и оформление](https://vesremont.com/for_ai/purchase_ai/)

[Доставка и оплата](https://vesremont.com/for_ai/delivery_ai/)

[Отзывы и вопросы](https://vesremont.com/for_ai/reviews_ai/)

[Версии и изменения](https://vesremont.com/for_ai/changelog_ai/)

[Sitemap и обнаружение URL](https://vesremont.com/for_ai/sitemaps_ai/)

[Инструменты взаимодействия](https://vesremont.com/for_ai/tools_ai/)

### Технический справочник для AI-агентов

Здесь собраны правила, по которым AI-агент может находить страницы Vesremont, читать данные каталога и товаров и выполнять поддерживаемые действия. Документация описывает стабильные интерфейсы browser WebMCP, REST/OpenAPI, OAuth, Remote MCP, A2A и UCP; динамические данные проверяются через актуальную страницу или API и повторно в корзине.

Markdown-источники автоматически собираются один раз в сутки. Текущая версия: `1.14.30` . Ревизия: `sha256:317241497d3785a8b41693cbc8f5e9c052850b3458cc50252d5f3dfff6b5e8d4` .

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

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

- [Найти артикул или модель](https://vesremont.com/llms/search.md) — Совпадение, ID и ссылка на товар; не первый похожий результат.

- [Подобрать по категории и характеристикам](https://vesremont.com/llms/catalog.md) — Подборка по текущим фасетам; затем проверка каждой карточки.

- [Выбрать бренд](https://vesremont.com/llms/brands.md) — Ассортимент нужного бренда, не смешение brand.id и product_id.

- [Сравнить цену, наличие и отзывы](https://vesremont.com/llms/products.md) — Отдельные проверенные факты; отзывы — в reviews.md.

- [Прислать готовую ссылку на корзину](https://vesremont.com/llms/purchase.md) — Опубликованная /buy/ ссылка или share_url; GET не изменяет личную корзину.

- [Изменить личную корзину или избранное](https://vesremont.com/llms/purchase.md) — Состояние перечитано после записи; remote — с OAuth, browser — session/CSRF.

- [Оформить конкретный заказ](https://vesremont.com/llms/purchase.md) — Сводка → отдельное подтверждение → проверенное сохранение; не автоматическая оплата.

- [Узнать статус заказа и получать события](https://vesremont.com/llms/api.md) — Доступ только к разрешённым заказам; webhook проверяется и дедуплицируется.

- [Ответить о доставке, оплате, возврате](https://vesremont.com/llms/delivery.md) — Ответ по публичному источнику; условия не равны статусу конкретного заказа.

- [Прочитать или отправить отзыв/вопрос](https://vesremont.com/llms/reviews.md) — Чтение публично; запись через browser с подтверждением и модерацией.

- [Подключить SDK, CLI, MCP, A2A или UCP](https://vesremont.com/llms/api.md) — Выбран один подходящий интерфейс, его schema и минимальные права.

- [Обойти сайт или обновить интеграцию](https://vesremont.com/llms/sitemaps.md) — Канонические URL и актуальная версия, не выгрузка личных данных.

[Полная карта маршрутов и запасные пути](https://vesremont.com/llms/capabilities.md) · [Выбор разрешения](https://vesremont.com/auth.md) · [Бесплатный доступ и квоты](https://vesremont.com/pricing.md) · [Использование публичного контента](https://vesremont.com/.well-known/ai.txt) . Политика контента не даёт доступа к личной корзине.

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

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

Способы поиска — альтернативы, а не обязательная цепочка: [обычный HTML-поиск](https://vesremont.com/search/) , [Markdown-поиск по артикулу](https://vesremont.com/api/v1/products.md?q=4058075709355) или `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 в его браузерную корзину, повторно проверяя цену и возможность заказа. Заказ не создаётся.

[Поиск](https://vesremont.com/llms/search.md) → [Товар и ID](https://vesremont.com/llms/products.md) → [Корзина по ссылке и оформление](https://vesremont.com/llms/purchase.md) . Чтение или изменение личной корзины через API — отдельный [OAuth-путь](https://vesremont.com/auth.md) ; браузерный WebMCP использует session/CSRF. Подтверждение конкретного заказа сохраняется в обоих случаях.

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

##### Единая точка входа агента

Реальные возможности, discovery endpoints, policies и правила безопасного подтверждения действий.

[Открыть /agents/](https://vesremont.com/agents/)

##### Как начать

Рекомендуемый порядок работы: поиск, навигация по каталогу, фильтры, карточка товара, действия и заказ.

[Открыть маршрут](https://vesremont.com/for_ai/getting-started_ai/)

##### Карта документации

`llms.txt` — короткий машинно-читаемый индекс развивающейся конвенции с базовыми правилами и ссылками на тематические инструкции.

[Канонические Markdown](https://vesremont.com/llms/) · [HTML-версия](https://vesremont.com/for_ai/llms_ai/) · [Исходный файл](https://vesremont.com/llms.txt)

#### Навигация и данные

##### Главная в Markdown

Одно содержательное представление главной доступно через `Accept: text/markdown` , `/llms/home.md` и прямой `/index.md` .

[Открыть раздел](https://vesremont.com/for_ai/home_ai/) · [Markdown](https://vesremont.com/llms/home.md) · [Прямой URL](https://vesremont.com/index.md)

##### Навигация по каталогу

Как переходить по разделам и фасетным состояниям, не угадывая структуру path.

[Открыть раздел](https://vesremont.com/for_ai/catalog_ai/)

##### URL и параметры

Канонические маршруты, query-параметры, сортировка, пагинация и ограничения построения URL.

[Открыть раздел](https://vesremont.com/for_ai/url-patterns_ai/)

##### Фильтры и диапазоны

Категориальные фасеты, числовые диапазоны и опубликованный `data-*` контракт.

[Открыть раздел](https://vesremont.com/for_ai/filters_ai/)

##### Данные карточки товара

Идентичность, цена, характеристики, schema.org, отзывы и доступные действия.

[Открыть раздел](https://vesremont.com/for_ai/products_ai/)

##### Цена и возможность заказа

Как различать локальный остаток, schema availability и фактическую возможность заказа.

[Открыть раздел](https://vesremont.com/for_ai/availability_ai/)

##### Поиск по сайту

Публичный GET-поиск, параметр `search` и ограничения страницы результатов.

[Открыть раздел](https://vesremont.com/for_ai/search_ai/)

##### Навигация по брендам

Индекс брендов, страницы брендов и рекомендуемые способы поиска.

[Открыть раздел](https://vesremont.com/for_ai/brands_ai/)

#### Действия и оформление заказа

##### Корзина и оформление

Session, CSRF, checkout и безопасная последовательность `prepare_order` → подтверждение → `submit_order` .

[Открыть раздел](https://vesremont.com/for_ai/purchase_ai/)

##### Доставка и оплата

Информационные страницы и доступные варианты получения и оплаты в checkout.

[Открыть раздел](https://vesremont.com/for_ai/delivery_ai/)

##### Отзывы и вопросы

Чтение, отправка, комментарии, ответы и реакции с сохранением пользовательского контроля.

[Открыть раздел](https://vesremont.com/for_ai/reviews_ai/)

#### Интерфейсы агента и обнаружение URL

##### Поддерживаемые возможности

Какие операции поддерживаются через HTML, browser JavaScript, WebMCP и declarative WebMCP.

[Открыть раздел](https://vesremont.com/for_ai/capabilities_ai/)

##### Версии и изменения

Версия AI-контракта, изменения `agent.json` и WebMCP-инструментов, правила публикации и кэширования.

[Открыть changelog](https://vesremont.com/for_ai/changelog_ai/)

##### Agent Resource Discovery

Единый ARD-манифест для актуального discovery и аудита Lighthouse 13.5.

[Открыть ARD](https://vesremont.com/.well-known/ard.json) · [Совместимый URL](https://vesremont.com/.well-known/ai-catalog.json)

##### Agent manifest

AWP v0.2-манифест фактически доступных WebMCP-действий, их аргументов и требований безопасности.

[Открыть agent.json](https://vesremont.com/agent.json)

##### Public API и discovery

REST/OpenAPI, OAuth PKCE, Remote MCP, A2A, UCP, корзина, заказы, webhooks, SDK и CLI.

[Полный контракт](https://vesremont.com/for_ai/api_ai/) · [OpenAPI](https://vesremont.com/openapi.json) · [RFC 9727 каталог](https://vesremont.com/.well-known/api-catalog)

##### Agent Skills

Три фактических skill-документа для поиска товаров, session shopping и покупательских условий; индекс содержит SHA-256 каждого файла.

[Открыть индекс](https://vesremont.com/.well-known/agent-skills/index.json)

##### Инструменты взаимодействия

WebMCP, `document.modelContext` , stateful-действия, session/CSRF и финальное подтверждение заказа.

[Открыть раздел](https://vesremont.com/for_ai/tools_ai/)

##### Sitemap и обнаружение URL

Sitemap index и shards для массового discovery публичных URL каталога, брендов и товаров.

[Открыть раздел](https://vesremont.com/for_ai/sitemaps_ai/)

##### Вся документация

Сводная HTML-версия `llms-full.txt` , если весь AI-контекст нужен одной страницей.

[Открыть полную версию](https://vesremont.com/for_ai/full_ai/)

##### AI-policy и robots.txt

Политика использования публичного контента, группы AI-агентов и фактические правила обхода.

[Описание](https://vesremont.com/for_ai/robots_ai/) · [ai.txt](https://vesremont.com/.well-known/ai.txt) · [ai.json](https://vesremont.com/.well-known/ai.json) · [robots.txt](https://vesremont.com/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](https://vesremont.com/llms.txt) — краткий индекс AI-документации.

- [/llm.txt](https://vesremont.com/llm.txt) и [/llms.html](https://vesremont.com/llms.html) — совместимые имена того же текстового и HTML-представления без отдельных копий.

- [/agents/](https://vesremont.com/agents/) — единая точка входа агента.

- [/developers/](https://vesremont.com/developers/) — публичный каталог, корзина по ссылке, REST/MCP/A2A/UCP и browser WebMCP.

- [/auth.md](https://vesremont.com/auth.md) — OAuth для личного API, browser session/CSRF и отдельное подтверждение заказа; для передачи корзины по ссылке не требуется.

- [/index.md](https://vesremont.com/index.md) — прямое Markdown-представление главной.

- [/llms/](https://vesremont.com/llms/) — каталог канонических Markdown-источников и текущая ревизия.

- [/llms-full.txt](https://vesremont.com/llms-full.txt) — полный AI-контекст одним текстовым ресурсом.

- [/.well-known/ard.json](https://vesremont.com/.well-known/ard.json) — канонический ARD-манифест; [/.well-known/ai-catalog.json](https://vesremont.com/.well-known/ai-catalog.json) отдаёт тот же документ для Lighthouse 13.5.

- [/.well-known/api-catalog](https://vesremont.com/.well-known/api-catalog) — RFC 9727 Linkset браузерного и удалённых интерфейсов.

- [/agent.json](https://vesremont.com/agent.json) — AWP v0.2-манифест реальных WebMCP-инструментов Vesremont.

- [/.well-known/ai.txt](https://vesremont.com/.well-known/ai.txt) — каноническая AI-policy; [/.well-known/ai.json](https://vesremont.com/.well-known/ai.json) — канонический JSON, [/ai.txt](https://vesremont.com/ai.txt) и [/ai.json](https://vesremont.com/ai.json) — совместимые корневые URL тех же generated-файлов.

- [/docs/llms.txt](https://vesremont.com/docs/llms.txt) — компактный scoped-индекс задач и поддерживаемых интерфейсов.

- [/.well-known/agent-skills/index.json](https://vesremont.com/.well-known/agent-skills/index.json) — Agent Skills Discovery v0.2.0.

- [/identity.json](https://vesremont.com/identity.json) , [/brand.txt](https://vesremont.com/brand.txt) , [/faq-ai.txt](https://vesremont.com/faq-ai.txt) , [/developer-ai.txt](https://vesremont.com/developer-ai.txt) , [/robots-ai.txt](https://vesremont.com/robots-ai.txt) , [/pricing.md](https://vesremont.com/pricing.md) — generated compatibility-представления общей модели данных.

- [/.well-known/security.txt](https://vesremont.com/.well-known/security.txt) — контакт для сообщений о безопасности по RFC 9116.

- [/robots.txt](https://vesremont.com/robots.txt) — правила обхода · [HTML-версия](https://vesremont.com/for_ai/robots_ai/) .

- [/sitemap.xml](https://vesremont.com/sitemap.xml) — совместимая корневая точка; перенаправляет на основной sitemap index.

- [/sitemaps/sitemap_page.xml](https://vesremont.com/sitemaps/sitemap_page.xml) — основной sitemap index Vesremont.
