Полная подготовка к продажам через AI-агентов для CS-Cart

Сделайте магазин понятным для AI-агентов

Покупатели всё чаще начинают поиск товара не с каталога интернет-магазина, а с ChatGPT, Claude, Perplexity, Copilot, Алисы и других AI-ассистентов. Обычная витрина рассчитана на человека: страницы, меню, фильтры и формы нужно открывать и интерпретировать. Агенту удобнее работать со структурированными документами и API.

Agent Ready добавляет к магазину машиночитаемый слой. AI-агент может определить возможности сайта, изучить каталог, найти товар, получить актуальную цену и остаток, собрать корзину, рассчитать доставку и передать заказ в CS-Cart.

Модуль подходит как для обычного интернет-магазина, так и для Multi-Vendor.

Что получает магазин

• Публичные документы для обнаружения магазина AI-агентами.
• Markdown-версии товаров, категорий и информационных страниц.
• llms.txt, llms-full.txt, AGENTS.md и машиночитаемую карту сайта.
• MCP-сервер и REST API для работы с каталогом и заказами.
• OAuth 2.0 для регистрации и безопасной авторизации агентов.
• Инструменты поиска товаров, корзины, доставки и оформления заказа.
• Товарные фиды для OpenAI Commerce и Perplexity.
• Журнал действий AI-агентов и атрибуцию оформленных заказов.
• Webhooks для передачи агентских заказов во внешние системы.
• Поддержку стандартов A2A, UCP, ACP и DNS-AID.
• Самопроверку готовности магазина к работе с AI-агентами.

Как проходит подключение

1. Проверяем магазин

Перед установкой проверяются версия CS-Cart, редакция, PHP, активные модули, особенности витрины и доступные способы оплаты и доставки.

2. Устанавливаем модуль

Модуль добавляется штатным механизмом CS-Cart. Создаются необходимые таблицы, настройки, способ оплаты и административный раздел.

3. Настраиваем возможности

Определяем:

• какие AI-краулеры можно допускать;
• разрешена ли работа с корзиной;
• можно ли оформлять заказы;
• какие OAuth scopes выдавать;
• какие товарные фиды использовать;
• нужен ли webhook;
• какие ограничения установить для заказов.

4. Запускаем самопроверку

Проверяем публичные документы, OpenAPI, MCP, OAuth, Markdown, robots.txt, фиды и другие точки обнаружения.

5. Публикуем DNS-AID

Если DNS-провайдер поддерживает SVCB/HTTPS и DNSSEC, добавляем записи для AI-каталога, MCP и A2A.

Кому подходит модуль

Интернет-магазинам на CS-Cart

Если вы хотите заранее подготовить магазин к поиску товаров и покупкам через AI-ассистентов.

Маркетплейсам на Multi-Vendor

Если нужен единый AI-каталог с возможностью учитывать настройки и opt-out отдельных продавцов.

Магазинам с собственными интеграциями

Если требуется структурированный API для AI-бота, CRM, голосового помощника или другого внешнего клиента.

Проектам, которые развивают AI-канал продаж

Если важно не ограничиваться llms.txt, а предоставить агенту полный путь от обнаружения магазина до формирования заказа.

Требования

• CS-Cart или Multi-Vendor.
• Совместимая версия платформы уточняется перед установкой.
• PHP 8.0–8.4.
• Расширения PHP: JSON, cURL и OpenSSL.
• Для Web Bot Auth требуется Sodium.
• Активный модуль Google Sitemap.
• HTTPS для публичных API и OAuth.
• Доступ к DNS-зоне — если требуется DNS-AID.
• Возможность настроить cron для регулярного обновления фидов.

Точная совместимость зависит от версии и редакции CS-Cart, темы, способов доставки, оплаты и установленных модулей. Перед подключением проводится проверка магазина.

Важно знать

• Модуль не гарантирует появление товаров в ответах конкретной AI-системы.
• Публикация технических документов не заменяет качество каталога, контента и товарных данных.
• Для работы корзины и заказа AI-клиент должен получить соответствующие OAuth scopes.
• Товарные фиды нужно генерировать и регулярно обновлять.
• DNS-AID зависит от возможностей DNS-провайдера.
• Yandex Commerce Protocol работает только в российской редакции.
• Обратные интеграции и нестандартные сценарии могут потребовать доработки.

Что сможет сделать AI-агент

Найти магазин и его возможности

Модуль публикует документы обнаружения, по которым агент понимает, что магазин предоставляет каталог, MCP-сервер, REST API и сценарии оформления заказа.

Для этого используются стандартные адреса и документы:

• /.well-known/agents.json;
• /.well-known/ai-catalog.json;
• /.well-known/mcp/server-card.json;
• /.well-known/agent-card.json;
• /openapi.json;
• /AGENTS.md;
• /sitemap.md;
• /llms.txt;
• /llms-full.txt.

В ответы обычных страниц также добавляются заголовки Link, указывающие на API, MCP и документы магазина.

Прочитать каталог без разбора HTML

Для товаров, категорий и информационных страниц создаются Markdown-представления. Агент получает чистый текст со структурой, характеристиками, ценой, доступностью, ссылками и другой полезной информацией.

Если клиент отправляет запрос с заголовком Accept: text/markdown, магазин может вернуть Markdown вместо обычной HTML-страницы.

Это уменьшает объём лишней разметки и помогает агенту точнее извлекать данные.

Найти подходящие товары

Агент может:

• искать товары по запросу;
• получать информацию о конкретном товаре;
• просматривать категории;
• учитывать варианты и опции;
• видеть актуальные цены и остатки;
• получать рейтинг и свежие отзывы;
• фильтровать товары по категории и цене через UCP.

Поиск использует каталог CS-Cart и учитывает доступность товаров для текущей витрины.

