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

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

Продавец AliExpress

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

Настройка

Что тебе нужно: учетная запись продавца AliExpress, учетная запись разработчика на открытой платформе AliExpress и собственное приложение в категории Seller-inhouse Developer. AliExpress проверяет профиль разработчика и должен одобрить эту категорию приложения, прежде чем приложение может быть создано: никто, кроме AliExpress, не может ускорить этот процесс, и он может быть отклонен. В китайском FAQ указано 2-5 рабочих дней на проверку разработчика; время для категории не указано.

1. На https://openservice.aliexpress.com нажми Создать учетную запись (или войди в систему). Затем заполни свой профиль под своим идентификатором пользователя, Профиль: выбери тип разработчика, заполни поля и загрузите документы, которые запрашивает AliExpress. AliExpress проверяет профиль.
2. Открой Консоль приложений и нажми Создать. В списке категорий приложений нажми Подать заявку на Seller-inhouse Developer (для продавца AliExpress, который создает приложение для собственного использования), напиши, зачем оно тебе в поле Причина и нажми ОК. Категория будет отображаться как Ожидание до тех пор, пока AliExpress не одобрит её, затем Активно. Можно создать только одно приложение на категорию.
3. На одобренной категории нажми Создать приложение. Введи имя приложения и в качестве URL обратного вызова укажи адрес этого сервера, за которым следует /api/iop-auth/callback (на AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), затем нажми Отправить.
4. Нажми Обзор приложения, затем Управление на своём приложении. Скопируй Ключ приложения в ALIEXPRESS_SELLER_APP_KEY. В разделе Основная информация нажми Просмотреть и скопируй Секрет приложения в ALIEXPRESS_SELLER_APP_SECRET.
5. На той же странице посмотри на Группу разрешений API: группа, помеченная как Неактивна, должна быть запрошена с помощью Подать заявку и причины, прежде чем её API ответят.
6. В разделе Консоль приложений, Управление приложениями, Управление авторизацией введи учетную запись продавца своего магазина в белый список авторизации продавца и отправь. Самостоятельно разработанное приложение может связываться с максимум 50 магазинами, и только с магазинами, которые юридически связаны с разработчиком: одна и та же компания, материнская и дочерняя, одна и та же материнская компания или один и тот же юридический представитель или мажоритарный акционер.
7. На странице соединителя нажми Authorize. AliExpress покажет свою страницу входа: выбери страну, введи учетную запись продавца и пароль магазина и нажми Войти и авторизовать. Ты вернешься в AnythingMCP самостоятельно.

Срок действия токена: AnythingMCP хранит токен доступа и токен обновления в зашифрованном виде, считывает, как долго они действуют, из ответа AliExpress (expires_in и refresh_expires_in, в секундах) и самостоятельно обновляет токен доступа. Обновление приносит новый токен обновления, но не изменяет дату окончания токена обновления. Когда эта дата достигается (или AliExpress отвечает refresh_expires_in 0), нажми Authorize снова. Страница Управление авторизацией показывает сроки действия твоего приложения; китайское руководство AliExpress указывает 365 дней для токена доступа и 730 дней для токена обновления для самостоятельно разработанного приложения продавца.

Как это подписывается: каждый вызов идет на /sync с именем API в method, плюс app_key, access_token, миллисекундный timestamp, sign_method=sha256 и sign, верхний регистр HMAC-SHA256 всех параметров, отсортированных по имени, с ключом App Secret. Секрет никогда не покидает AnythingMCP.

С чего начать

