Руководство по коннектору10 мин чтенияMCP-инструментов: 297 языков

Подключить Rozetka MCP к Gemini CLI

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

HCАвтор: команда HelpCodeОбновлено 10 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Rozetka Marketplace

Rozetka Marketplace

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

инструментов

29

Регион

INTL

Категория

Электронная коммерция

Аутентификация

Sign-in token

Требуемые env-vars

ROZETKA_USERNAMEROZETKA_PASSWORD_BASE64
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Пошаговая настройка

Подключи Rozetka Marketplace к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Rozetka Marketplace в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для Rozetka Marketplace

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Rozetka Marketplace · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Rozetka Marketplace, вставь свои учетные данные, создай ключ API MCP, и все готово. Никакого Docker, никакого git clone, никакого локального сервера.

Rozetka Marketplace + Gemini

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Предварительные требования

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64

Шаг 1 — Получи учетные данные

API входит с логином и паролем кабинета продавца Rozetka (seller.rozetka.com.ua); отдельного ключа API нет.

  1. Помести логин кабинета в ROZETKA_USERNAME.
  2. Rozetka ожидает, что пароль будет закодирован в Base64, поэтому ROZETKA_PASSWORD_BASE64 принимает закодированную форму, а не обычный пароль. Закодируй его на своем компьютере, например, в терминале printf '%s' 'your-password' | base64, и вставь результат. Не используй онлайн-кодировщик для реального пароля. AnythingMCP входит с помощью POST /sites и отправляет токен сессии в качестве токена Bearer. Rozetka поддерживает токен активным, пока он используется, и позволяет ему истечь через 24 часа без использования; коннектор снова входит каждые четыре часа. Неправильный логин или пароль сообщается как incorrect_username_password.

С чего начать: rozetka_get_order_counts и rozetka_get_message_counts показывают, что ждет (новые заказы, непрочитанные чаты, открытые запросы на возврат). Затем rozetka_list_orders с types=4 (новые) или types=2 (в обработке).

Заказы

  • rozetka_list_order_statuses сопоставляет числовой status заказа с его названием. rozetka_list_orders фильтрует по types (1 все, 2 в обработке, 3 завершенные, 4 новые, 5 в доставке, 6 неудачные), статусу или датам; rozetka_get_order читает один заказ. Добавь expand=purchases,delivery,user для товаров, доставки и покупателя, и status_available для статусов, к которым заказ может перейти дальше.
  • rozetka_update_order изменяет статус, добавляет накладную (ТТН) и комментарий продавца. Обычный процесс: новый заказ (1) -> подтвердить с 2 (упаковывается) -> добавить ТТН со статусом 3 (передан перевозчику) или 61 (передача запланирована); ТТН, отправленный со статусом 2, переводит заказ в 61. После добавления ТТН Rozetka отслеживает посылку и изменяет статус самостоятельно. Статусы 7 и выше в основном являются отменами или состояниями доставки (например, 16/42 нет в наличии, 18 покупатель недоступен, 40 покупатель передумал, 45 отменено покупателем): устанавливай отмену только тогда, когда продавец просит, это нельзя отменить. Сначала проверь status_available.
  • rozetka_get_order_payment_status сообщает, оплачена ли онлайн-оплата, не оплачена, проверяется или отменена (кэшируется 5 минут).

Товары и цены

  • rozetka_list_goods и rozetka_get_goods читают товары продавца; rozetka_get_goods_counts подсчитывает их по вкладкам кабинета (ошибки, модерация, ожидание подтверждения).
  • rozetka_update_goods_price_stock изменяет цену и запас для одного или нескольких товаров по item_rz_id (идентификатор Rozetka, id/rz_item_id в списке товаров, не внутренний item_id). Цены указаны в гривнах. Rozetka удерживает цену, поднятую более чем в 1,5 раза или сниженную более чем вдвое, для подтверждения менеджером.
  • Идентификаторы статусов товаров: 0 заблокирован, 1 активен, 2 новый, 3 в очереди на модерацию, 4 на модерации, 5 отклонен модерацией, 6 требует подтверждения модератора, 7 архивирован, 8 ожидает модерации. Статус продажи: 0 недоступен, 1 ожидается поставка, 2 звонок, 3 заканчивается, 4 доступен, 5 архив, 6 строго недоступен, 7 нет в наличии, 8 скрыт.
  • Новое объявление: rozetka_list_goods_categories (найди категорию; is_vendor_required 1 означает, что производитель обязателен) -> rozetka_list_category_attributes (его характеристики; увеличь pageSize, API возвращает 5 по умолчанию) -> rozetka_list_attribute_values (разрешенные значения для характеристик типа список) -> rozetka_list_producers -> rozetka_create_goods с русским и украинским названием, ценой, запасом и URL изображений. Новые товары проходят модерацию Rozetka перед тем, как они будут показаны.

