SHEIN Seller MCP-сервер: заказы и остатки

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SHEIN Seller, вставь App ID и App Secret, нажми Authorize with Provider и одобри с основного аккаунта магазина на SHEIN, создай ключ API MCP и готово. Никакого Docker, никакого git clone, никакого локального сервера.

SHEIN Seller

Позволь своему ИИ работать с твоим магазином на SHEIN: заказы, адрес покупателя и загрузка отслеживания, отслеживание посылок, продукты с ценами и запасами, обновления запасов и цен, категории и атрибуты, послепродажные случаи и возвраты.

Настройка

Что тебе нужно: аккаунт разработчика на SHEIN Open Platform типа Seller Self-Developed (проверенный с информацией о продавце магазина), одобренное приложение для режима сотрудничества магазина и основной аккаунт магазина для его одобрения. Примерно 20 минут работы, плюс проверки аккаунта и приложения от SHEIN.

1. Зарегистрируйся на https://open.sheincorp.com, выбери тип разработчика Seller Self-Developed и предоставь запрашиваемую информацию о продавце (вся она находится в бэкенде продавца). Тип изменить нельзя после одобрения.
2. В консоли открой Управление приложениями и создай приложение. Выбери тип приложения для режима сотрудничества магазина: Self-Operated или Semi-Managed для магазина на маркетплейсе (магазин в нескольких режимах требует одно приложение на режим). Имя, иконка и описание отображаются продавцам и не могут быть изменены после отправки. SHEIN проверяет приложение; до его одобрения нет действительного App ID или App Secret.
3. На странице деталей приложения проверь Пакет разрешений API: API для заказов, продуктов, запасов, послепродажных случаев и возвратов должны быть подписаны (обычно предоставляются с одобрением; в противном случае нажми Подать заявку на пакет разрешений). Добавь исходящий IP-адрес этого сервера в IP белый список приложения: SHEIN отказывает в производственных вызовах с любого другого адреса (openapi00002). На странице настройки AnythingMCP Cloud отображается адрес.
4. Скопируй App ID в SHEIN_APP_ID и App Secret в SHEIN_APP_SECRET, и выбери адрес API для SHEIN_API_HOST: https://openapi.sheincorp.com для самообслуживаемых и полуподдерживаемых приложений, https://openapi.sheincorp.cn для полностью управляемых, SHEIN-управляемых и других приложений.
5. Установи коннектор и нажми Authorize with Provider (последний шаг руководства по настройке делает это). Откроется страница SHEIN: войди в бэкенд продавца с основного аккаунта магазина и нажми кнопку авторизации. SHEIN отправляет браузер обратно на <SERVER_URL>/api/shein-auth/callback (на AnythingMCP Cloud: https://cloud.anythingmcp.com/api/shein-auth/callback) и коннектор получает ключ магазина в течение 10 минут, которые разрешает SHEIN.

Ключ магазина: SHEIN передает openKeyId и secretKey магазина (secretKey зашифрован с App Secret, который AnythingMCP расшифровывает один раз); оба хранятся в зашифрованном виде на коннекторе. SHEIN не документирует срок действия и обновление для них. Авторизация заканчивается, когда продавец отвязывает приложение или сбрасывает ключ, магазин закрывается, SHEIN сбрасывает или отвязывает его, или он истекает: вызовы тогда завершаются с openapi00004 ("Срок действия пользователя истек"), коннектор показывает, что требуется новая авторизация, и кто-то снова нажимает Authorize with Provider.

Как это подписывается: каждый вызов содержит x-lt-openKeyId, x-lt-timestamp (Unix миллисекунды) и x-lt-signature: пять случайных символов, за которыми следует Base64 нижнего регистра hex HMAC-SHA256 от openKeyId&timestamp&path, ключом с secretKey плюс эти пять символов. Запрос не подписывается. Временная метка действительна в течение 5 минут, поэтому часы сервера должны быть правильными.

С чего начать: shein_get_store_info проверяет авторизацию и называет магазин; shein_list_sites дает коды сайтов и валюты.

• Заказы: shein_list_orders (окно максимум 48 часов обязательно), затем shein_get_orders для до 30 одновременно. Только заказы с stockMode 3 отправляются продавцом; printOrderStatus 1 означает, что заказ можно обработать сейчас.
• Отправка самостоятельно: shein_get_order_address (handle_type 2 также перемещает заказ на отправку), shein_list_warehouse_addresses, shein_list_shipping_channels, затем shein_upload_tracking_numbers поштучно (goodsId). shein_get_logistics_track отслеживает посылку. SHEIN помечает заказ как отправленный, когда перевозчик сканирует его. shein_confirm_out_of_stock отключен при установке.
• Продукты: shein_search_products (коды, статус на полке, цены, запасы и блокировки кампаний), shein_list_products (все коды), shein_get_product (один SPU полностью). Для новых списков: shein_get_category_tree, shein_get_attribute_templates, shein_list_brands. shein_set_skc_shelf_status отключен при установке.
• Запасы и цены: shein_list_warehouses, shein_get_stock, shein_update_stock (с ключом идемпотентности на строку), shein_update_prices (повышения могут ждать проверки цены от SHEIN). shein_get_sku_sales дает проданные единицы для управляемых магазинов.
• Послепродажные случаи: shein_list_after_sales_orders и shein_get_after_sales_orders, shein_list_return_orders и shein_get_return_orders только для чтения; shein_sign_return_order отключен при установке.

Коды, времена и суммы: коды SPU, SKC и SKU (spuName, skcName, skuCode) принадлежат SHEIN; supplierCode и supplierSku — это собственные коды продавца. SKU, проданные несколько раз, имеют один goodsId на каждую единицу, и номера отслеживания, отмены и квитанции о возврате работают по goodsId. Значения goodsId — это 64-битные числа: коннектор читает каждый id, слишком длинный для числа JavaScript, как текст с его точными цифрами, а инструменты принимают id как текст и отправляют их в SHEIN как числа, поэтому копируй их точно так, как они показываются в заказе или возврате. Окна заказов, послепродажных случаев и возвратов — по пекинскому времени (UTC+8) в формате yyyy-MM-dd HH:mm:ss; детали заказа отвечают в формате yyyy-MM-dd'T'HH:mm:ss.SSSZ, события отслеживания с Unix миллисекундами. Суммы — это десятичные числа в валюте, указанной рядом с ними (orderCurrency, currency, currencyCode).

Ограничения: у каждого API есть свой лимит вызовов в секунду на приложение (20 для поиска продуктов, 30 до 300 для остальных), ответ с openapi00006 или 832213 при превышении. Списки заказов и возвратов разбиваются на страницы по 30, поиск продуктов — по 10; окно заказа возвращает максимум 10,000 заказов, список продуктов — максимум 50,000 кодов. Один и тот же SKC и сайт могут менять статус на полке один раз каждые 20 минут.

Ответы и ошибки: SHEIN отвечает с code "0" и результатом в info; любой другой code — это ошибка с msg и traceId, который нужно указать в поддержке SHEIN в течение трех дней. Коннектор запрашивает сообщения на английском (language: en). openapi00001: подпись была отклонена; при правильных часах сервера это означает, что ключ магазина изменился (переавторизован или сброшен в другом месте), поэтому авторизуй снова. openapi00002: IP-адрес этого сервера не находится в белом списке приложения. openapi00003: у приложения нет разрешения на этот API, API не предназначен для режима магазина или аккаунт разработчика отключен. openapi00004: авторизация завершена; авторизуй снова. Записывай вызовы, которые принимают список, отвечают code 0 и указывают отклоненные строки (failedList, failure_results или info).

Предварительные требования: SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

Установка коннектора локально

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

Открой http://localhost:3000/connectors/store, выбери SHEIN Seller и вставь переменные окружения, указанные в предварительных требованиях.

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

Примеры запросов

• "Какие заказы SHEIN за последние 24 часа я могу обработать сейчас?"
• "Загрузить номер отслеживания UPS 1Z999AA10123456784 для обеих единиц заказа GSH12345678901."
• "Какие из моих SKU имеют менее 10 единиц на складе?"
• "Установить запас SKU кода I8xk2m4p0q в моем основном складе на 60."
• "Какие возвраты заказов и послепродажные случаи пришли на этой неделе, и что говорят покупатели?"

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

• Подключиться к Claude
• Подключиться к ChatGPT