Кратко
API продавца Whatnot для продавцов на рынке прямых покупок: заказы, позиции заказов, отгрузки и коды отслеживания, продукты и варианты, запасы, мерчандайзинг для покупки сейчас, аукционы и шоу, аналитика шоу и отчеты. Личный токен доступа.
Пошаговая настройка
Подключи Whatnot к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Whatnot в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Whatnot
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Whatnot, вставь свои учетные данные, создай ключ API MCP, и все готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Whatnot
API продавца Whatnot для продавцов на рынке прямых покупок: заказы, позиции заказов, отгрузки и коды отслеживания, продукты и варианты, запасы, мерчандайзинг для покупки сейчас, аукционы и шоу, аналитика шоу и отчеты. Личный токен доступа.
Настройка
Настройка занимает около 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 в секундах.
Предварительные условия: WHATNOT_API_TOKEN
Установи коннектор локально
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, выбери Whatnot и вставь переменные окружения, указанные в предварительных условиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
whatnot_get_current_user | Продавец за токеном API: идентификатор пользователя, имя пользователя и отображаемое имя. Используй его для проверки соединения |
whatnot_list_orders | Список заказов, проданных продавцом, по умолчанию от новых к старым: идентификатор, статус (ожидание, ожидание выполнения, завершен, отменен, неудача)… |
whatnot_get_order | Один заказ по идентификатору со статусом, покупателем, суммами и временными метками. Выполняй заказы со статусом pending_fulfillment; ожидающие заказы не готовы… |
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."
- "Как прошло мое последнее шоу: зрители, продажи и доход?"
- "Сгенерируй отчет о продажах за октябрь."
Следующие шаги
Это руководство помогло?