摘要
Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。
引导式设置
2 分钟将 Whatnot 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Whatnot,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
Whatnot 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Whatnot,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Whatnot + Claude
Whatnot 卖家 API 适用于直播购物市场的卖家:订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。个人访问令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
WHATNOT_API_TOKEN
第 1 步 — 获取凭证
设置大约需要 2 分钟。
- 使用卖家账户所有者登录 Whatnot,并打开开发者仪表板,选项卡 个人访问令牌 (https://www.whatnot.com/dashboard/developer?tab=tokens)。只有账户所有者可以创建令牌。
- 点击 生成新令牌,给它命名,选择过期时间(7 到 90 天,自定义日期或不过期)和权限:库存、商品销售、订单和发货的读取和写入权限,节目的读取权限,报告的读取和写入权限,以及如果代理需要查看买家姓名,则读取客户权限。写入权限包括读取权限。
- 将令牌复制到
WHATNOT_API_TOKEN(它以wn_pat_tk_开头,并且只显示一次)。
卖家 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。时间为 UTC 的 ISO 8601 格式,带有毫秒(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 步 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP 服务器 → 该连接器所在的服务器,并复制其 URL (
https://cloud.anythingmcp.com/mcp/…)。在本指南中显示YOUR_SERVER_ID的地方使用它。
推荐路径:在 claude.ai web 上工作,无需编辑任何配置文件。
- 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
- 点击 + Add,然后选择 Add custom connector。
- 输入名称,例如
Whatnot,以及远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。 - 选择 Sign in now,点击 Add 并登录到 AnythingMCP(OAuth)以允许访问。
以下所有工具将出现在你的聊天中:开始输入提示。
可用工具
| 工具 | 功能 |
|---|---|
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 | 通过增量更改最多 10 个变体的可用数量(负数减少;结果低于零将变为 0)。每个项目需要一个唯一的… |
whatnot_get_product_merchandising | 产品的销售方式和地点:transaction_type(立即购买或拍卖)、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。"
- "我上一个节目的表现如何:观众、销售和收入?"
- "生成十月份的销售报告。"
常见问题
它是否适用于 Claude Code 和 Claude Desktop? 是的,两个都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
令牌来自哪里? Whatnot 开发者仪表板,选项卡个人访问令牌,由账户所有者创建,具有工具所需的权限。它只显示一次。卖家 API 仍被 Whatnot 标记为测试版。
它涵盖了什么? 订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。
哪些工具默认关闭? whatnot_cancel_order、whatnot_delete_product 和 whatnot_generate_shipping_label。仅在 AI 应该使用它们时在连接器页面上启用它们。
下一步
这份指南对你有帮助吗?