Отзывы, вопросы и чаты

  • Отзывы о магазине: rozetka_list_store_reviews (например, reply_search=0 для отзывов без ответа, vote=dislike для негативных), затем rozetka_reply_store_review с id отзыва и его order_id.
  • Отзывы и вопросы о продуктах: rozetka_list_goods_comments с isAnswered=0 перечисляет темы, ожидающие продавца; ответь с помощью rozetka_reply_goods_comment (parent_id = id комментария, item_id = item.id).
  • Чаты: rozetka_list_chats (msgType=orders для чатов по заказам, items для вопросов о продуктах, has_response_to_user=0 для непрочитанных), rozetka_get_chat для чтения сообщений (это помечает их как прочитанные), rozetka_get_order_chat для нахождения чата заказа и rozetka_send_message с chat_id и user_id покупателя как receiver_id.
  • Ответы, ответы и сообщения являются публичными или доходят до покупателя: подготовь текст, покажи его продавцу и отправь только после их согласия. Пиши на языке покупателя, обычно на украинском. Ответы и ответы на продукты модерация Rozetka перед тем, как они появятся.

Возвраты: rozetka_list_refund_requests (коды статусов из rozetka_list_refund_statuses), rozetka_get_refund_request для причины, решения, которое хочет покупатель, и чата, и rozetka_save_refund_ttn для хранения накладной на возврат. rozetka_update_refund_status (принять или отклонить запрос) установлен выключенным, потому что принятие может вернуть деньги покупателю; администратор включает его намеренно. Идентификаторы запросов на возврат содержат буквы (например, AM1234567).

Не включено: балансы, счета, платежи, фискальные чеки (PRRO), создание оплаченной накладной с перевозчиками, учетные записи менеджеров и удаления. Коннектор никогда не перемещает деньги.

Форматы и особенности

  • Rozetka отвечает HTTP 200 даже при сбое вызова, с success: false; коннектор преобразует это в ошибку с errors.message и errors.code, например, incorrect_access_token (1020) или access_denied (1010, роль аккаунта не имеет прав).
  • Цены указаны в гривнах. Даты в фильтрах — YYYY-MM-DD; временные метки приходят как YYYY-MM-DD HH:MM:SS без часового пояса.
  • Тексты приходят на языке кабинета (украинском или русском); запросы на возврат отвечают на украинском.

Пагинация и лимиты: списки находятся под content с _meta (totalCount, pageCount, currentPage, perPage). Вызывай снова с page + 1, пока currentPage не станет равным pageCount. Заказы, отзывы и чаты приходят по 20 на страницу; товары, категории и директории принимают pageSize. Лимит частоты не опубликован; избегай плотных циклов и предпочитай одно массовое обновление множеству отдельных.

Доступность облака: api-seller.rozetka.com.ua доступен по HTTPS, доступен из AnythingMCP Cloud и из самохостинговых установок.

Шаг 2 — Установи адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Rozetka Marketplace.

Доступные инструменты

