API и интеграции

К магазину можно подключить ИИ-ассистента, свой сервис или маркетплейс: искать товары и размеры в наличии, узнавать цены, условия доставки и оплаты, статус заказа. Ниже — все способы подключения и короткие инструкции. Все они открытые и работают без регистрации.

A2A — агент магазинаПротокол Agent2Agent: поиск, карточка товара, условия, статус заказа.WebMCP в браузереИнструменты магазина для ИИ-агентов, которые работают прямо на сайте.Товарные фиды YMLКаталог с ценами и наличием для рекламы, маркетплейсов и агрегаторов.llms.txt и карта сайтаКарта магазина для ИИ-поисковиков и ассистентов, RSS блога.Другой способНужно что-то ещё — напишите, обсудим.

A2A — агент магазина

Магазин работает как агент по открытому протоколу Agent2Agent (A2A), версии 1.0 и 0.3, транспорт JSON-RPC. Любой A2A-клиент находит возможности магазина по карточке агента и дальше общается с ним сообщениями — текстом или структурированными данными.

Карточка агента: https://ohanamarket.ru/.well-known/agent-card.json
Адрес для запросов: POST https://api.ohanamarket.ru/a2a
Авторизация: не нужна — все навыки открытые

Навыки

Навык	Что делает
catalog_search	Поиск по каталогу: название, артикул, тип товара. Размеры в наличии, розничная цена, ссылка на товар.
product_details	Карточка товара по артикулу: размеры и остатки, цена и акция, состав, таблица размеров, отзывы.
shop_terms	Условия магазина: доставка, оплата, возврат, документы на товары (topic: retail, delivery, payment, return, documents).
order_status	Статус заказа: нужны номер заказа и последние 4 цифры телефона покупателя.
contact_manager	Передать вопрос менеджеру — ответ придёт на указанный телефон или e-mail в рабочее время.

Пример: поиск товара текстом

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

curl -s -X POST https://api.ohanamarket.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{
        "messageId":"1","role":"ROLE_USER",
        "parts":[{"text":"пижама женская"}]}}}'

Пример: навык явно — карточка товара

Чтобы выбрать навык явно, передайте часть data с полем skill и параметрами — например, артикулом.

curl -s -X POST https://api.ohanamarket.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":2,"method":"SendMessage","params":{"message":{
        "messageId":"2","role":"ROLE_USER",
        "parts":[{"data":{"skill":"product_details","article":"35103"}}]}}}'

Ограничения: не больше 30 запросов в минуту с одного адреса, статус заказа — не больше 10 в час, обращение менеджеру — не больше 5 в час. Цены и остатки обновляются из учётной системы каждый час.

WebMCP — инструменты для ИИ-агента в браузере

Сайт публикует свои инструменты по стандарту WebMCP (Model Context Protocol для веб-страниц). Если вы пользуетесь браузером или расширением с ИИ-агентом, поддерживающим WebMCP (например, Chrome 146+), агент на страницах ohanamarket.ru сразу видит инструменты магазина и работает с ними от имени покупателя — в его корзине и с его подтверждением.

search_products — поиск по названию или артикулу, до 10 товаров в наличии с ценой и размерами;
get_shop_terms — доставка, оплата, порядок заказа, возврат и контакты;
get_cart — содержимое корзины и сумма;
add_to_cart — положить товар нужного размера в корзину (с подтверждением покупателя);
open_page — открыть каталог, товар, корзину или оформление.

Настраивать ничего не нужно: инструменты появляются у агента, когда открыта любая страница магазина. Оформить и оплатить заказ агент не может — только открыть страницу оформления.

Товарные фиды YML

Каталог в формате YML (Яндекс): каждый размер в наличии с фото — отдельное предложение, цена — розничная (при акции — акционная и старая цена), остаток, ссылка на товар. Обновляются раз в час.

Фид каталога: https://ohanamarket.ru/feed/yandex.ymlдля рекламы и агрегаторов
Фид для Яндекс Товаров: https://ohanamarket.ru/feed/yandex-merchants.ymlдерево категорий, модель через group_id, размер, рост, цвет, состав, пол и возраст, самовывоз

llms.txt и карта сайта

Краткая карта магазина для ИИ-поисковиков и ассистентов по стандарту llmstxt.org: разделы каталога, условия, инструменты, статьи блога, контакты.

llms.txt: https://ohanamarket.ru/llms.txt
Карта сайта: https://ohanamarket.ru/sitemap.xml
RSS блога: https://ohanamarket.ru/ru/blog/rss.xml

Нужен другой способ

Обмен с вашей системой, свой формат выгрузки, подключение вашего ассистента? Напишите на info@ohanamarket.ru или позвоните +7 958 100-23-45 (круглосуточно) — обсудим.