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

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

Найти артикул или модель — Совпадение, 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. Подтверждение конкретного заказа сохраняется в обоих случаях.

Quickstart: первый API-вызов без регистрации и согласия

Публичное чтение бесплатно: не нужны аккаунт, API key, cookies или участие человека. Сразу выполните GET https://vesremont.com/api/v1/products?per_page=1. В JSON прочитайте items и id товара. Поиск по названию или артикулу — GET /api/v1/products?q={query}; подробности — GET /api/v1/products/{id}.

Read-only sandbox доступен без авторизации: только синтетический пример, без изменения корзины, оформления, оплаты и обмена с 1С. Бесплатные режимы, возможности и квоты отделены от стоимости товаров.

Для проверки выполните GET https://vesremont.com/oauth/sandbox с Accept: application/json, без Authorization и cookies. Ожидаются HTTP 200, environment: "sandbox", synthetic: true, read_only: true, orders_supported: false и товар demo-product. Браузер с Accept: text/html получает оформленную страницу по тому же адресу. Это не тестовый магазин для заказов.

Самостоятельная выдача короткоживущего catalog credential (не обязательна для первого вызова): GET /oauth/identity → POST с {"type":"anonymous"} → одноразовый обмен assertion на catalog:read → чтение → отзыв. Полный автоматический walkthrough включает endpoints и параметры. Бессрочных API keys, refresh и Claim в этом режиме нет.

Browser session/CSRF относятся к WebMCP. OAuth-согласие человека требуется для личных покупательских операций, а не для публичного каталога или sandbox; оно не заменяет отдельное подтверждение заказа.

Vesremont API и MCP: удалённые интерфейсы

Каталог доступен без авторизации. Корзина, избранное, checkout, заказы и подписки используют OAuth-разрешение покупателя. Внешний клиент не передаёт cookies браузерной сессии.

Публичный MCP handshake не открывает личные инструменты: tools/call → get_cart без токена возвращает 401; требуется cart:read с resource https://vesremont.com/mcp. MCP OAuth metadata. Для REST GET /api/v1/cart без токена также возвращает 401 с WWW-Authenticate; это ожидаемая защита, не неисправность.

Public API: полный контракт интеграции · Markdown · OpenAPI 3.1 · OAuth и CSRF.

REST: https://vesremont.com/api/v1 — машинное описание; версия 1.
MCP: https://vesremont.com/mcp — машинное описание; версия 2026-07-28.
A2A: https://vesremont.com/a2a — машинное описание; версия 1.0.
UCP: https://vesremont.com/ucp/v1 — машинное описание; версия 2026-08-25.

Получите товар или результаты поиска через REST, либо выберите MCP/A2A/UCP по его descriptor.
Для личных операций получите согласие покупателя: Authorization Code, PKCE S256 и минимальные scopes. Для нескольких интерфейсов можно запросить одно общее согласие и получить отдельные токены через ограниченный token exchange; точный resource каждого токена сохраняется. Прежние отдельные согласия также доступны.
После записи перечитайте корзину и checkout. Цену и доступные способы доставки/оплаты определяет сервер.
Для заказа выполните prepare, передайте покупателю confirmation_url и только после подтверждения отправляйте submit со стабильным Idempotency-Key. В UCP используйте continue_url и завершение на сайте.

SDK и CLI (MIT): JS/TypeScript SDK и CLI; Python SDK (wheel); Python SDK (исходники); Go SDK (исходный модуль); Ruby SDK; установка и примеры — в руководстве. Официальный репозиторий Vesremont SDK и CLI. Релиз 0.2.0 опубликован: npm — @vesremont_api/api, SDK и CLI; PyPI — vesremont-api; RubyGems — vesremont-api; Go — github.com/oooafganec-dev/vesremont-sdk/go v0.2.0. Команды установки SDK и CLI. CLI входит в тот же npm-пакет. Публикация клиентов не заменяет OAuth-разрешение покупателя и подтверждение заказа.

