Автоматизация маркетплейсов в OpenClaw: карточки, отзывы и аналитика

· 15 мин чтения

Автоматизация маркетплейсов в OpenClaw закрывает три самых рутинных участка работы селлера: тексты и характеристики карточек, ответы на отзывы и вопросы, регулярные выгрузки по продажам и поисковым запросам. Ниже — как это устроено технически, что именно умеет Ozon Seller API и Wildberries API, какие у них лимиты и как собрать первый сценарий, который не сломается на третьем дне работы.

Что такое автоматизация маркетплейсов в OpenClaw

Автоматизация маркетплейсов в OpenClaw — это настройка, при которой ИИ-агент работает с кабинетами Ozon и Wildberries напрямую по официальным API: читает заказы, отзывы и статистику, готовит тексты карточек и публикует ответы покупателям. Ключевая характеристика: агент не парсит сайт и не жмёт кнопки в личном кабинете — он обращается к тем же методам, что и любая легальная интеграция, и действует в пределах выданных ему прав токена.

Из этого сразу следует практический вывод. Всё, что вы можете сделать в кабинете руками, агент может сделать запросом — но не больше. Если у API нет метода «изменить цену на Ozon в акции», агент его тоже не найдёт. Поэтому первый шаг любой автоматизации — не промпт, а чтение документации площадки.

Три типа задач, и они не взаимозаменяемы

Путаница в этих типах — главная причина, почему «ИИ для маркетплейса» не даёт результата.

  • Контент (карточки). Агент генерирует название, описание, характеристики и загружает их пакетом. Работает по расписанию или по команде, человек проверяет перед публикацией.
  • Коммуникация (отзывы и вопросы). Тут важна скорость: покупатель ждёт ответа, а площадка учитывает время реакции. Нужен цикл «опросить новые отзывы → сгенерировать ответ → отправить», то есть cron-задача или вебхук.
  • Аналитика (выгрузки). Раз в день или неделю агент забирает цифры, считает отклонения и присылает сводку в Telegram. Живая реакция не нужна — достаточно расписания.

Это принципиальное отличие от готовых сервисов автоответов, которые продают вам одну функцию в подписке. У OpenClaw нет встроенного «модуля для Wildberries»: агент получает доступ к API и набор инструкций, а сценарий вы собираете сами. Зато один и тот же агент закрывает и Ozon, и WB, и склад, и 1С — потому что для него это просто ещё один HTTP-эндпоинт.

Чем агент дотягивается до API маркетплейса

Технически у OpenClaw четыре пути к внешней системе, и на маркетплейсах используются все четыре.

1. Команды и скрипты. Самый быстрый способ проверить доступ: агент выполняет curl или Python-скрипт и получает JSON. Ничего устанавливать не нужно.

2. Скиллы. Если операция повторяется — «сгенерируй описание по стандарту бренда», «ответь на отзыв по правилам», — её оформляют в файл инструкций SKILL.md. Агент подгружает скилл при старте и действует по нему. Скиллы — это markdown-файлы с YAML-метаданными и телом, лежат они, например, в <workspace>/skills/<имя>/SKILL.md, а проверить, что они видны, можно командой openclaw skills list. Разбор того, как их писать, есть в статье Навыки (skills) в OpenClaw.

3. Задачи по расписанию. Цикл «опросить новые отзывы каждые 15 минут» — это встроенный планировщик:

openclaw automations create "*/15 * * * *" \
  "Проверь новые отзывы на Wildberries и Ozon. Для отзывов с оценкой 1–3 подготовь ответ на проверку." \
  --name "Отзывы: проверка" \
  --session isolated

4. Вебхуки на вход. Если нужно реагировать на событие мгновенно, внешняя система стучится в шлюз сама: включается секция hooks с обязательным токеном, и запросы принимаются только с заголовком Authorization: Bearer. Для маркетплейсов этот путь работает редко — площадки не умеют присылать вебхуки «есть новый отзыв», поэтому основа всё равно — опрос по расписанию.

Ozon Seller API: что реально доступно

Базовые параметры, без которых ничего не заработает: адрес https://api-seller.ozon.ru, в каждом запросе два заголовка — Client-Id и Api-Key. Оба ключа продавец получает в личном кабинете и может ограничить их правами.

Лимиты: два разных порога

  • 50 запросов в секунду на один Client-Id — это общий лимит на все методы, потоки и пользователей вместе. Введён 19 мая 2025 и действует постоянно.
  • 30 000 операций с товарами в минуту — отдельный лимит на операции с ассортиментом, введён с 24 февраля 2026 для методов /v3/product/import, /v1/product/attributes/update, /v1/product/update/offer-id, /v1/product/pictures/import и /v1/product/import-by-sku.