ИнструментЧто он делает
rozetka_list_ordersПоиск заказов продавца на Rozetka, 20 на странице, по группе статусов, статусу, дате создания или изменения, id заказа, телефону покупателя или накладной (ТТН).…
rozetka_get_orderПолучить один заказ Rozetka по id с суммами, статусом и комментариями. Используй expand для товаров (покупок), доставки, покупателя (пользователя), истории статуса…
rozetka_list_order_statusesСписок статусов заказов Rozetka с id, украинским, русским и английским названием и группой статусов, чтобы прочитать числовой статус заказа
rozetka_list_goodsПоиск товаров продавца на Rozetka (все вкладки) по названию, тексту, артикулу, id прайс-листа или id Rozetka, доступности или категории. Возвращает id…
rozetka_get_goodsПолучить детали одного из товаров продавца на Rozetka (цены, категория, описание, состояние запасов) по внутреннему item_id или по…
rozetka_update_orderИзменить статус заказа Rozetka, добавить номер накладной (ТТН) и/или комментарий продавца. Возвращает обновленный заказ. ТТН обязательна…
rozetka_get_order_countsПодсчитать заказы продавца на Rozetka по группам: inProgress (в обработке), новые, доставляемые, inDone (завершенные), inNotDone (неудачные), непросмотренные…
rozetka_get_order_payment_statusПолучить текущий статус оплаты заказа, оплаченного онлайн: status_payment_id, имя (оплачено, не оплачено, отменено, не одобрено, частично оплачено ...)…
rozetka_update_goods_price_stockОбновить цену и запас одного или нескольких товаров продавца за один вызов (массовое обновление). Каждая запись требует item_rz_id (идентификатор Rozetka, id в…
rozetka_get_goods_countsПодсчитать товары продавца по разделам кабинета: активные, неактивные, новые, на модерации, ожидающие подтверждения, ожидающие одобрения…
rozetka_create_goodsСоздать новое объявление о продукте в кабинете продавца Rozetka. Требуются русское и украинское название, категория из…
rozetka_list_goods_categoriesПоиск категорий Rozetka, в которых продавец может создавать товары, по названию или id. Возвращает id, украинское, русское и английское название…
rozetka_list_category_attributesСписок характеристик (атрибутов) категории Rozetka, необходимых для параметров в rozetka_create_goods. Возвращает id, названия, единицу, тип…
rozetka_list_attribute_valuesСписок разрешенных значений одной или нескольких характеристик в категории (id, украинское, русское и английское название), для параметров типа список в…
rozetka_list_producersПоиск директории производителей Rozetka (брендов) по названию или id, для производителя rozetka_create_goods. Возвращает id, название и статус, 100…
rozetka_list_store_reviewsПоиск отзывов покупателей о магазине (не о продукте): id, order_id, имя покупателя, комментарий, общий голос (нравится, средний, не нравится), голоса за…
rozetka_reply_store_reviewОпубликовать публичный ответ продавца на отзыв о магазине. Требуется id отзыва и его order_id из rozetka_list_store_reviews. Возвращает ответ…
rozetka_list_goods_commentsПоиск отзывов и вопросов покупателей о товарах продавца: id, тип (комментарий или вопрос), текст, оценка (рейтинг 1-5), плюсы и минусы, автор…
rozetka_reply_goods_commentОпубликовать публичный ответ продавца на отзыв или вопрос о продукте. parent_id — это id комментария, а item_id — item.id из…
rozetka_get_message_countsПодсчитать непрочитанные и общие чаты и запросы покупателей: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread…
rozetka_list_chatsПоиск чатов продавца с покупателями: чаты по заказам, вопросы о продуктах или удаленные чаты. Возвращает id чата, тему, покупателя (user_id, имя)…
rozetka_get_chatОткрыть один чат с покупателем, с его сообщениями по умолчанию. Возвращает тему, user_id покупателя (receiver_id для rozetka_send_message)…
rozetka_get_order_chatПолучить чат, принадлежащий заказу, по id заказа: id чата, тема, user_id покупателя и, с expand, сообщения. Используй это, чтобы написать…
rozetka_send_messageОтправить сообщение покупателю в существующем чате. Требуются chat_id и receiver_id (user_id покупателя из rozetka_get_chat или…
rozetka_list_refund_requestsПоиск запросов на возврат и возврат покупателей: id запроса (буквы и цифры, например, AM1234567), status_title, reason_title, order_id, название товара…
rozetka_get_refund_requestПолучить один запрос на возврат или возврат: статус, причина и подпричина с комментарием покупателя, желаемое решение (decision_title), заказ и товар…
rozetka_list_refund_statusesСписок кодов статусов запросов на возврат и возврат (status_code с его украинским названием), для фильтрации rozetka_list_refund_requests и…
rozetka_save_refund_ttnСохранить накладную (ТТН) возвратной посылки по запросу на возврат, например, когда продавец отправляет замену или возврат покупателя…
rozetka_update_refund_statusПереместить запрос на возврат или возврат в другой статус (принять, отклонить с причиной, товар получен ...). Принятие запроса может привести к…

Примеры подсказок

  • "Сколько новых заказов Rozetka и непрочитанных сообщений от покупателей у меня?"
  • "Покажи заказ 123456789 с покупателем, доставкой и товарами."
  • "Установи цену товара 987654 на 1,499 грн и запас на 20."
  • "Какие отзывы о магазине за эту неделю еще не имеют ответа? Подготовь ответ для каждого."
  • "Добавь накладную Nova Poshta 20450000000000 к заказу 123456789 и отметь его как отправленный."

Часто задаваемые вопросы

Какой логин используется? Твой логин кабинета продавца Rozetka (seller.rozetka.com.ua), с паролем, закодированным в Base64. Коннектор снова входит каждые четыре часа.

Может ли он изменять заказы и цены? Да: статус заказа и накладная (ТТН), массовые обновления цен и запасов, новые товары, ответы на отзывы, вопросы и чаты с покупателями. Изменение статуса запроса на возврат установлено выключенным, потому что принятие возврата может вернуть деньги покупателю.

Касается ли это балансов или платежей? Нет. Балансы, счета, платежи, фискальные чеки (PRRO) и создание оплаченной накладной с перевозчиками не включены.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

Это руководство помогло?

Подключи Rozetka Marketplace к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Rozetka Marketplace в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключить Rozetka MCP к Microsoft Copilot

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к ChatGPT

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Claude

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Cursor

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Meta Muse

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Rozetka MCP-сервер: заказы, товары и остатки

API продавца Rozetka Marketplace для крупнейшей торговой площадки Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов и новыми объявлениями, отзывы о магазине и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход через логин кабинета продавца.