Собрать корзину

Через MCP или REST API агент может:

• создать корзину;
• добавить товар;
• изменить количество;
• удалить товар;
• передать контактные данные покупателя;
• заполнить адрес доставки;
• получить доступные способы доставки;
• выбрать доставку;
• проверить итоговую стоимость.

Корзина рассчитывается средствами CS-Cart, поэтому учитывает действующие цены, акции, налоги, варианты товаров и правила доставки.

Оформить заказ

После заполнения корзины агент может создать обычный заказ в CS-Cart.

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

Для агентских заказов создаётся отдельный способ оплаты. При необходимости можно ограничить максимальную сумму и количество товаров в заказе.

Защищённый доступ через OAuth 2.0

Модуль включает собственный OAuth 2.0-сервер для регистрации и авторизации AI-клиентов.

Поддерживаются:

• Dynamic Client Registration;
• Client Credentials;
• Authorization Code с PKCE;
• refresh tokens;
• отзыв токенов;
• introspection;
• scopes для отдельных возможностей.

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

Секреты клиентов хранятся в виде защищённых хешей. Токены не сохраняются в открытом виде. Для публичных методов действует ограничение частоты запросов.

MCP, REST API и WebMCP

MCP-сервер

Магазин получает собственный MCP-сервер по адресу /mcp. Его можно подключить к совместимому AI-клиенту и использовать инструменты магазина непосредственно из диалога.

Доступные инструменты включают:

• search_products;
• get_product;
• list_categories;
• create_cart;
• add_to_cart;
• update_cart_item;
• get_cart;
• set_customer;
• get_shipping_options;
• choose_shipping;
• place_order;
• get_order.

REST API

Те же сценарии доступны через документированный REST API. Схема API публикуется в формате OpenAPI 3.1, поэтому внешний сервис может автоматически определить методы, параметры и форматы ответов.

WebMCP

Модуль добавляет read-only инструменты WebMCP для браузерных AI-агентов. Они работают в контексте посетителя и позволяют искать и читать товары без выдачи токена на изменение корзины или создание заказа.

Каталог для AI-площадок

OpenAI Commerce

Модуль формирует товарный фид для OpenAI Commerce в форматах:

• JSONL;
• CSV;
• TSV.

В фид входят основные данные товара, цена, наличие, изображения, бренд, категории, характеристики, рейтинг и отзывы.

Perplexity Merchant Program

Для Perplexity можно сформировать:

• CSV;
• XML.

Структура основана на формате Google Merchant Center.

Universal Commerce Protocol

UCP-каталог работает без предварительной генерации файла. Агент обращается к магазину и получает актуальные товары, цены и доступность непосредственно из CS-Cart.

Фиды генерируются потоком и сохраняются в gzip. Это позволяет обрабатывать крупные каталоги без загрузки всех товаров в память одновременно.

Контроль доступа к AI-краулерам

Модуль добавляет управляемый блок в robots.txt и поддерживает Content Signals:

• ai-train — разрешение использовать содержимое для обучения;
• ai-input — использование содержимого в ответах пользователю;
• search — использование в AI-поиске.

Отдельные правила создаются для GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended и других известных AI-краулеров.

Владелец магазина может самостоятельно определить, какие сценарии разрешены.

DNS-AID: обнаружение магазина через DNS

Модуль формирует готовые DNS-AID-записи для обнаружения агентских возможностей магазина ещё до первого HTTP-запроса.

В административной панели отображаются записи для:

• общего AI-каталога;
• MCP-сервера;
• A2A-карточки.

DNS-записи нужно опубликовать у DNS-провайдера вручную. Для полноценной проверки требуется провайдер с поддержкой SVCB или HTTPS records и DNSSEC.

Это единственная часть настройки, которую нельзя выполнить непосредственно на сервере магазина.

Аналитика обращений AI-агентов

В административной панели доступен журнал активности.

Модуль фиксирует:

• вызванный инструмент;
• клиента или агента;
• поисковые запросы;
• успешные и ошибочные операции;
• созданные корзины;
• оформленные заказы;
• выручку от агентских заказов;
• конверсию корзины в заказ;
• поиски без результатов;
• время выполнения запросов.

Это позволяет понять, как AI-агенты взаимодействуют с каталогом и какие товары или запросы требуют доработки.

История активности хранится ограниченное время и может очищаться автоматически.

Заказы от AI-агентов видны отдельно

Агентские заказы не смешиваются с остальными источниками без возможности различить их.

В административной панели появляются:

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

Заказ при этом остаётся стандартным заказом CS-Cart и участвует в обычной обработке, отчётах и изменении статусов.

Webhooks для CRM и автоматизаций

После оформления агентского заказа модуль может отправить JSON webhook во внешнюю систему:

• CRM;
• n8n;
• Make;
• Zapier;
• Telegram-бот;
• собственный обработчик.

Webhook может быть защищён HMAC-подписью. Исходящие запросы также поддерживают подпись Web Bot Auth на Ed25519, чтобы принимающая система могла проверить источник запроса.

Ошибка внешнего сервиса не отменяет и не блокирует созданный заказ.

Возможности для Multi-Vendor

В Multi-Vendor каждый продавец может исключить свои товары из агентских каналов.

После opt-out товары продавца перестают попадать:

• в результаты агентского поиска;
• в товарные фиды;
• в UCP-каталог;
• в другие машиночитаемые списки модуля.

Обычная витрина магазина продолжает работать без изменений.

Кнопка «Купить» в сервисах Яндекса

В российской редакции CS-Cart модуль поддерживает Yandex Commerce Protocol.

Интеграция позволяет:

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

Функция доступна только для российской сборки CS-Cart и требует отдельной настройки в кабинете Яндекса.