Превышение даёт ошибку 429 Too Many Requests. Формулировка у Ozon конкретная и полезная для автоматики: в тексте ошибки указано, через сколько секунд можно повторить запрос и сколько товаров осталось в доступном лимите. Если в запросе товаров больше, чем доступно, не принимается ни один — запрос падает целиком, а не частично.

Отдельно про ассортимент: у продавца есть суточные квоты на создание и обновление товаров. Проверяются они методом /v4/product/info/limit, который возвращает лимит, текущее использование и время сброса. Агент, который заливает каталог, обязан спрашивать этот метод перед пакетной загрузкой — иначе получит item_limit_exceeded.

Карточки: как агент их загружает

Импорт идёт через /v3/product/import: в одном запросе передаётся до 100 товаров, каждый — отдельный элемент массива items с характеристиками, штрихкодом, изображениями, габаритами и ценой. Обязательные атрибуты зависят от категории: их список отдаёт метод /v3/category/attribute (в новых версиях — методы /v1/description-category/...), а дерево категорий — /v2/category/tree.

Практическая деталь, которая экономит дни работы: перед генерацией текста агент забирает из API реальные характеристики товара — не придумывает их. Ошибка «модель сочинила состав» дороже, чем выглядит: расхождение описания с товаром на маркетплейсе приводит к возвратам и жалобам.

Ещё одна вещь, о которой узнают из ошибок: Ozon регулярно отключает старые версии методов. В феврале 2025 прошла волна замен: /v2/product/list → /v3/product/list, /v3/products/info/attributes → /v4, /v4/product/info/prices → /v5. Если агент использует зашитый в скилл устаревший эндпоинт, он однажды перестанет работать без изменений на стороне площадки. Хорошая практика — держать версии методов в одном месте скилла и проверять журнал обновлений Ozon for dev.

Отзывы и вопросы: важная оговорка

Методы управления отзывами у Ozon появились в Seller API в декабре 2024, и есть подписка-ограничение: они доступны только по подписке Premium Plus. Список методов:

  • /v1/review/list — список отзывов, фильтр по статусу ALL, UNPROCESSED, PROCESSED, сортировка и постраничная выдача (по 20–100 записей);
  • /v1/review/info — данные по конкретному отзыву;
  • /v1/review/count — количество отзывов по статусам;
  • /v1/review/change-status — пометить отзывы обработанными;
  • /v1/review/comment/list — комментарии к отзыву;
  • /v1/review/comment/create — оставить ответ (в теле: review_id, text и флаг mark_review_as_processed);
  • /v1/review/comment/delete — удалить комментарий.

С вопросами покупателей логика такая же: /v1/question/answer/create и /v1/question/answer/list.

Отдельно существует Ozon Statistics API — это другой контур с другой авторизацией (Access-Key и Client-Id, ключ выдаёт менеджер). Он полезен для аналитики и часто оказывается доступнее: метод /v1/reviews/by-item отдаёт 100 последних отзывов по товару, /v1/rating — рейтинг и распределение оценок, /v1/search-queries/top — популярные поисковые запросы. То есть читать обратную связь можно и без Premium Plus — отвечать через API, увы, только с ним.

Wildberries API: что реально доступно

WB-API разнесён по доменам, и у каждого — свои лимиты. Это не деталь, а суть работы с площадкой.

Категория Домен Зачем
Контент content-api.wildberries.ru карточки товаров, медиафайлы
Вопросы и отзывы feedbacks-api.wildberries.ru отзывы, вопросы, ответы
Аналитика seller-analytics-api.wildberries.ru воронка продаж, поисковые запросы
Цены и скидки discounts-prices-api.wildberries.ru цены, скидки, акции
Marketplace marketplace-api.wildberries.ru заказы, сборочные задания, склады
Чат с покупателями buyer-chat-api.wildberries.ru переписка в карточке

Авторизация — токен, который создаётся в личном кабинете. Токен выдаётся с ограниченным набором категорий: если агенту нужны только отзывы, ему не следует давать категорию «Маркетплейс» или «Финансы». Отозвать токен можно в любой момент — это ваша страховка.

Лимиты: token bucket и заголовок X-Ratelimit-Remaining

Лимиты WB устроены по алгоритму «ведро с токенами»: у каждого лимита есть период, количество запросов, рекомендуемый интервал между запросами и всплеск (сколько запросов можно отправить залпом без пауз). Пример для категории «Маркетплейс» при персональном токене: 300 запросов в минуту, интервал 200 мс, всплеск 20. У базового токена — 150 запросов в минуту.

