摘要
Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。
引导式设置
2 分钟将 Whatnot 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Whatnot,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Whatnot 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Whatnot,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Whatnot
Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。
设置
设置大约需要 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 使用你自己的标签发货(订单项 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_user | API 令牌背后的卖家:用户 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。"
- "我上一个节目的表现如何:观众、销售和收入?"
- "生成十月份的销售报告。"
下一步
这份指南对你有帮助吗?