Walmart Marketplace MCP: заказы и остатки

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

Walmart Marketplace

Walmart Marketplace API для продавцов США: заказы с подтверждением и отправкой с отслеживанием, возвраты, поиск товаров и каталога, запасы, цены, массовые загрузки, отчеты по запросу, входящие отправления WFS и настройки доставки. Идентификатор клиента и секрет.

Настройка

Настройка занимает около 5 минут.

1. Войди на https://developer.walmart.com с помощью своего логина Seller Center (выбери продавца Marketplace).
2. Открой Мой аккаунт, затем API ключи (управление ключами) и создай или скопируй идентификатор клиента и секрет клиента для производственной среды.
3. Вставь идентификатор клиента в WALMART_CLIENT_ID и секрет клиента в WALMART_CLIENT_SECRET.

Коннектор обменивает их на POST /v3/token (HTTP Basic, учетные данные клиента) для получения токена доступа, который действует 15 минут, повторно использует его до истечения срока действия и самостоятельно получает новый. Каждый вызов содержит WM_SEC.ACCESS_TOKEN, WM_SVC.NAME и новый WM_QOS.CORRELATION_ID. Используй свои собственные учетные данные продавца: ключи делегированного доступа для поставщиков решений прекращаются (новые больше не могут быть созданы, существующие перестанут работать после 30 апреля 2027 года).

С чего начать: walmart_marketplace_list_released_orders (заказы, ожидающие тебя), затем walmart_marketplace_get_order. walmart_marketplace_list_items перечисляет твой каталог, а walmart_marketplace_get_inventory — запасы SKU.

Заказы: walmart_marketplace_list_orders (все статусы), walmart_marketplace_list_released_orders (строки в статусе Создано), walmart_marketplace_get_order. Строка переходит в статус Создано, Подтверждено, Отправлено, Доставлено или Отменено. Подтверждай новые заказы оперативно с помощью walmart_marketplace_acknowledge_order, затем отправляй каждую строку с помощью walmart_marketplace_ship_order_line (перевозчик, метод, номер отслеживания, время отправки в миллисекундах эпохи); отправка фиксирует оплату клиента. walmart_marketplace_cancel_order_line и walmart_marketplace_refund_order_lines установлены в выключенном состоянии: отмена влияет на метрики продавца, а возврат перемещает деньги. Списки заказов охватывают 180 дней назад, максимум 10,000 заказов и по умолчанию охватывают последние 7 дней.

Пагинация: заказы и возвраты отвечают с meta.nextCursor, готовой строкой запроса, начинающейся с ?. Передай ее без изменений как next_cursor и оставь другие фильтры. Товары используют nextCursor (начинается с *, действителен 2 минуты) или лимит и смещение.

Возвраты: walmart_marketplace_list_returns (статусы INITIATED, DELIVERED, COMPLETED). walmart_marketplace_refund_return выключен, потому что он возвращает деньги клиенту.

Товары и каталог: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (твой каталог с фильтрами, такими как НЕНАПЕЧАТАННЫЕ товары) и walmart_marketplace_search_walmart_catalog (публичный каталог Walmart.com по ключевому слову, UPC или GTIN). walmart_marketplace_retire_item выключен: снятие с продажи удаляет листинг.

Запасы и цены: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (абсолютное количество, единица EACH), walmart_marketplace_get_wfs_inventory (запасы, хранящиеся WFS). walmart_marketplace_update_price устанавливает БАЗОВУЮ цену одного SKU в USD (100 вызовов в час); walmart_marketplace_get_promotional_prices показывает цены распродаж.

Загрузки: массовые изменения проходят через загрузки. walmart_marketplace_submit_item_feed и walmart_marketplace_submit_price_feed установлены в выключенном состоянии, потому что одна загрузка изменяет много активных листингов, а массовые загрузки цен ограничены по количеству в час и в день (10 в час, общие для всех загрузок цен и акций). Проверь результаты с помощью walmart_marketplace_list_feeds и walmart_marketplace_get_feed_status (ошибки по элементам с include_details).

Отчеты: walmart_marketplace_request_report, затем walmart_marketplace_list_report_requests или walmart_marketplace_get_report_request до READY, затем walmart_marketplace_get_report_download_url. Статус и вызовы загрузки ограничены 20 в час каждый, поэтому подожди несколько минут между проверками. Ссылка — это краткосрочная сжатая CSV.

WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (этикетки получения в формате PDF или ZPL, бесплатно).

Настройки (только для чтения): walmart_marketplace_list_ship_nodes (идентификаторы узлов доставки), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 вызовов в час).

Ограничения по скорости: у каждого API есть свой собственный токен (все заказы 5,000 в минуту, выпущенные заказы 60 в минуту, отправка, подтверждение и отмена 60 в минуту, запасы 200 в минуту, товары 300 в минуту). Код 429 означает, что ведро пусто; заголовки x-current-token-count и X-Next-Replenishment-Time сообщают, когда можно повторить попытку.

Форматы: даты в формате ISO 8601 в UTC; даты заказов в ответах — в миллисекундах эпохи. Деньги в USD. SKU — это твои собственные SKU продавца; идентификаторы Walmart — это purchaseOrderId (заказы), returnOrderId (возвраты), wpid и itemId (каталог). Ошибки возвращаются как errors.error[] с кодом, полем и описанием; код 400 INVALID_REQUEST_HEADER обычно означает проблему с токеном или заголовком.

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

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

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

• "Какие выпущенные заказы Walmart еще нужно отправить сегодня?"
• "Покажи заказ на покупку 1234567890123 с адресом доставки клиента и строками."
• "Какие SKU имеют менее 5 единиц на складе на моих узлах доставки?"
• "Установи цену SKU WM-1001 на 24.99 USD."
• "Подтверди все выпущенные заказы с сегодняшнего дня и перечисли те, для которых еще нет отслеживания."

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

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