Что это значит на практике: лимит можно выехать не «средним темпом», а залпом — и получить 429, даже если вы вроде бы укладываетесь в минуту. В ответе любой успешный запрос возвращает заголовок X-Ratelimit-Remaining — сколько запросов можно отправить прямо сейчас без паузы. Агент, который читает этот заголовок, тормозит себя сам и не упирается в блокировку.

Конкретные лимиты по ключевым методам:

  • /content/v2/get/cards/list — 100 запросов в минуту, интервал 600 мс, всплеск 5; за один запрос возвращается максимум 100 карточек;
  • /content/v2/cards/update — отдельный, куда более жёсткий лимит: 10 запросов в минуту, интервал 6 секунд, всплеск 5. Зато одним запросом можно отредактировать до 3000 карточек, размер тела — до 10 МБ;
  • все методы категории «Вопросы и отзывы» — 3 запроса в секунду, интервал 333 мс, всплеск 6 (у базового токена — 5 запросов в час);
  • /api/analytics/v3/sales-funnel/products/history — 3 запроса в минуту с интервалом 20 секунд.

Отзывы: полный цикл на трёх методах

Для работы с отзывами WB нужны буквально три вызова:

  1. GET /api/v1/new-feedbacks-questions — есть ли непросмотренные отзывы и вопросы. Возвращает hasNewFeedbacks и hasNewQuestions, то есть подходит как дешёвая «проверка почты» для агента.
  2. GET /api/v1/feedbacks?isAnswered=false&take=100&skip=0 — список необработанных отзывов. Параметр isAnswered обязательный, take принимает до 5000 отзывов, skip — до 199990. Отзыв считается обработанным, если на него ответили или если он содержит только оценку без текста и фото.
  3. POST /api/v1/feedbacks/answer — публикация ответа: в теле id отзыва и text. Ответ можно отредактировать — но только один раз и в течение 60 дней после отправки.

Плюс два счётчика для сводок: /api/v1/feedbacks/count-unanswered и /api/v1/questions/count-unanswered.

Важный нюанс про заголовок карточки: в методе /content/v2/cards/update поле title ограничено 60 символами. Это не «рекомендация» — превышение вернёт ошибку валидации. После массового обновления карточек синхронизация с сервисами WB занимает до 30 минут, и в это время нельзя добавлять остатки на склады и настраивать цены — то есть массовое обновление контента лучше не совмещать с операциями по складу.

Аналитика: воронка продаж и поисковые запросы

Самое ценное для SEO-работы — методы поисковых запросов: POST /api/v2/search-report/product/search-texts отдаёт топ запросов, по которым показывался конкретный товар, а /api/v2/search-report/product/orders — заказы и позиции по каждому запросу (данные группируются по дням, максимальный интервал — 7 дней). В ответе search-texts максимум 30 запросов, а на тарифах «Продвинутый» и «Премиальный» — 100.

Сводная аналитика по ассортименту — POST /api/analytics/v3/sales-funnel/products: данные по переходам в карточку, добавлениям в корзину, заказам и выкупам за период до 365 дней, с обновлением раз в 2 часа. Большие выгрузки делаются асинхронно: создаёте задание методом POST /api/v2/nm-report/downloads, проверяете статус через GET, потом скачиваете готовый ZIP с CSV — файлы хранятся 48 часов. Для периодов больше недели нужна подписка «Джем».

Как это выглядит в работе: сценарий с отзывами

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

Как это собирается в OpenClaw:

  1. Проверка. Раз в 15 минут cron-задача вызывает /api/v1/new-feedbacks-questions. Если новых отзывов нет, агент завершается одной строкой — без обращения к модели. Это экономит токены: пустые проверки почти ничего не стоят.
  2. Выборка. Появились новые — агент забирает список через /api/v1/feedbacks?isAnswered=false. Он видит оценку, текст, достоинства и недостатки, артикул и наличие фото.
  3. Классификация. Отзыв оценивается по простым признакам: оценка 4–5 и короткий текст — шаблон-благодарность; оценка 1–3 или упоминание брака, денег, возврата — черновик с обязательной проверкой человеком. Такие случаи разумно сразу отправлять менеджеру, а не публиковать автоматически.
  4. Черновик ответа. Модель получает текст отзыва, название и характеристики товара, тон бренда и правила: не спорить с покупателем, не обещать компенсацию, не давать медицинских и юридических обещаний.
  5. Публикация. Ответ уходит через POST /api/v1/feedbacks/answer. Если включён режим «сначала проверка», черновики складываются в файл, а агент присылает их вам в Telegram — и публикует только после подтверждения.

