Кратко
API Wish Marketplace v3 для продавцов: заказы и выполнение с отслеживанием, продукты и вариации с ценами и запасами на складе, категории и атрибуты, тикеты службы поддержки, оценки, штрафы, склады и настройки доставки. OAuth токен доступа из частного приложения.
Пошаговая настройка
Подключи Wish к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Wish в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Wish
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Wish, вставь свои учетные данные, создай ключ API MCP, и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Wish + Meta Muse
API Wish Marketplace v3 для продавцов: заказы и выполнение с отслеживанием, продукты и вариации с ценами и запасами на складе, категории и атрибуты, тикеты службы поддержки, оценки, штрафы, склады и настройки доставки. OAuth токен доступа из частного приложения.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
WISH_ACCESS_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 10 минут.
- В панели управления продавца Wish (https://merchant.wish.com) открой меню Учетная запись, API Настройки, и нажми Зарегистрировать частное приложение. Введи имя и URI перенаправления HTTPS, который ты контролируешь (подойдет любая страница, код должен только появиться в адресе). Wish разрешает одно частное приложение на продавца.
- Открой
https://merchant.wish.com/v3/oauth/authorize?client_id=с последующим идентификатором клиента приложения, войди в систему и одобри. Wish перенаправляет на твой URI перенаправления с?code=в адресе; код действителен в течение 5 минут и работает один раз. - Обменивай код: открой
https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=...с твоими значениями. Скопируйdata.access_tokenвWISH_ACCESS_TOKENи храниdata.refresh_tokenв безопасности.
Срок действия токена: токены доступа Wish истекают через 30 дней. До этого открой https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... и вставь новый токен доступа в коннектор (старый аннулируется). Wish обновляет токены только с помощью GET-запросов, которые автоматическое обновление OAuth коннектора не отправляет, поэтому обновление сейчас выполняется вручную.
С чего начать: wish_test_token проверяет токен и показывает его области. wish_list_orders со статусами APPROVED перечисляет заказы на отправку; wish_list_products перечисляет каталог; wish_list_warehouses дает идентификаторы складов, которые нужны для инвентаризации.
Заказы: wish_list_orders, wish_get_order. Отправка с помощью wish_fulfill_order (перевозчик из wish_list_shipping_carriers, номер отслеживания, страна происхождения); тот же вызов корректирует отслеживание позже. Доставка и возвраты асинхронны: прочитай заказ снова для получения результата. wish_list_refund_reasons показывает допустимые причины; wish_refund_order возвращает деньги клиенту и установлен выключенным.
Продукты: wish_list_products, wish_get_product, wish_create_product, wish_update_product (цена, инвентаризация на складе, статус вариаций по идентификатору вариации), wish_create_variation. Категории: wish_get_categories, wish_get_category, wish_get_category_attributes. wish_delete_product установлен выключенным; отключай вариации вместо этого. wish_get_product_rating считывает рейтинг.
Тикеты клиентов: wish_list_tickets (состояние AWAITING_MERCHANT требует ответа), wish_get_ticket, wish_reply_to_ticket, wish_update_ticket (закрыть, повторно открыть, апелляция).
Учетная запись: wish_get_account_details, wish_list_penalties, wish_get_shipping_settings, wish_list_warehouses.
Пагинация: списки возвращают до limit элементов, отсортированных по времени; для следующей страницы снова вызови с updated_at_max (или created_at_max), установленным на время последнего элемента. Каждый ответ имеет форму code, message, data; code 0 означает успех.
Идентификаторы и форматы: идентификаторы заказа, продукта, вариации, тикета и склада — это 24-символьные шестнадцатеричные строки. Времена — ISO 8601 (2026-11-01T00:00:00Z). Цены — это объекты с amount и currency_code. Области токена определяют, что работает: отсутствующая область отвечает 403.
Лимиты запросов: на продавца и приложение; заголовок Wish-Rate-Limit-Remaining показывает, что осталось, а 429 содержит Wish-Rate-Limit-Reset. Указывай заголовок Wish-Request-Id, когда обращаешься в Wish по поводу вызова.
Шаг 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 — Добавь коннектор в Muse
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси Muse о том, для чего нужны инструменты
Wish.
Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
wish_test_token | Проверь, что токен доступа работает: возвращает идентификатор продавца и области токена |
wish_get_account_details | Учетная запись продавца: идентификатор, отображаемое имя, контакт, страна, статус и другие детали учетной записи |
wish_list_orders | Список заказов, по умолчанию сначала обновленные: идентификатор, состояние (APPROVED для отправки, SHIPPED, REFUNDED, REQUIRE_REVIEW), тип заказа, продукт… |
wish_get_order | Один заказ по идентификатору: состояние, продукт и вариация, количество, цены и выплаты, адрес доставки, требования к выполнению и срок… |
wish_list_shipping_carriers | Принятые перевозчики: все перевозчики (GENERAL) или те, которые приняты для политики Подтвержденной Доставки в страну назначения… |
wish_fulfill_order | Отметить заказ как отправленный или обновить его отслеживание: перевозчик, номер отслеживания и страна происхождения. Асинхронно; прочитай заказ снова, чтобы увидеть… |
wish_list_refund_reasons | Причины возврата, действительные для одного заказа прямо сейчас (они меняются в течение жизни заказа). Читай их непосредственно перед возвратом |
wish_refund_order | Вернуть или отменить заказ с причиной из wish_list_refund_reasons. Клиент получает деньги обратно, и это нельзя отменить; возвраты… |
wish_list_products | Список продуктов, по умолчанию сначала обновленные: идентификатор, parent_sku, имя, состояние, категория, изображения, вариации (идентификатор, sku, цена, инвентаризация… |
wish_get_product | Один продукт по идентификатору с его вариациями, ценами, инвентаризацией на складе, изображениями, атрибутами, состоянием доставки и отзывов |
wish_create_product | Создать продукт с как минимум одной вариацией. Нужны имя, описание (обычный текст, до 4,000 символов), parent SKU, категория, основное… |
wish_update_product | Обновить продукт: имя, описание, теги, категория, изображения, стандартные цены доставки, статус или его существующие вариации (по идентификатору вариации… |
wish_delete_product | Удалить листинг продукта. Это нельзя отменить. Установлен выключенным; отключай вариации с помощью wish_update_product вместо этого |
wish_create_variation | Добавить вариацию к существующему продукту: sku, цена, инвентаризация на складе, значения опций и изображение |
wish_get_categories | Корень дерева категорий Wish с его дочерними категориями (идентификатор, имя, is_leaf). Спускайся с помощью wish_get_category к листу для category_id |
wish_get_category | Одна категория по идентификатору с ее дочерними категориями; листовые категории могут использоваться как category_id |
wish_get_category_attributes | Атрибуты категории (имя, обязательные, допустимые значения) для заполнения атрибутов и опций при создании продуктов |
wish_get_product_rating | Общий рейтинг продукта: средний рейтинг и количество оценок |
wish_list_tickets | Тикеты службы поддержки клиентов, по умолчанию сначала обновленные: идентификатор, тип (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), состояние (AWAITING_MERCHANT… |
wish_get_ticket | Один тикет поддержки с его сообщениями, связанным заказом и состоянием |
wish_reply_to_ticket | Ответить на тикет в состоянии AWAITING_MERCHANT (до 2,000 символов, разрешен Markdown). Wish обновляет состояние после ответа |
wish_update_ticket | Закрыть тикет (CLOSED), повторно открыть закрытый (AWAITING_MERCHANT, когда разрешено) или подать апелляцию в поддержку Wish (AWAITING_WISH) |
wish_list_penalties | Штрафы на учетной записи, сначала новые: идентификатор, тип, сумма и валюта, причина, заказ или продукт, время создания и отмены. До 500 на… |
wish_get_shipping_settings | Настройки доставки продавца по странам назначения, в которые Wish отправляет: включенные страны, цены на доставку и регионы |
wish_list_warehouses | Склады продавца: идентификатор, имя, тип (стандартный склад первым), адрес. Идентификаторы складов нужны для инвентаризации и цен на доставку |
Примеры подсказок
- "Какие заказы Wish нужно выполнить сегодня?"
- "Выполни заказ 64a1b2c3d4e5 с отслеживанием USPS 9400111899223197428490."
- "Какие тикеты поддержки ждут моего ответа?"
- "Есть ли новые штрафы на моей учетной записи в этом месяце?"
- "Какой рейтинг у продукта 5f9e8d7c6b5a?"
Часто задаваемые вопросы
Токен обновляется сам? Нет. Токены доступа Wish истекают через 30 дней, и Wish обновляет их только с помощью запроса, который автоматическое обновление коннектора не отправляет. Обнови токен с помощью своего токена обновления перед его истечением и вставь новый.
Откуда берется токен? Из частного приложения, которое ты регистрируешь в панели управления продавца Wish в разделе API Настройки: авторизуй его, обменяй код на токен доступа и вставь токен.
Какие инструменты установлены выключенными? wish_refund_order и wish_delete_product. Включай их на странице коннектора только если ИИ должен их использовать.
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?