SHEIN Seller MCP: подключить к Gemini CLI

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

Продавец SHEIN + Gemini

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

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

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

SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

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

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

1. Зарегистрируйся на https://open.sheincorp.com, выбери тип разработчика Продавец самостоятелен и предоставь запрашиваемую информацию о продавце (вся она находится в бэкенде продавца). Тип изменить нельзя после одобрения.
2. В консоли открой Управление приложениями и создай приложение. Выбери тип приложения для режима сотрудничества магазина: Самоуправляемый или Полууправляемый для магазина на рынке (магазин в нескольких режимах требует одно приложение на режим). Имя, иконка и описание отображаются продавцам и не могут быть изменены после отправки. 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).

Шаг 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 теперь может вызывать инструменты Продавец SHEIN.

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

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

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

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

Я вставляю ключ магазина или токен? Нет. Ты вставляешь App ID и App Secret своего одобренного приложения SHEIN и нажимаешь Authorize with Provider. Страница SHEIN запрашивает одобрение основного аккаунта магазина, и коннектор сам получает и хранит ключ магазина. Когда авторизация заканчивается, нажми Authorize with Provider снова.

Для каких магазинов это работает? Заказы, отслеживание, обновления запасов и возвраты предназначены для самоуправляемых и полууправляемых магазинов; цены могут устанавливать только самоуправляемые магазины. Продукты, категории, бренды, сайты и чтение запасов также работают для полностью управляемых магазинов. Выбери адрес API своего типа приложения: openapi.sheincorp.com для самоуправляемых и полууправляемых, openapi.sheincorp.cn для полностью управляемых. SHEIN принимает вызовы только с адресов в белом списке приложения; на AnythingMCP Cloud страница настройки показывает адрес для добавления.

Какие инструменты установлены отключенными? shein_confirm_out_of_stock, который отменяет строку заказа, shein_set_skc_shelf_status, который убирает продукты с полки, и shein_sign_return_order, который подтверждает возврат. Ничто в коннекторе не перемещает деньги, не бронирует оплаченные логистические услуги и не принимает решения по случаям после продаж.

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

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

• Страница приземления коннектора
• Подключиться к Claude