连接器指南阅读约 3 分钟31 个 MCP 工具7 种语言

Whatnot MCP 服务器:订单、库存与直播

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Whatnot

Whatnot

Whatnot Seller API for sellers on the live shopping marketplace: orders, order items, shipments and tracking codes, products and variants, inventory, merchandising for buy it now, auctions and shows, show analytics and reports. Personal access token.

个工具

31

区域

INTL

类别

电子商务

身份验证

Bearer Token

所需环境变量

WHATNOT_API_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

引导式设置

2 分钟将 Whatnot 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Whatnot,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Whatnot 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Whatnot · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Whatnot,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Whatnot

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

设置

设置大约需要 2 分钟。

  1. 使用卖家账户所有者登录 Whatnot,并打开开发者仪表板,选项卡 个人访问令牌 (https://www.whatnot.com/dashboard/developer?tab=tokens)。只有账户所有者可以创建令牌。
  2. 点击 生成新令牌,给它命名,选择过期时间(7 到 90 天,自定义日期或不过期)和权限:库存、商品、订单和发货的读写权限,节目的读取权限,报告的读写权限,以及如果代理需要查看买家姓名,则读取客户权限。写入权限包括读取权限。
  3. 将令牌(以 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 使用你自己的标签发货(订单项 ID、承运人、追踪代码)。whatnot_generate_shipping_label(Whatnot 标签,可能需要费用)和 whatnot_cancel_order(退款给买家)默认关闭。

列出产品:1) whatnot_list_dimension_profiles 获取包裹配置文件 ID,2) whatnot_create_product 使用标题、来自 Whatnot 公共分类法的叶子类别 ID (https://github.com/Whatnot-Inc/product-taxonomy) 和配置文件,3) whatnot_list_product_variants 获取变体 ID,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。将产品添加到节目使用节目 ID(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。

ID 和格式:订单、产品、发货和订单项 ID 为数字(以文本形式发送);变体、节目和报告 ID 为 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_userAPI 令牌背后的卖家:用户 ID、用户名和显示名称。用它来检查连接
whatnot_list_orders列出卖家销售的订单,默认按最新排序:ID、状态(待处理、待发货、已完成、已取消、失败)…
whatnot_get_order通过 ID 获取一个订单,包含状态、买家、金额和时间戳。处理状态为 pending_fulfillment 的订单;待处理订单尚未准备好…
whatnot_list_order_items一个订单的项目:项目 ID、产品、变体、数量、价格,以及每个项目所属的发货。光标分页,每页最多 50 个
whatnot_get_order_item一个订单的项目:产品、变体、数量、价格和发货
whatnot_cancel_order取消尚未发货的订单并返回更新后的订单。买家将获得退款,取消将计入卖家…
whatnot_list_products列出卖家的产品,默认按最新排序:ID、标题、描述、external_id、类别、属性、选项、媒体…
whatnot_get_product一个产品及其类别、属性、选项、图片、尺寸配置文件和变体(ID、SKU、价格、库存)
whatnot_create_product在卖家的目录中创建一个产品。Whatnot 为每种选项值组合创建一个变体(一个没有选项的变体)…
whatnot_update_product部分更新一个产品:标题、描述、external id、类别、属性、选项、图片或尺寸配置文件。未提供的字段保持不变…
whatnot_delete_product从卖家的目录中删除一个产品。此操作无法撤销。默认关闭
whatnot_list_product_variants产品的变体:变体 ID(UUID)、SKU、external_id、选定的选项值、价格、库存和图片。光标分页,每页最多 50 个…
whatnot_get_product_variant通过其 UUID 获取一个产品的变体:SKU、选项、价格、库存和图片
whatnot_update_product_variants更新一个产品的最多 10 个变体:价格(在产品的销售格式下)、SKU、external id、原产国或图片。未提供的字段保持不变…
whatnot_set_inventory将最多 10 个变体的可用数量设置为绝对值。每个项目需要一个唯一的 idempotency_key(每次更改一个新的 UUID);一个…
whatnot_adjust_inventory按增量(负数减少;结果低于零变为 0)更改最多 10 个变体的可用数量。每个项目需要一个唯一的…
whatnot_get_product_merchandising产品的销售方式和地点:transaction_type(buy_it_now 或拍卖)、reserve_for_live 以及是否分配给即将到来的或正在进行的…
whatnot_update_product_merchandising在一次调用中设置产品的销售格式,为直播节目保留,或将其添加到或从节目中移除;未提供的字段保持不变…
whatnot_list_product_shows产品分配的即将到来或正在进行的节目,按计划开始时间(默认按最新排序)。结束和取消的节目将被排除…
whatnot_list_shipments列出卖家的发货,默认按最新排序:ID、状态(已创建、标签生成、已交付、运输中、已交付、已取消…
whatnot_get_shipment一个发货:状态、追踪、文件(标签)、所需操作和买家地址
whatnot_list_shipment_items一个发货的活动项目:订单项 ID、产品、数量和尺寸配置文件。光标分页,每页最多 50 个
whatnot_add_tracking_code在卖家的自有标签下发货订单项。项目必须发送给同一买家和地址,并且不得已发货…
whatnot_generate_shipping_label为发货排队生成一个 Whatnot 运输标签,使用其保存的设置。200 表示排队,而不是已创建;标签通过 Whatnot 的…
whatnot_list_dimension_profiles卖家的活动尺寸配置文件(包裹重量和尺寸预设):ID、名称、重量、尺寸。在创建产品时使用 ID…
whatnot_list_shows列出卖家的节目,按一个状态(默认已安排),按计划开始时间,默认按最新排序:ID(UUID)、标题、状态…
whatnot_get_show通过 ID(UUID)获取一个节目:标题、状态、可见性、计划开始时间和 URL
whatnot_get_show_analytics一个节目的分析(销售、观众和其他指标)。没有最终数字的节目返回 null 指标和计算状态…
whatnot_generate_report请求报告运行:seller_financial_report(在 start_date 和 end_date 之间的交易,默认一周)、analytics_overview_report…
whatnot_list_reports卖家的报告运行,最近请求的优先:ID、report_type、状态(待处理、进行中、已完成、失败、已取消)…
whatnot_get_report通过 ID(UUID)获取一个报告运行:状态,以及完成时下载文件的链接

示例提示

  • "昨晚节目中哪些 Whatnot 订单仍需发货?"
  • "将 UPS 追踪 1Z999AA10123456784 添加到发货 778899。"
  • "将变体 SKU WN-CARD-PK1 的库存设置为 50。"
  • "我上一个节目的表现如何:观众、销售和收入?"
  • "生成十月份的销售报告。"

下一步

这份指南对你有帮助吗?

2 分钟将 Whatnot 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Whatnot,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

连接 Whatnot MCP 与 ChatGPT:订单和库存

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

连接器

连接 Whatnot MCP 与 Claude:订单和直播

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

连接器

连接 Whatnot MCP 与 Microsoft Copilot

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

连接器

连接 Whatnot MCP 与 Cursor:商品和订单

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

连接器

连接 Whatnot MCP 与 Gemini CLI:订单和直播

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。

连接器

连接 Whatnot MCP 与 Meta Muse:订单和库存

Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。