Официальный MCP Registry: com.vesremont/store 1.0.0 · Vesremont Remote MCP в каталоге Smithery — отдельная публичная карточка MCP-сервера магазина. Она ссылается обратно на эту страницу, upstream — https://vesremont.com/mcp. Официальная запись com.vesremont/store и карточка Smithery — разные публикации. Платный Verified badge Smithery не заявляется; запись реестра не заменяет OAuth-согласие покупателя. Vesremont в Glama — владелец домена подтверждён. Карточка Glama указывает тот же endpoint https://vesremont.com/mcp; подтверждение владельца не является OAuth-разрешением покупателя или оценкой Ora.

Webhooks используют HTTPS challenge и подпись Standard Webhooks по исходному телу ответа.

Подключение Claude Code, Cursor, Windsurf и Agent Skills

Готовые файлы опубликованы в официальном репозитории Vesremont SDK. Выберите свой клиент, проверьте конфигурацию и следуйте инструкции подключения. Это не автоматическое доверие инструментам и не разрешение на личные операции.

Для Windsurf приведён пример пользовательской настройки MCP, не проектный .windsurf/mcp.json. Правила SDK относятся к разработке клиента. Browser session-shopping skill не заменяет OAuth удалённых протоколов. Публикация файлов в GitHub не означает принятие skills.sh. Канонические skills и SHA-256.

Vesremont SDK и CLI: установка из публичных реестров

Официальные клиенты опубликованы под лицензией MIT. Команды ниже закрепляют релиз 0.2.0; выполняйте их на компьютере разработчика, а не на сервере магазина. Установка, импорт и проверка версии не вызывают API и не создают заказ. Общие исходники и offline-тесты находятся в репозитории vesremont-sdk.

JavaScript / TypeScript SDK и CLI vesremont

npm: @vesremont_api/api · исходники JavaScript · язык: JavaScript; среда: Node.js 22+; версия: 0.2.0.

Машиночитаемые npm metadata 0.2.0: имя пакета, bin.vesremont, официальный homepage и integrity архива. Если человеческая страница npm закрыта anti-bot защитой, используйте этот JSON, а не обход защиты.

SDK для REST API и устанавливаемый CLI входят в один пакет. В каталоге своего проекта выполните npm install @vesremont_api/api@0.2.0, затем npx --no-install vesremont --version и npx --no-install vesremont --help. Ожидаемая версия — 0.2.0. Для вызовов каталога CLI поддерживает команды search и product; личные операции требуют разрешения покупателя.

Python SDK Vesremont

PyPI: vesremont-api · исходники Python · язык: Python; среда: Python 3.10+; версия: 0.2.0.

В отдельном виртуальном окружении выполните python -m pip install vesremont-api==0.2.0. Импорт клиента: from vesremont_api import VesremontClient. Версия дистрибутива доступна через importlib.metadata.version("vesremont-api"). Клиент использует стандартную библиотеку Python; CLI и браузерный OAuth-мастер из npm в нём не дублируются.

Ruby SDK Vesremont

RubyGems: vesremont-api · исходники Ruby · язык: Ruby; среда: Ruby 3.3+; версия: 0.2.0.

Выполните gem install vesremont-api -v 0.2.0 --no-document. Для импорта используйте require "vesremont_api", клиент — Vesremont::Client. Проверка версии установленного gem: Gem.loaded_specs.fetch("vesremont-api").version.to_s после импорта. Библиотека предоставляет ограниченный REST-клиент с проверкой TLS, без автоматического перехода по перенаправлениям.

Go SDK Vesremont

Go packages: vesremont-sdk/go · исходники закреплённого Go-релиза · язык: Go; среда: Go 1.22+; версия: v0.2.0.

В существующем Go-модуле выполните go get github.com/oooafganec-dev/vesremont-sdk/go@v0.2.0. Импорт: github.com/oooafganec-dev/vesremont-sdk/go. Проверка зависимости: go list -m github.com/oooafganec-dev/vesremont-sdk/go. Подкаталог go опубликован тегом go/v0.2.0; это самостоятельный Go-модуль, а не npm-пакет.

Каждый реестр ссылается на официальный сайт или репозиторий. Репозиторий SDK содержит только клиентов, не серверный код магазина. По умолчанию SDK обращаются к настоящему REST API; не проверяйте запись тестовыми покупками. OAuth, scopes, подтверждение заказа и актуальные ограничения описаны в руководстве авторизации и API guide.