Стоимость такого цикла оценивается не на глаз: у открытого проекта ai-wildberries-review-responder (сервис ответов на отзывы WB на базе LLM) в описании приведены производственные замеры — около 0,25 ₽ за один отзыв при работе через облачные функции и токенную модель. Это порядок величин, к которому стоит стремиться: ответы на 100 отзывов в месяц — это десятки рублей, а не подписка на сервис. Разбор того, из чего складывается расход у самого агента, — в статье Стоимость OpenClaw: сколько стоит содержание агента.

Практические шаги: с чего начать

  1. Определите один сценарий. Не «автоматизировать маркетплейсы», а «раз в день присылать список неотвеченных отзывов с готовыми черновиками».
  2. Выясните, какие методы API вам вообще доступны. На Ozon ответы на отзывы требуют Premium Plus, на WB — токен категории «Вопросы и отзывы». Проверьте это до того, как писать промпты.
  3. Выдайте агенту токен с минимальными правами. Только чтение плюс те действия, которые нужны сценарию. Токен храните в переменных окружения, не в тексте скилла.
  4. Сделайте один ручной запрос. curl с вашими ключами и проверка, что ответ приходит. Без этого шага любая автоматизация — гадание.
  5. Опишите правила в скилле. Тон ответов, что запрещено, как обращаться с оценкой 1 звезда, какие формулировки согласованы с вашим юристом.
  6. Прогоните на пяти реальных отзывах и прочитайте каждый ответ глазами. Только после этого включайте публикацию.
  7. Поставьте на расписание — cron-задача с --session isolated, чтобы цикл не мешал основному диалогу с агентом.
  8. Добавьте лимиты в код сценария. Задержку между запросами, обработку 429 и чтение X-Ratelimit-Remaining. Агент без тормозов получит блокировку в первый же массовый прогон.

Где узкие места

Лимиты — не рекомендации, а пороги. У Ozon это 50 RPS на кабинет, у WB — 3 запроса в секунду на отзывах и 10 запросов в минуту на обновлении карточек. Массовые сценарии обязаны уметь замедляться и повторять запросы.

Токены и права. WB-токен создаётся под конкретные категории, Ozon-ключ — под права в кабинете. Если агент должен только читать отзывы, не давайте ему категорию «Финансы». Общие принципы разобраны в статье Безопасность OpenClaw.

Факты о товаре — только из карточки. Характеристики, состав, габариты и комплектация берутся из API, а не придумываются моделью. Это главный источник дорогих ошибок в контентной автоматизации.

Модерация и задержки. Карточка после загрузки проходит проверку, а синхронизация правок на WB может занимать до 30 минут. Сценарий, который сразу после обновления описания пытается менять цены, будет получать ошибки.

Человеческий контроль. Благодарность за 5 звёзд можно публиковать автоматически. Спор о браке, возврат денег и любые юридические формулировки — нет. Разумная граница: агент готовит, человек утверждает.

FAQ

Можно ли подключить к OpenClaw сразу Ozon и Wildberries?

Да, это два независимых подключения, и лимиты у них считаются отдельно. Агент может держать общий файл правил тона и стандартов бренда, а различия площадок описывать в отдельных скиллах — требования к заголовку и описанию у них разные.

Нужно ли программировать?

Для первого сценария — нет. Чтение отзывов и публикация ответа — это два HTTP-запроса, которые агент выполняет сам по инструкции из скилла. Программирование понадобится, когда захочется сложной логики: очередей, ретраев после 429, сверки данных между площадкой и вашей учётной системой.

Автоматические ответы на отзывы — это не бан?

Нет, если работа идёт через официальный API и токен выдан самим продавцом. Парсинг сайта, эмуляция браузера и «серые» расширения — вот что нарушает правила площадок. Все методы, описанные выше, легальны и предназначены для интеграций.

Что делать, если агент ответил на отзыв с ошибкой?

На WB ответ можно отредактировать — но только один раз в течение 60 дней. Это ещё один аргумент за схему «черновик → проверка человеком → публикация» на первых неделях работы.

Сколько это стоит?

Расход складывается из подписки на модель и времени работы сервера. По замерам открытого проекта ответов на отзывы WB выходит порядка 0,25 ₽ за отзыв; выгрузки аналитики почти бесплатны, потому что это один запрос и короткая сводка — если не пересылать модели всю таблицу целиком.

А если сервера нет?

Тогда сначала нужно развернуть агента: пошагово это описано в статье Установка OpenClaw на VPS. Есть и более быстрый путь — сервисы вроде Neirohost, где агент поднимается с уже настроенным окружением и на него можно сразу ставить задачу по маркетплейсу, не занимаясь установкой. Принцип при этом не меняется: сначала один проверенный сценарий, потом расширение.

Что почитать дальше