• Магазин: aliexpress_seller_get_seller_profile (идентификатор продавца, страна, валюта котировки, количество продуктов) и aliexpress_seller_get_shop_info (идентификатор магазина, имя и URL).
• Заказы: aliexpress_seller_list_orders с order_status WAIT_SELLER_SEND_GOODS перечисляет то, что должно быть отправлено; aliexpress_seller_get_order дает суммы, подзаказы и отслеживание; aliexpress_seller_get_order_receipt_info — адрес доставки.
• Отгрузка с твоим собственным перевозчиком: aliexpress_seller_list_order_shipping_services указывает по подзаказу, отправляется ли он с твоим собственным перевозчиком (DBS) или с логистикой платформы; aliexpress_seller_list_shipment_providers дает коды провайдеров; aliexpress_seller_declare_shipment отправляет перевозчика и номер отслеживания в AliExpress и ничего не стоит; aliexpress_seller_modify_shipment исправляет это (максимум дважды, в течение десяти дней). aliexpress_seller_list_packages показывает пакеты и их статус.
• Логистика платформы (отключена при установке, потому что они заказывают логистическую услугу для магазина): aliexpress_seller_list_seller_addresses для адреса забора, aliexpress_seller_pack_order для создания пакета, aliexpress_seller_ship_platform_package для передачи, aliexpress_seller_cancel_package для отмены пакета. Печать накладной не включена: AliExpress возвращает её как файл внутри ответа, распечатай её из центра продавца.
• Продукты: aliexpress_seller_list_products по статусу, aliexpress_seller_get_product с каждым SKU, aliexpress_seller_update_prices и aliexpress_seller_update_stock по sku_code, aliexpress_seller_set_products_online, и aliexpress_seller_set_products_offline (отключено). Публикация, редактирование и удаление продуктов не включены.
• Настройки каталога: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories и aliexpress_seller_list_freight_templates.
• Споры: aliexpress_seller_list_disputes и aliexpress_seller_get_dispute — это чтения. aliexpress_seller_accept_dispute_solution отключено: принятие предложения является обязательным и может вернуть деньги покупателю.
• Деньги: aliexpress_seller_list_settlement_bills перечисляет отчеты о расчетах. Соединитель никогда не платит, не возвращает деньги и не выводит средства самостоятельно.

Идентификаторы и форматы

• Идентификаторы заказа, подзаказа, продукта и спора — это длинные числа: передавай их как текст, только цифры. Идентификатор подзаказа (child_id в списке заказов, id в child_order_list заказа) — это то, что инструменты доставки называют tradeOrderItemId.
• Времена заказов указаны в Тихоокеанском времени США, записываются как yyyy-MM-dd HH:mm:ss. Фильтры пакетов и споров принимают Unix-время в миллисекундах. Периоды расчетов записываются как YYYY/MM/dd, их даты выпуска — в Unix миллисекундах.
• Суммы — это объекты с amount (десятичная строка) и currency_code; цены, которые ты отправляешь, — это десятичные строки в валюте продукта.
• Списки начинаются с 1: заказы и споры до 50 на странице, пакеты до 50, продукты менее 100. Обновления цен и запасов принимают максимум 20 продуктов с 200 SKU каждый.
• order_status FINISH охватывает завершенные и закрытые заказы, и возвращается только по запросу. endReason в extend_map его подзаказов различает их.

Ответы и ошибки: результаты находятся под aliexpress_..._response (имя API с подчеркиваниями). Многие вызовы отвечают 200 и содержат свой собственный вердикт внутри: result.success с errorCode и errorMessage (или error_code и error_message), update_success с update_failed_list для обновлений цен и запасов. Всегда читай это перед тем, как сообщить пользователю, что запись прошла успешно. Отказы шлюза приходят как error_response с code: IllegalAccessToken, когда авторизация закончилась (AnythingMCP обновляет токен один раз и повторяет попытку), InvalidAppkey или IncompleteSignature, когда ключ и секрет не совпадают, InsufficientPermission, когда приложению не хватает группы разрешений API, и код ограничения вызовов, когда квота категории приложения исчерпана.

Предварительные требования: ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_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, выбери AliExpress Seller и вставь переменные окружения, указанные в предварительных требованиях.

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

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

• "Какие заказы AliExpress ждут, чтобы я их отправил?"
• "Заявить отгрузку заказа 8187654321098765 с отслеживанием Cainiao LP00123456789012."
• "Какие споры открыты, и что запрашивают покупатели?"
• "Установить запас SKU AE-CASE-14-BLK на 300 и цену на 4.99 USD."
• "Показать отчеты о расчетах за прошлый месяц."

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

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