---
title: "Карта AI-документации Vesremont"
description: "HTML-версия llms.txt: основные правила, тематические разделы и канонические точки входа для AI-агентов."
canonical: "https://vesremont.com/for_ai/llms_ai/"
last_modified: "2026-10-26T08:28:35+00:00"
---

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

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

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

HTML-версия llms.txt: основные правила, тематические разделы и канонические точки входа для AI-агентов.

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

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

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

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

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

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

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

[English developer portal](https://vesremont.com/en/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/)

HTML-зеркало краткого машинно-читаемого маршрутизатора AI-документации Vesremont. Исходный файл для машинного чтения: [/llms.txt](https://vesremont.com/llms.txt) .

Версия AI-документации: `1.14.31` . Ревизия: `sha256:5645af5ca9e82c3127c691283c5eec16d7efab8039972ccbbae5ae4b8ec746ce` .

- [Индексы разделов и дополнительные публичные форматы](https://vesremont.com/for_ai/llms_ai/#doc-section-1)

- [Сначала задача, затем интерфейс и права](https://vesremont.com/for_ai/llms_ai/#doc-section-2)

- [Найти артикул → передать корзину: начните здесь](https://vesremont.com/for_ai/llms_ai/#doc-section-3)

- [Start here: zero-auth API quickstart](https://vesremont.com/for_ai/llms_ai/#doc-section-4)

- [— Sandbox / test environment — live GET](https://vesremont.com/for_ai/llms_ai/#doc-section-5)

- [— Self-serve credentials — register, exchange, use, revoke](https://vesremont.com/for_ai/llms_ai/#doc-section-6)

- [Published SDKs, CLI and MCP directory](https://vesremont.com/for_ai/llms_ai/#doc-section-7)

- [— Agent platform configurations and skills](https://vesremont.com/for_ai/llms_ai/#doc-section-8)

- [— CLI installation and first public read — no browser](https://vesremont.com/for_ai/llms_ai/#doc-section-9)

- [When to use Vesremont](https://vesremont.com/for_ai/llms_ai/#doc-section-10)

- [Когда использовать Vesremont](https://vesremont.com/for_ai/llms_ai/#doc-section-11)

- [Правила для агента](https://vesremont.com/for_ai/llms_ai/#doc-section-12)

- [Основные точки входа](https://vesremont.com/for_ai/llms_ai/#doc-section-13)

Vesremont — русскоязычный интернет-магазин товаров для ремонта, строительства, дома и сада. Это маршрутизатор к HTML/Markdown, browser WebMCP, REST/OpenAPI, OAuth, Remote MCP, A2A и UCP.

Business name: Vesremont Brand: Vesremont Legal entity: ООО «Афганец»

Description: Vesremont — русскоязычный интернет-магазин товаров для ремонта, строительства, дома и сада: инструмента, электрики, стройматериалов, крепежа, сантехники, оборудования, спецодежды и товаров для профессиональных задач. Публичный каталог содержит актуальные страницы категорий, брендов и товаров; цены, остатки и возможность заказа проверяются на текущей странице и в корзине.

Services: инструменты, электрика, строительные материалы, крепёж, сантехника, оборудование, спецодежда, товары для дома и сада

Текущая версия AI-документации — `1.14.31` . Полная карта документов и discovery endpoints — в `/llms-full.txt` , `/docs/llms.txt` и тематической документации.

[English Vesremont developer portal](https://vesremont.com/en/developers/) : API documentation, OpenAPI, MCP server, SDKs and buyer OAuth. Русская версия `/developers/` и прежние контракты сохранены.

#### Индексы разделов и дополнительные публичные форматы

| Раздел / формат | Назначение |

| [Каталог: краткий индекс](https://vesremont.com/catalog/llms.txt) | Поиск, фильтры, карточка, наличие и подборка |

| [Бренды: краткий индекс](https://vesremont.com/brand/llms.txt) | Производитель → ассортимент → карточка |

| [Разработчикам: краткий индекс](https://vesremont.com/developers/llms.txt) | Транспорт, контракт, права и обновления |

| [Schema Map документации](https://vesremont.com/schemamap.xml) | JSONL 15 документационных страниц, не полный товарный feed |

| [NLWeb list-поиск](https://vesremont.com/ask?query=4058075709355) | Пример поиска артикула без OAuth; JSON/SSE, вход и ограничения в API-руководстве. Существующий товарный поиск, не генерация ответа моделью |

#### Сначала задача, затем интерфейс и права

Не проходите всю документацию последовательно. HTML/Markdown/REST, Remote MCP, A2A, UCP и browser WebMCP — альтернативы, а не обязательные этапы. [Полная карта задач](https://vesremont.com/for_ai/capabilities_ai/) объясняет входные данные, результат и запасной путь.

| Нужно | Начать здесь | Продолжение |

| Найти артикул / модель | [Поиск](https://vesremont.com/for_ai/search_ai/) | [Проверить товар и ID](https://vesremont.com/for_ai/products_ai/) |

| Подобрать по характеристикам / бренду | [Каталог](https://vesremont.com/for_ai/catalog_ai/) , [бренды](https://vesremont.com/for_ai/brands_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/reviews_ai/) |

| Передать подборку / работать с личной корзиной / оформить | [Покупка: три разных результата](https://vesremont.com/for_ai/purchase_ai/) | Ссылка без OAuth; личный доступ через auth.md; заказ с отдельным подтверждением |

| Узнать доставку, оплату, возврат | [Условия и checkout](https://vesremont.com/for_ai/delivery_ai/) | Публичный источник для общего ответа, живой checkout для конкретного заказа |

| Подключить протокол / SDK / события заказа | [Public API](https://vesremont.com/for_ai/api_ai/) | Выбранный протокол, его schema, минимальные права; не все интерфейсы сразу |

| Обойти сайт / обновить интеграцию | [Sitemap](https://vesremont.com/for_ai/sitemaps_ai/) , [URL](https://vesremont.com/for_ai/url-patterns_ai/) | [Изменения версий](https://vesremont.com/for_ai/changelog_ai/) , не старые ограничения из истории |

AI-policy разрешает использование публичного контента, но не доступ к личным данным. `pricing.md` описывает доступ к API и квоты; цена/наличие конкретного товара — в текущем ответе товара. Описание сценария не заменяет schema и live discovery. Если инструмент не читает один формат, используйте опубликованную альтернативу, не делайте вывод об отсутствии функции.

#### Найти артикул → передать корзину: начните здесь

Обычная корзина привязана к браузеру, но готовую ссылку агент может передать **без OAuth, cookies, API key и SDK** . В нижнем AI-блоке карточки, после отзывов и аналогов перед подвалом, есть внутренний ID и конкретная `https://vesremont.com/buy/{id}:1` . Текст присутствует в серверном HTML и Markdown, даже если блок свёрнут. Передайте её покупателю; не подставляйте артикул вместо ID. Сайт перенесёт товар в его корзину защищённым POST после открытия ссылки, заказ не создаст.

Если карточка ещё не найдена: `GET https://vesremont.com/api/v1/products?q={артикул}` → проверить совпадение товара и `items\[\].id` → `/buy/{id}:1` . Если JSON не читается, `https://vesremont.com/api/v1/products.md?q={артикул}` либо HTML `/search/?search={артикул}` → карточка с опубликованной ссылкой. Для подписанной подборки `GET /api/v1/cart-drafts/?product_id={id}&quantity=1` возвращает `share_url` ; GET не меняет личную корзину. Невозможность HTTP-инструмента открыть адрес не означает отсутствия функции магазина.

Порядок и безопасные альтернативы: [https://vesremont.com/llms/purchase.md](https://vesremont.com/llms/purchase.md) ; поиск: [https://vesremont.com/llms/search.md](https://vesremont.com/llms/search.md) ; ID и карточка: [https://vesremont.com/llms/products.md](https://vesremont.com/llms/products.md) . Только чтение/изменение **личной** корзины через API требует разрешения покупателя; конкретный заказ подтверждается отдельно. Ниже перечислены другие режимы — проходить anonymous registration ради ссылки не нужно.

#### Start here: zero-auth API quickstart

[Documentation MCP](https://vesremont.com/docs/mcp) : отдельный read-only сервер `search_docs` и `read_docs` для опубликованных инструкций. Для каталога и личных операций используйте прежний [Product MCP](https://vesremont.com/mcp) .

Пакетное чтение: `POST https://vesremont.com/api/v1/products/batch` с JSON `{"product_ids":\[375092,375094\]}` . Максимум 10 уникальных ID, по одной единице обычной catalog-квоты на ID. Возвращает `items` и `missing_ids` ; корзину не меняет. Точный контракт — OpenAPI.

[API discovery](https://vesremont.com/api/) — JSON entry with the existing REST base, OpenAPI, public operations, first call and sandbox. [API index](https://vesremont.com/api/llms.txt) is the same source as the developer section index. These addresses provide navigation, not new permissions or a separate API.

First successful call, no human required: [GET /api/v1/products?per_page=1](https://vesremont.com/api/v1/products?per_page=1) . Read `items` and the numeric product `id` from the JSON. No account, API key, browser, consent, cookies or registration is required for public catalog reads. Search by name or SKU with `GET /api/v1/products?q={query}` , then read `GET /api/v1/products/{id}` . A supplied invalid Bearer token is rejected; for zero-auth omit Authorization entirely.

##### Sandbox / test environment — live GET

[Read-only sandbox](https://vesremont.com/oauth/sandbox) is publicly reachable and returns synthetic data only ( `synthetic: true` , `read_only: true` , `orders_supported: false` ). Call this URL directly; no signup, API key or browser is needed. It cannot create orders or modify a buyer's cart.

##### Self-serve credentials — register, exchange, use, revoke

[Self-serve anonymous credential](https://vesremont.com/oauth/identity) is optional: register `{"type":"anonymous"}` , exchange the one-time assertion for a 15-minute `catalog:read` token, use it, and revoke it. No API-key subscription, refresh, Claim or buyer permissions. All eight walkthrough stages are at the beginning of `/auth.md` ; free plans, feature breakdowns and quotas are in `/pricing.md` (canonical links below).

Only buyer-specific cart, favorites, checkout, orders and webhooks require browser OAuth consent. Browser session/CSRF do not block the public API or signed cart-draft handoff. Actual orders retain separate buyer confirmation.

#### Published SDKs, CLI and MCP directory

- [npm registry — @vesremont_api/api 0.2.0](https://registry.npmjs.org/@vesremont_api%2Fapi/0.2.0) : machine-readable package metadata with `bin.vesremont` , homepage and tarball integrity. JS/TypeScript SDK and CLI, Node.js 22+. This is the public npm registry, not a separate or unpublished package; use it if the human npm website returns an anti-bot 403.

- [PyPI — vesremont-api](https://pypi.org/project/vesremont-api/0.2.0/) : Python SDK, Python 3.10+. Install with `python -m pip install vesremont-api==0.2.0` .

- [RubyGems — vesremont-api](https://rubygems.org/gems/vesremont-api/versions/0.2.0) : Ruby SDK, Ruby 3.3+. Install with `gem install vesremont-api --version 0.2.0` .

- [Go module](https://pkg.go.dev/github.com/oooafganec-dev/vesremont-sdk/go@v0.2.0) : Go 1.22+. Install with `go get github.com/oooafganec-dev/vesremont-sdk/go@v0.2.0` .

- [Public SDK/CLI source repository](https://github.com/oooafganec-dev/vesremont-sdk) .

- [Official MCP Registry — com.vesremont/store 1.0.0](https://registry.modelcontextprotocol.io/v0.1/servers/com.vesremont%2Fstore/versions/1.0.0) : server record for [https://vesremont.com/mcp](https://vesremont.com/mcp) ; registry publication does not replace buyer consent or runtime verification.

- [Vesremont MCP listing on Smithery](https://smithery.ai/servers/oooafganec/Vesremont) : separate MCP directory entry.

- [Vesremont MCP on Glama — ownership verified](https://glama.ai/mcp/connectors/com.vesremont/store) : domain ownership confirmed; the connector points to the same [https://vesremont.com/mcp](https://vesremont.com/mcp) endpoint. This does not grant buyer permissions or establish an Ora score.

Installation examples and OAuth discovery are linked once in the main entry points below. Direct MCP connection: `https://vesremont.com/mcp` , without SDK installation. Read-only catalog tools need no buyer consent; private tools require the buyer's OAuth authorization. Direct package downloads remain alternatives, not the only distribution channel.

##### Agent platform configurations and skills

- [Claude Code MCP configuration](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/.mcp.json) and [SDK rules](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/.claude/rules/vesremont-sdk.md) .

- [Cursor MCP configuration](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/.cursor/mcp.json) .

- [Windsurf SDK rules](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/.windsurf/rules/vesremont-sdk.md) and [user-level MCP configuration example](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/connections/windsurf.mcp_config.json) .

- [Connection and trust instructions](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/connections/README.md) .

- [Product discovery skill](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/skills/vesremont-product-discovery/SKILL.md) , [browser session shopping skill](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/skills/vesremont-session-shopping/SKILL.md) , [buyer guidance skill](https://github.com/oooafganec-dev/vesremont-sdk/blob/main/skills/vesremont-buyer-guidance/SKILL.md) .

These files are published in the official repository; presence on GitHub does not prove listing on skills.sh or consent to buyer operations. Browser skills and SDK development rules do not replace remote OAuth. Review the configuration before trusting tools; do not embed credentials in it.

##### CLI installation and first public read — no browser

Expected CLI version: `0.2.0` . This CLI is already published inside the npm SDK, not a separate Homebrew/PyPI CLI. Python, Ruby and Go packages above are SDKs. All four package registries link to the official Vesremont developer portal or the SDK source repository. No credential is needed for `status` , `search` or `product` ; buyer data requires OAuth and writes require `--write` .

#### When to use Vesremont

Use Vesremont when an agent needs to:

- find products for repair, construction, home or garden;

- check current product information, price and availability;

- read payment, delivery, pickup, return or warranty terms;

- interact through browser WebMCP or remote REST, MCP, A2A and UCP;

- manage the buyer-authorized cart and checkout, confirm orders and receive signed order webhooks;

- integrate using the published JS/TypeScript, Python, Go or Ruby SDK and Node CLI (registry links and installation commands above).

Remote interfaces: /llms/api.md is the complete integration contract; /openapi.json supplies REST schemas and scopes. Buyer operations use OAuth Authorization Code + PKCE S256. One explicit consent can cover REST/MCP/A2A/UCP; restricted token exchange issues separate audience-bound tokens without wider scopes or longer lifetime. Each actual order still requires a separate buyer confirmation on Vesremont. The original single-interface consent remains supported. agent.json distinguishes documented_interfaces from live remote_interfaces. A signed cart-draft link issuer is available at [https://vesremont.com/api/v1/cart-drafts/?product_id=375094](https://vesremont.com/api/v1/cart-drafts/?product_id=375094) ; it does not create an order.

#### Когда использовать Vesremont

Используйте Vesremont для поиска товаров, чтения карточек, цен и остатков, покупательских условий, работы с корзиной, избранным и checkout через WebMCP или авторизованный API-клиент. Заказы требуют подтверждения покупателя; уведомления о сохранённых состояниях доставляются подписанными webhooks.

Цены, остатки и возможность заказа являются динамическими: проверяйте их на актуальной странице и повторно в корзине.

Только браузерная ветка: Interaction mode: `browser_webmcp` ; Runtime: `document.modelContext` . Это не характеристика всех интерфейсов магазина. Удалённые интерфейсы и их авторизация описаны в `/llms/api.md` . Машинный каталог `/.well-known/api-catalog` связывает опубликованный REST с `/openapi.json` ; `agent.json.remote_interfaces` перечисляет опубликованные интерфейсы, но не заменяет проверку их ответа. Первый публичный запрос — `GET https://vesremont.com/api/v1/products?per_page=1` , без регистрации, cookies и токена. Личные операции требуют отдельного разрешения покупателя.

Для передачи подборки покупателю доступен stateless `GET https://vesremont.com/api/v1/cart-drafts/?product_id=375094` : ответ содержит `share_url` готовой корзины. Цена и доступность будут перепроверены сайтом; открытие ссылки не создаёт заказ.

#### Правила для агента

- Для категорий и фасетов переходите по опубликованным ссылкам и не угадывайте порядок сегментов URL.

- Текущие цену, остаток, фильтры и возможность заказа читайте с актуальной страницы; перед подтверждением заказа повторно проверяйте корзину.

- Различайте цену, остаток и возможность заказа. REST stock.local/stock.total суммируют складскую сеть и не обещают самовывоз сегодня; в браузере ориентируйтесь на явный pickupToday.

- Используйте опубликованные WebMCP-инструменты или документированные публичные протоколы вместо внутренних Bitrix/AJAX endpoint. Cookies браузера не являются удалённой авторизацией.

- Для заказа соблюдайте `prepare_order` → сводка → подтверждение → `submit_order` . Remote API требует подтверждения по confirmation_url и стабильного Idempotency-Key; UCP передаёт continue_url для завершения на сайте.

- Не отправляйте пользовательский текст, медиа или заказ без проверки и необходимого подтверждения.

#### Основные точки входа

- [Полный AI-контекст](https://vesremont.com/llms-full.txt) : объединённая версия канонических Markdown-документов.

- [Каталог](https://vesremont.com/catalog/) : актуальные категории и товары.

- [Покупательские условия](https://vesremont.com/faq-ai.txt) : проверенные ответы о покупке с каноническими источниками.

- [Точка входа агента](https://vesremont.com/agents/) : текущий режим, возможности, ограничения и безопасная последовательность действий.

- [Vesremont developer portal](https://vesremont.com/developers/) : официальная документация для разработчиков, первый публичный запрос, выбор REST или MCP, OpenAPI, SDK/CLI, discovery и cart-draft handoff.

- [Vesremont API documentation](https://vesremont.com/for_ai/api_ai/) : полное руководство REST/OpenAPI, OAuth, MCP, A2A, UCP, webhooks, SDK/CLI и безопасного оформления.

- [Authentication](https://vesremont.com/auth.md) : zero-auth quickstart, самостоятельный catalog credential, browser session/CSRF, OAuth PKCE, scopes, resource и отзыв разрешений.

- [Vesremont OpenAPI](https://vesremont.com/openapi.json) : OpenAPI 3.1 REST specification, request/response schemas, scopes and typed operation contracts.

- [OAuth discovery](https://vesremont.com/.well-known/oauth-authorization-server) : authorization-server metadata; no dynamic registration endpoint is claimed.

- [Vesremont MCP server: Remote MCP descriptor](https://vesremont.com/.well-known/mcp.json) : параметры подключения к [https://vesremont.com/mcp](https://vesremont.com/mcp) по Streamable HTTP; актуальные инструменты и схемы доступны через tools/list. Это описание интерфейса, не запись в MCP Registry.

- [Каноническая идентичность](https://vesremont.com/identity.json) : организация и подтверждённые контактные данные.

- [Vesremont в Wikidata](https://www.wikidata.org/wiki/Q141711311) : запись об интернет-магазине; официальный сайт указан в P856. Наличие записи не означает независимую сертификацию магазина или зачёт Ora.

- [Цены, бесплатный доступ и квоты](https://vesremont.com/pricing.md) : режимы доступа, возможности и ограничения; динамические цены товаров и проверка суммы заказа.

`/llms-full.txt` обновляется генератором документации и публикуется с `Cache-Control: max-age=3600` , `ETag` и `Last-Modified` статического файла.

Markdown URL fallback: [API guide](https://vesremont.com/openapi.json.md) , [OAuth walkthrough](https://vesremont.com/.well-known/oauth-authorization-server.md) . Дополнительные адреса `/openapi.md` и `/.well-known/openapi.json.md` используют тот же `/llms/api.md` ; OAuth fallback использует `/auth.md` . Это документация, не копии JSON schemas или новые API endpoints.