Кратко
API ZALORA Seller Center v2 для продавцов на модной платформе Сингапура, Малайзии, Индонезии, Филиппин и Гонконга: заказы и позиции заказов, упаковка, отслеживание и документы на отправку, продукты и наборы продуктов, запасы, цены по странам, бренды и категории. ID приложения OAuth и секрет.
Пошаговая настройка
Подключи ZALORA к Cursor за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи ZALORA в пошаговой настройке и добавь свой MCP URL в Cursor. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для ZALORA
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → ZALORA, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
ZALORA + Cursor
API ZALORA Seller Center v2 для продавцов на модной платформе Сингапура, Малайзии, Индонезии, Филиппин и Гонконга: заказы и позиции заказов, упаковка, отслеживание и документы на отправку, продукты и наборы продуктов, запасы, цены по странам, бренды и категории. ID приложения OAuth и секрет.
Предварительные требования
См. полные инструкции по настройке, встроенные в коннектор (видно в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_CLIENT_SECRET
Шаг 1 — Получи учетные данные
Настройка занимает около 5 минут.
- Войди в ZALORA Seller Center с пользователем, у которого есть роль Seller Full Access.
- Открой Настройки, Управление интеграцией, OAuth Приложения и создай приложение. Скопируй Application ID в
ZALORA_CLIENT_IDи Application Secret вZALORA_CLIENT_SECRET. Секрет показывается только один раз. - Выбери свою страну Seller Center в
ZALORA_DOMAIN: Сингапурzalora.sg, Малайзияzalora.com.my, Индонезияzalora.co.id, Филиппиныzalora.com.ph, Гонконгzalora.com.hk.
Коннектор обменивает два значения на https://sellercenter.<country domain>/oauth/client-credentials (учетные данные клиента, HTTP Basic) для получения токена доступа, который действует один час, и обновляет его по истечении срока. Нет областей действия: приложение может делать то, что позволяет роль его создателя.
С чего начать: zalora_get_order_counters для общего обзора, затем zalora_list_orders с разделом status_pending (заказы на упаковку) и zalora_get_order для получения позиций, адресов и цен.
Заказы: zalora_list_orders, zalora_get_order, zalora_list_order_items, zalora_get_order_history, zalora_get_order_item_returns. id заказа является числовым и используется инструментами; number — это то, что видит клиент. Статусы находятся на позициях: pending, ready_to_ship, shipped, delivered, failed, canceled, returned и состояния возвратов.
Упаковка и отправка: сначала проверь zalora_list_shipment_providers. zalora_set_ready_to_ship упаковывает ожидающие позиции одного заказа в пакет с номером отслеживания (опционально только для поставщиков с apiIntegrationAvailable true); zalora_set_packed_by_marketplace передает отправку логистике ZALORA. Продавцы дропшиппинга затем используют zalora_set_shipped и zalora_set_delivered. zalora_update_tracking_code и zalora_update_shipping_provider корректируют готовый к отправке пакет. zalora_print_document возвращает этикетку для отправки, счет-фактуру или список для сборки в формате base64 PDF (202, пока этикетка всё ещё создаётся). Обрати внимание на ключ позиции: id в set_ready_to_ship, orderItemId в set_packed_by_marketplace.
Выключено при установке: zalora_cancel_order_items (не может быть отменено, клиенту возвращается деньги), zalora_set_delivery_failed, zalora_approve_return (приводит к возврату средств) и zalora_set_price_status (неактивный убирает продукт с продажи). Причины для отмен и неудачных доставок берутся из zalora_list_failure_reasons. Включай инструмент в коннекторе только тогда, когда рабочее пространство хочет, чтобы ИИ это делал.
Каталог: набор продуктов — это элемент каталога; его продукты — это вариации (размеры, цвета), каждая с собственным числовым идентификатором продукта, используемым для запасов и цен. zalora_list_products (поиск по SKU продавца), zalora_list_product_sets, zalora_list_product_set_products, zalora_list_brands, zalora_get_category_tree (большой: получи один раз), zalora_get_category_attributes, zalora_get_seller.
Запасы и цены: zalora_get_product_stock, zalora_get_product_set_stock и zalora_update_stock (абсолютные количества, до 100 продуктов за вызов, только когда запасы действительно изменились; не для продуктов, выполненных ZALORA). zalora_get_product_set_prices показывает цены по странам; zalora_update_price изменяет цену, цену со скидкой и даты распродажи одного продукта в одной стране (только поля, которые ты отправляешь). Создание продуктов, массовый импорт и фиды не включены.
Пагинация: списки принимают limit и offset; ответ содержит pagination с hasNext (заказы, позиции заказов) или totalCount (продукты, бренды). Наборы продуктов и бренды возвращают максимум 100 строк.
Ограничение по частоте запросов: 30 запросов в секунду на продавца, общие для каждого приложения и токена; выше этого ZALORA отвечает 429. Ошибки содержат реальный HTTP статус с title и detail (422 — это ошибка валидации с указанием поля, 503 — режим обслуживания).
Шаг 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 — Добавь коннектор в Cursor
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти Cursor.
- Открой Cursor → Settings → MCP и проверь, что
anythingmcpесть в списке и подключён. - Начинай общаться: агент теперь может вызывать инструменты
ZALORA.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
zalora_list_orders | Список заказов, самые старые в начале, если не отсортированы: id (числовой, используется всеми другими инструментами заказов), number (номер заказа, который видит клиент) и статус… |
zalora_get_order | Чтение одного заказа: number, статус, даты, адреса клиента и доставки, способ оплаты, итоги и валюта, а также его позиции (id… |
zalora_get_order_counters | Приблизительное количество заказов по состояниям (ожидающие, готовые к отправке, отправленные, доставленные, отмененные и так далее), а также возвратов по запросу.… |
zalora_list_order_items | Список позиций заказов по заказам: id, orderId, статус, shopSku, sellerSku, имя, цена за единицу, оплаченная цена, поставщик доставки и код отслеживания… |
zalora_get_order_history | История статусов позиций одного заказа: orderItemId, shopSku, статус, примечание, createdAt и кто внес изменения. Только для чтения |
zalora_get_order_item_returns | Подробности возвратов позиций заказов: возвратный пакет, причина, комментарий и поставщик возврата. Только для чтения |
zalora_list_shipment_providers | Поставщики доставки, с которыми продавец может отправлять: id, имя, по умолчанию, apiIntegrationAvailable (true: номер отслеживания может быть опущен)… |
zalora_list_failure_reasons | Причины, принимаемые при отмене позиции или пометке доставки как неудачной: id, тип, имя, описание и outOfStock. Только для чтения |
zalora_print_document | Генерация документа заказа в формате base64 PDF: этикетка для отправки, счет-фактура, список для сборки, контрольный список, манифест перевозчика и другие, в зависимости от заказа… |
zalora_list_products | Список продуктов (вариации): id, uuid, shopSku, sellerSku, productSetId, статус и вариация, упорядоченные по id, с pagination (limit… |
zalora_list_product_sets | Список наборов продуктов (элемент каталога, который группирует размеры или цвета): id, имя, родительский SKU, бренд, категория, статус и контроль качества… |
zalora_list_product_set_products | Продукты (вариации) одного набора продуктов: id (идентификатор продукта, используемый для запасов и цен), sellerSku, shopSku, вариация, статус… |
zalora_get_product_stock | Запасы одного продукта (вариация): количество (продаваемое на твоем складе), зарезервированные запасы, доступно, консигнация на ZALORA, когда… |
zalora_get_product_set_stock | Запасы каждого продукта (вариация) одного набора продуктов: shopSku, sellerSku, количество, зарезервированные запасы, доступно, консигнации и склады.… |
zalora_get_product_set_prices | Цены каждого продукта одного набора продуктов по странам: цена, цена со скидкой, дата начала распродажи, дата окончания распродажи и статус, для стран, где… |
zalora_list_brands | Бренды: id, uuid, имя, isRestricted и isAccessible (можешь ли ты его продавать), с pagination (totalCount). Только для чтения |
zalora_get_category_tree | Дерево категорий: id, parentId, имя, attributeSetId, путь и дочерние элементы. Большой ответ: получи его один раз и сохрани идентификаторы. Только для чтения |
zalora_get_category_attributes | Атрибуты одной категории: id, имя, метка, isMandatory, inputType, attributeType и допустимые опции. Только для чтения |
zalora_get_seller | Учетная запись продавца за учетными данными: id, имя, короткий код, статус, причины удаления из списка (режим праздников, лимиты заказов) и контактные данные.… |
zalora_set_ready_to_ship | Упаковать ожидающие позиции одного заказа в пакет и установить их как готовые к отправке с номером отслеживания и поставщиком доставки. Каждый… |
zalora_set_packed_by_marketplace | Пометить ожидающие позиции как упакованные, чтобы ZALORA организовала отправку (логистика рынка). Каждая позиция должна быть из одного заказа. Ответы… |
zalora_set_shipped | Установить готовые к отправке позиции одного заказа как отправленные (только дропшиппинг; невозможно для кросс-докинга или когда требуются манифесты). Ответы… |
zalora_set_delivered | Установить отправленные позиции одного заказа как доставленные (только дропшиппинг). Ответы на идентификаторы позиций заказа изменились |
zalora_update_tracking_code | Изменить номер отслеживания готовой к отправке позиции; это применяется ко всем позициям в одном пакете. Отправь пустую строку, чтобы позволить ZALORA… |
zalora_update_shipping_provider | Изменить поставщика доставки (и, возможно, номер отслеживания) готовой к отправке позиции; это применяется ко всем позициям в одном пакете |
zalora_update_stock | Установить количество запасов до 100 продуктов (вариаций) за один вызов, как абсолютные числа. Невозможно для продуктов, выполненных ZALORA.… |
zalora_update_price | Изменить цену одного продукта (вариации) в одной стране. Только поля, которые ты отправляешь, изменяются: цена (розничная цена), цена со скидкой с… |
zalora_set_price_status | Переключить строку цены одного продукта в одной стране на активную или неактивную. Неактивный убирает продукт с продажи в этой стране |
zalora_cancel_order_items | Отменить позиции одного заказа с причиной из zalora_list_failure_reasons. Не может быть отменено; клиенту возвращаются деньги, и отмена… |
zalora_set_delivery_failed | Пометить позиции одного заказа как неудавшуюся доставку с причиной из zalora_list_failure_reasons (только дропшиппинг) |
zalora_approve_return | Одобрить возврат позиций, ожидающих одобрения (только там, где продавец обрабатывает возвраты). Одобрение приводит к возврату средств клиенту |
Примеры подсказок
- "Какие заказы ZALORA ожидают и должны быть упакованы сегодня?"
- "Установить позицию заказа 81234567 как готовую к отправке и получить этикетку для отправки."
- "Какие наборы продуктов имеют менее 5 единиц на складе?"
- "Установить цену SKU ZL-DRESS-NVY-M на 59.90 SGD."
- "Показать возвраты заказа 260112345 и их причины."
Часто задаваемые вопросы
Откуда берутся учетные данные? ZALORA Seller Center, Настройки, Управление интеграцией, OAuth Приложения: создай приложение как пользователь с полным доступом продавца и скопируй его Application ID и секрет. Также выбери свою страну Seller Center.
Какие страны охватывает это? Сингапур, Малайзия, Индонезия, Филиппины и Гонконг. У каждой страны есть свой Seller Center, поэтому устанавливай один коннектор на страну.
Какие инструменты установлены выключенными? zalora_cancel_order_items, zalora_set_delivery_failed, zalora_approve_return и zalora_set_price_status. Включай их на странице коннектора только если ИИ должен их использовать.
Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.
Следующие шаги
Это руководство помогло?