Кратко
API продавца Whatnot для продавцов на рынке живых покупок: заказы, позиции заказов, отгрузки и коды отслеживания, продукты и варианты, инвентарь, мерчандайзинг для покупки сейчас, аукционы и шоу, аналитика шоу и отчеты. Личный токен доступа.
Пошаговая настройка
Подключи Whatnot к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Whatnot в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Whatnot
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Whatnot, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Whatnot + Meta Muse
API продавца Whatnot для продавцов на рынке живых покупок: заказы, позиции заказов, отгрузки и коды отслеживания, продукты и варианты, инвентарь, мерчандайзинг для покупки сейчас, аукционы и шоу, аналитика шоу и отчеты. Личный токен доступа.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
WHATNOT_API_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 2 минут.
- Войди в Whatnot с учетной записью владельца продавца и открой панель разработчика, вкладка Личные токены доступа (https://www.whatnot.com/dashboard/developer?tab=tokens). Только владелец учетной записи может создавать токены.
- Нажми Создать новый токен, дай ему имя, выбери срок действия (от 7 до 90 дней, произвольная дата или без срока действия) и разрешения: чтение и запись для инвентаря, мерчандайзинга, заказов и отгрузок, чтение для шоу, чтение и запись для отчетов, и чтение клиентов, если агент должен видеть имена покупателей. Доступ на запись включает доступ на чтение.
- Скопируй токен (он начинается с
wn_pat_tk_и показывается только один раз) вWHATNOT_API_TOKEN.
API продавца все еще помечен как бета-версия Whatnot: поля могут изменяться.
С чего начать: whatnot_get_current_user проверяет токен. whatnot_list_orders показывает недавние заказы; выполняй те, у которых статус pending_fulfillment. whatnot_list_products перечисляет каталог.
Заказы и отгрузка: whatnot_list_orders, whatnot_get_order, whatnot_list_order_items, whatnot_get_order_item. Каждый элемент заказа принадлежит отгрузке: whatnot_list_shipments, whatnot_get_shipment, whatnot_list_shipment_items. Отгружай с помощью собственного ярлыка через whatnot_add_tracking_code (идентификаторы элементов заказа, перевозчик, код отслеживания). whatnot_generate_shipping_label (ярлык Whatnot, может стоить денег) и whatnot_cancel_order (возврат покупателю) установлены выключенными.
Размещение продукта: 1) whatnot_list_dimension_profiles для идентификатора профиля упаковки, 2) whatnot_create_product с заголовком, идентификатором категории из публичной таксономии Whatnot (https://github.com/Whatnot-Inc/product-taxonomy) и профилем, 3) whatnot_list_product_variants для идентификаторов вариантов, 4) whatnot_update_product_variants для цен, 5) whatnot_set_inventory для запасов, 6) whatnot_update_product_merchandising для выбора buy_it_now или аукциона и публикации. Измени продукты с помощью whatnot_update_product, читай их с помощью whatnot_get_product и whatnot_get_product_variant. whatnot_delete_product установлен выключенным.
Инвентарь: whatnot_set_inventory (абсолютный) и whatnot_adjust_inventory (дельта) принимают до 10 вариантов за вызов; дай каждому элементу новый idempotency_key (UUID), чтобы повторный вызов применялся только один раз.
Шоу и мерчандайзинг: whatnot_list_shows (статус запланирован по умолчанию), whatnot_get_show, whatnot_get_show_analytics, whatnot_get_product_merchandising, whatnot_list_product_shows. Добавление продукта в шоу использует идентификаторы шоу (UUID) в whatnot_update_product_merchandising со стратегией ADD, REMOVE или REPLACE.
Отчеты: whatnot_generate_report запускает финансовый, аналитический обзор или отчет о прямых трансляциях; опрашивай whatnot_get_report или whatnot_list_reports, пока статус не будет завершен.
Пагинация: списки принимают limit (от 1 до 50, по умолчанию 10) и возвращают data плюс next_cursor; передавай его как cursor, пока он не станет null.
Идентификаторы и форматы: идентификаторы заказа, продукта, отгрузки и элемента заказа — это цифры (отправляй их как текст); идентификаторы вариантов, шоу и отчетов — это UUID. Деньги — это объект с amount как текст в целых единицах (19.99) и currency. Времена — это ISO 8601 в UTC с миллисекундами (2026-11-01T00:00:00.000Z).
Ошибки и лимиты: ошибки представлены в формате problem+json с type, title, detail (ошибка missing-scope перечисляет required_scopes: отредактируй разрешения токена); 422 для неправильно сформированного запроса перечисляет каждое поле под detail с loc и msg. Лимит составляет 10 запросов в секунду на продавца и приложение; 429 содержит Retry-After в секундах.
Шаг 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 о том, для чего нужны инструменты
Whatnot.
Настроить коннектор можно и из чата — в вебе, в приложениях для 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 не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
whatnot_get_current_user | Продавец, стоящий за токеном API: идентификатор пользователя, имя пользователя и отображаемое имя. Используй его для проверки соединения |
whatnot_list_orders | Список заказов, проданных продавцом, по умолчанию от новых к старым: идентификатор, статус (ожидание, ожидание выполнения, завершен, отменен, неудача)… |
whatnot_get_order | Один заказ по идентификатору со статусом, покупателем, суммами и временными метками. Выполняй заказы, статус которых — ожидание выполнения; ожидающие заказы не готовы… |
whatnot_list_order_items | Элементы одного заказа: идентификатор элемента, продукт, вариант, количество, цена и отгрузка, к которой принадлежит каждый элемент. Пагинация курсора, до 50 на странице |
whatnot_get_order_item | Один элемент заказа: продукт, вариант, количество, цена и отгрузка |
whatnot_cancel_order | Отменить заказ, который не был отправлен, и вернуть обновленный заказ. Покупатель получает возврат, и отмена учитывается против продавца.… |
whatnot_list_products | Список продуктов продавца, по умолчанию от новых к старым: идентификатор, заголовок, описание, external_id, категория, атрибуты, опции, медиа… |
whatnot_get_product | Один продукт с его категорией, атрибутами, опциями, изображениями, профилем размеров и вариантами (идентификатор, sku, цена, инвентарь) |
whatnot_create_product | Создать продукт в каталоге продавца. Whatnot создает один вариант на каждую комбинацию значений опций (один вариант без опций).… |
whatnot_update_product | Частично обновить продукт: заголовок, описание, внешний идентификатор, категория, атрибуты, опции, изображения или профиль размеров. Поля, оставленные без изменений, остаются… |
whatnot_delete_product | Удалить продукт из каталога продавца. Это действие нельзя отменить. Установлено выключенным |
whatnot_list_product_variants | Варианты продукта: идентификатор варианта (UUID), sku, external_id, выбранные значения опций, цена, инвентарь и изображение. Пагинация курсора, до 50 на… |
whatnot_get_product_variant | Один вариант продукта по его UUID: sku, опции, цена, инвентарь и изображение |
whatnot_update_product_variants | Обновить до 10 вариантов одного продукта: цена (в соответствии с форматом продажи продукта), sku, внешний идентификатор, страна происхождения или изображение. Поля, оставленные без изменений, остаются… |
whatnot_set_inventory | Установить доступное количество до 10 вариантов на абсолютное значение. Каждому элементу нужен уникальный idempotency_key (новый UUID на каждое изменение);… |
whatnot_adjust_inventory | Изменить доступное количество до 10 вариантов на дельту (отрицательное значение для уменьшения; результат ниже нуля становится 0). Каждому элементу нужен уникальный… |
whatnot_get_product_merchandising | Как и где продается продукт: transaction_type (buy_it_now или аукцион), reserve_for_live и назначен ли он на предстоящие или живые… |
whatnot_update_product_merchandising | Установить формат продажи продукта, зарезервировать его для живых шоу или добавить его в шоу или удалить из них за один вызов; поля, оставленные без изменений, остаются неизменными.… |
whatnot_list_product_shows | Предстоящие или живые шоу, к которым назначен продукт, по запланированному началу (по умолчанию последние первыми). Завершенные и отмененные шоу исключаются.… |
whatnot_list_shipments | Список отгрузок продавца, по умолчанию от новых к старым: идентификатор, статус (создан, ярлык сгенерирован, сдан, в пути, доставлен, отменен… |
whatnot_get_shipment | Одна отгрузка: статус, отслеживание, документы (ярлык), необходимые действия и адрес покупателя |
whatnot_list_shipment_items | Активные элементы отгрузки: идентификаторы элементов заказа, продукты, количества и профиль размеров. Пагинация курсора, до 50 на странице |
whatnot_add_tracking_code | Отгружай элементы заказа под кодом отслеживания с собственного ярлыка продавца. Элементы должны идти одному и тому же покупателю и адресу и не должны быть… |
whatnot_generate_shipping_label | Поставь ярлык для отгрузки Whatnot с его сохраненными настройками в очередь. 200 означает в очереди, не создан; ярлык приходит через Whatnot… |
whatnot_list_dimension_profiles | Активные профили размеров продавца (предустановки веса и размера упаковки): идентификатор, имя, вес, размеры. Используй идентификатор при создании продукта.… |
whatnot_list_shows | Список шоу продавца с одним статусом (запланирован по умолчанию), по запланированному времени начала, последние первыми по умолчанию: идентификатор (UUID), заголовок, статус… |
whatnot_get_show | Одно шоу по идентификатору (UUID): заголовок, статус, видимость, запланированное начало и URL |
whatnot_get_show_analytics | Аналитика одного шоу (продажи, зрители и другие метрики). Шоу без окончательных чисел отвечает нулевыми метриками и статусом расчета… |
whatnot_generate_report | Запрос на запуск отчета: seller_financial_report (транзакции между start_date и end_date, по умолчанию одна неделя), analytics_overview_report… |
whatnot_list_reports | Запросы отчетов продавца, самые последние запрашиваемые первыми: идентификатор, тип отчета, статус (ожидание, в процессе, завершен, неудача, отменен)… |
whatnot_get_report | Один запуск отчета по идентификатору (UUID): статус и, когда завершен, ссылка для загрузки файла |
Примеры подсказок
- "Какие заказы Whatnot с шоу прошлой ночи все еще требуют отгрузки?"
- "Добавь отслеживание UPS 1Z999AA10123456784 к отгрузке 778899."
- "Установи инвентарь варианта SKU WN-CARD-PK1 на 50."
- "Как прошло мое последнее шоу: зрители, продажи и доход?"
- "Сгенерируй отчет о продажах за октябрь."
Часто задаваемые вопросы
Откуда берется токен? Панель разработчика Whatnot, вкладка Личные токены доступа, созданные владельцем учетной записи с разрешениями, необходимыми инструментам. Он показывается один раз. API продавца все еще помечен как бета-версия Whatnot.
Что он охватывает? Заказы, позиции заказов, отгрузки и коды отслеживания, продукты и варианты, инвентарь, мерчандайзинг для покупки сейчас, аукционы и шоу, аналитика шоу и отчеты.
Какие инструменты установлены выключенными? whatnot_cancel_order, whatnot_delete_product и whatnot_generate_shipping_label. Включай их на странице коннектора только если ИИ должен их использовать.
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?