Vesremont WebMCP: работа в браузере

Откройте релевантную страницу Vesremont в WebMCP-совместимом браузере.
Прочитайте текущий document.modelContext и список доступных инструментов.
После навигации перечитайте контекст: каталог, товар и checkout регистрируют разные инструменты.
Для динамических данных используйте текущую страницу и повторно проверяйте корзину перед подтверждением.

Browser WebMCP и live discovery

Interaction mode: browser_webmcp
Runtime: document.modelContext
Browser entrypoint: https://vesremont.com/
Browser WebMCP authentication: browser_session_and_csrf
Guest checkout: Предварительный вход не требуется.
Tools: 27 инструментов из единого manifest source-of-truth.
REST / Remote MCP: Отдельные удалённые интерфейсы, не инструменты browser WebMCP. Endpoints и OAuth-модель; для публичного каталога cookies и OAuth не нужны.
Разрешение публикации discovery REST / MCP: true / true — отдельные флаги публикации, не проверка доступности API. Значение false не запрещает публичный поиск: выполните первый GET каталога без токена, cookies и регистрации. Browser session/CSRF к этому GET не относится.
Stateless cart draft: GET cart-drafts

Передача покупателю подборки товаров

Задача «найти артикул и прислать корзину» не требует доступа к сессии покупателя: GET /api/v1/products?q={артикул} → прочитайте items[].id совпавшего товара → GET /api/v1/cart-drafts/?product_id={id}&quantity=1 → передайте покупателю share_url. Если JSON недоступен вашему клиенту, используйте /api/v1/products.md?q={артикул} или публичный MCP search_products. Не считайте browser session/CSRF запретом публичного поиска или подписанной ссылки.

Короткая ссылка https://vesremont.com/buy/{id}:1 использует тот же перенос. Внешний агент только готовит ссылку; товар добавляется в настоящую корзину браузера покупателя защищённым POST после открытия ссылки. Нельзя добавлять товар одним GET или обращаться напрямую к /local/ajax/agent_cart_claim.php.

Публичный GET https://vesremont.com/api/v1/cart-drafts/?product_id={id}&quantity={qty} возвращает подписанную ссылку share_url. Чтобы добавить следующий товар, передайте полученный token в параметре draft нового GET-запроса. Не более 20 разных товаров; ссылка действует не более 24 часов.

Endpoint не пишет в Bitrix-корзину и не принимает цену из запроса. Покупатель открывает share_url; сайт перепроверяет текущие данные и переносит подборку в его браузерную корзину защищённым POST с CSRF. Создание заказа по ссылке невозможно. Это отдельный stateless handoff; OAuth/API checkout описан отдельно и требует согласия покупателя.

Безопасность оформления заказа

Не вызывайте submit_order сразу. Сначала вызовите prepare_order, покажите пользователю полную актуальную сводку и получите явное подтверждение. Затем один раз вызовите submit_order с confirmed: true и выданным одноразовым token.

Vesremont OpenAPI и OAuth: документация и discovery

Agent onboarding — режим, ограничения и список возможностей.
Authentication documentation — browser session, CSRF, OAuth PKCE, scopes и отзыв разрешений.
agent.json — полный manifest инструментов и аргументов.
docs/llms.txt и capabilities.md — машинно-читаемая документация.
Индексы разделов: каталог, бренды, интеграции. Каждый ведёт к нужным темам общего руководства, а не к отдельной версии API.
Agent Skills — сценарии поиска, покупок и buyer guidance.
RFC 9727 API catalog — discovery браузерного и удалённых интерфейсов.
OAuth server metadata — поддерживаемый способ авторизации и endpoints.
Markdown API guide и Markdown OAuth walkthrough — те же канонические инструкции для клиентов с Markdown URL fallback; машинный JSON-контракт не заменяют.
Remote MCP descriptor — описание существующего MCP endpoint, не запись в реестре.

Vesremont API — документация для разработчиков

Vesremont API: REST/OpenAPI, MCP и OAuth