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

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

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

HC作者:HelpCode 团队更新于 4 分钟阅读 在 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 连接到 ChatGPT

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

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

ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。

试试这样问

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 + ChatGPT

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

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

WHATNOT_API_TOKEN

第 1 步 — 获取凭证

设置大约需要 2 分钟。

  1. 使用卖家账户所有者登录 Whatnot,并打开开发者仪表板,选项卡 个人访问令牌 (https://www.whatnot.com/dashboard/developer?tab=tokens)。只有账户所有者可以创建令牌。
  2. 点击 生成新令牌,给它命名,选择过期时间(7 到 90 天,自定义日期或不过期)和权限:库存、商品销售、订单和发货的读取和写入权限,节目的读取权限,报告的读取和写入权限,以及如果代理需要查看买家姓名,则读取客户权限。写入权限包括读取权限。
  3. 将令牌复制到 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 步 — 在 ChatGPT 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。

  1. 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
  2. 填写名称,例如 Name: Whatnot。
  3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。
  4. 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
  5. 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。

可用工具

工具功能
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通过增量更改最多 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。"
  • "我上一个节目的表现如何:观众、销售和收入?"
  • "生成十月份的销售报告。"

常见问题

令牌来自哪里? Whatnot 开发者仪表板,选项卡个人访问令牌,由账户所有者创建,具有工具所需的权限。它只显示一次。卖家 API 仍被 Whatnot 标记为测试版。

它涵盖了什么? 订单、订单项、发货和追踪代码、产品和变体、库存、立即购买的商品、拍卖和节目、节目分析和报告。

哪些工具默认关闭? whatnot_cancel_order、whatnot_delete_product 和 whatnot_generate_shipping_label。仅在 AI 应该使用它们时在连接器页面上启用它们。

ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。

下一步

这份指南对你有帮助吗?

2 分钟将 Whatnot 连接到 ChatGPT

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

相关指南

连接器

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

连接器

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

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