Карта AI-документации Vesremont
Краткая карта технической документации Vesremont для AI-агентов: базовые правила, тематические инструкции и канонические точки входа. Исходный файл для машинного чтения: /llms.txt.
Vesremont — русскоязычный интернет-магазин товаров для ремонта, строительства, дома и сада. Основные сущности: категории, фасетные состояния каталога, бренды, товары, отзывы, вопросы, корзина и заказ.
Этот файл — короткий маршрутизатор для AI-агентов. Динамические цены, остатки, набор фильтров и доступные действия всегда следует читать с актуальных HTML-страниц; эта документация описывает стабильные интерфейсы и их ограничения.
Правила для агента:
- Для категорий и категориальных фасетов переходите по опубликованным
a[href]: допустимый порядок сегментов проверяется сервером и не должен угадываться. - Range URL можно строить по документированному правилу после чтения
data-filter-*иdata-range-*на актуальной странице. - Не считайте нулевой остаток запретом заказа: на Vesremont возможность заказа определяется отдельно, по цене и наличию кнопки покупки.
- В WebMCP-браузере используйте зарегистрированные инструменты корзины, избранного, каталога и checkout вместо прямых внутренних endpoint; schemas и серверная проверка являются каноническим интерфейсом действий.
- Для заказа всегда соблюдайте
prepare_order→ проверка сводки пользователем →submit_orderс одноразовым token иconfirmed: true. - Декларативные формы отзыва, вопроса, комментария, ответа и сообщения поддержке намеренно не имеют auto-submit: не отправляйте пользовательский текст или медиа без проверки.
Начать работу
- Каталог и навигация: Структура каталога, разделы, навигация и опубликованные ссылки.
- Точная URL-грамматика: Канонические URL и ограничения на построение путей.
- Фасеты и диапазоны: Категориальные фильтры, диапазоны и
data-*контракт. - Карточка товара: Идентичность товара, цена, характеристики, schema.org и действия.
- Наличие и возможность заказа: Как отличать остаток, доступность и возможность покупки.
- Поиск: Публичный поисковый интерфейс и его ограничения.
- Бренды: Индекс брендов, страницы брендов и способы поиска.
- Корзина и покупка: Корзина, избранное, checkout, session и CSRF.
- Доставка и оплата: Информационные страницы, доставка, самовывоз и оплата.
- Отзывы и вопросы: Чтение и отправка отзывов, вопросов и ответов.
- Возможности агента: Поддерживаемые агентские интерфейсы и уровни доступности.
- Полное обнаружение URL через sitemap: Индексы sitemap и группы публичных URL.
Канонические точки входа
- Главная: Основная публичная точка входа Vesremont.
- Каталог: Корень каталога товаров.
- Бренды: Публичный индекс брендов.
- Поиск: Поиск; запрос передаётся GET-параметром
search. - Корзина: Корзина текущей пользовательской сессии.
- Доставка: Актуальная информация о доставке.
- Оплата: Актуальная информация об оплате.
- Sitemap index: Основной индекс публичных sitemap Vesremont.
Optional
- Полный AI-контекст: Сводная копия всех двенадцати подробных AI-инструкций в одном текстовом ресурсе.