概要
ライブショッピングマーケットプレイスの売り手向けWhatnot Seller API:注文、注文アイテム、出荷および追跡コード、製品とバリアント、在庫、今すぐ購入のためのマーチャンダイジング、オークションとショー、ショーの分析とレポート。個人用アクセストークン。
ガイド付きセットアップ
Whatnot を Claude、ChatGPT、Copilot に 2 分で接続
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 Seller API:注文、注文アイテム、出荷および追跡コード、製品とバリアント、在庫、今すぐ購入のためのマーチャンダイジング、オークションとショー、ショーの分析とレポート。個人用アクセストークン。
セットアップ
セットアップには約2分かかります。
- 売り手アカウントの所有者としてWhatnotにサインインし、開発者ダッシュボードの個人用アクセストークンタブ(https://www.whatnot.com/dashboard/developer?tab=tokens)を開きます。トークンを作成できるのはアカウントの所有者のみです。
- 新しいトークンを生成をクリックし、名前を付け、期限(7日から90日、カスタム日付または期限なし)と権限を選択します:在庫、マーチャンダイジング、注文および出荷の読み取りと書き込み、ショーの読み取り、レポートの読み取りと書き込み、バイヤー名を表示する必要がある場合は顧客の読み取り。書き込みアクセスには読み取りアクセスが含まれます。
- トークンをコピーします(
wn_pat_tk_で始まり、一度だけ表示されます)をWHATNOT_API_TOKENに貼り付けます。
Seller 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(デルタ)は、1回の呼び出しで最大10バリアントを処理します;各アイテムには新しいidempotency_key(UUID)を与え、再試行が一度だけ適用されるようにします。
ショーとマーチャンダイジング:whatnot_list_shows(デフォルトでは状態はスケジュール済み)、whatnot_get_show、whatnot_get_show_analytics、whatnot_get_product_merchandising、whatnot_list_product_shows。ショーに製品を追加するには、whatnot_update_product_merchandisingでショーID(UUID)を使用し、戦略として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と共にリストされます。制限は、売り手とアプリごとに1秒あたり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、状態(pending、pending_fulfillment、completed、cancelled、failed)… |
whatnot_get_order | IDによる1つの注文:状態、バイヤー、金額、タイムスタンプ。状態がpending_fulfillmentの注文を履行します;pendingの注文は準備ができていません… |
whatnot_list_order_items | 1つの注文のアイテム:アイテムID、製品、バリアント、数量、価格、各アイテムが属する出荷。カーソルページング、ページあたり最大50 |
whatnot_get_order_item | 1つの注文のアイテム:製品、バリアント、数量、価格、出荷 |
whatnot_cancel_order | 出荷されていない注文をキャンセルし、更新された注文を返します。バイヤーは返金され、キャンセルは売り手にカウントされます… |
whatnot_list_products | 売り手の製品をリストします。デフォルトでは最新のものから表示:ID、タイトル、説明、external_id、カテゴリ、属性、オプション、メディア… |
whatnot_get_product | カテゴリ、属性、オプション、画像、寸法プロファイル、バリアント(ID、SKU、価格、在庫)を持つ1つの製品 |
whatnot_create_product | 売り手のカタログに製品を作成します。Whatnotはオプション値の組み合わせごとに1つのバリアントを作成します(オプションなしの1つのバリアント)… |
whatnot_update_product | 製品を部分的に更新します:タイトル、説明、external ID、カテゴリ、属性、オプション、画像または寸法プロファイル。省略されたフィールドはそのまま… |
whatnot_delete_product | 売り手のカタログから製品を削除します。元に戻すことはできません。初期状態ではオフになっています |
whatnot_list_product_variants | 製品のバリアント:バリアントID(UUID)、SKU、external_id、選択されたオプション値、価格、在庫、画像。カーソルページング、最大50 |
whatnot_get_product_variant | UUIDによる製品の1つのバリアント:SKU、オプション、価格、在庫、画像 |
whatnot_update_product_variants | 1つの製品の最大10バリアントを更新します:価格(製品の販売形式の下)、SKU、external ID、原産国または画像。省略されたフィールドは… |
whatnot_set_inventory | 最大10バリアントの利用可能な数量を絶対値に設定します。各アイテムには一意のidempotency_key(変更ごとに新しいUUID)が必要です;… |
whatnot_adjust_inventory | 最大10バリアントの利用可能な数量をデルタで変更します(減少させるためには負の値;結果が0未満になると0になります)。各アイテムには一意の… |
whatnot_get_product_merchandising | 製品がどのようにどこで販売されるか:transaction_type(buy_it_nowまたはauction)、reserve_for_live、今後のショーまたはライブショーに割り当てられているかどうか |
whatnot_update_product_merchandising | 製品の販売形式を設定し、ライブショーのために予約したり、ショーに追加したり削除したりすることを1回の呼び出しで行います;省略されたフィールドは変更されません… |
whatnot_list_product_shows | 製品が割り当てられている今後のショーまたはライブショー、スケジュールされた開始時刻による(デフォルトでは最新のものから表示)。終了したショーやキャンセルされたショーは除外されます… |
whatnot_list_shipments | 売り手の出荷をリストします。デフォルトでは最新のものから表示:ID、状態(created、label_generated、dropped_off、in_transit、delivered、cancelled… |
whatnot_get_shipment | 1つの出荷:状態、追跡、書類(ラベル)、必要なアクション、バイヤーの住所 |
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 | 売り手のショーを1つの状態(デフォルトではスケジュール済み)でリストし、スケジュールされた開始時刻による、最新のものから表示:ID(UUID)、タイトル、状態… |
whatnot_get_show | ID(UUID)による1つのショー:タイトル、状態、可視性、スケジュールされた開始時刻、URL |
whatnot_get_show_analytics | 1つのショーの分析(売上、視聴者、その他の指標)。最終的な数字がないショーはnullの指標と計算状態で応答します… |
whatnot_generate_report | レポートの実行をリクエストします:seller_financial_report(start_dateとend_dateの間のトランザクション、デフォルトは1週間)、analytics_overview_report… |
whatnot_list_reports | 売り手のレポート実行、最も最近リクエストされたものから表示:ID、report_type、状態(pending、in_progress、completed、failed、cancelled)… |
whatnot_get_report | ID(UUID)による1つのレポート実行:状態と、完了した場合はファイルをダウンロードするためのリンク |
例のプロンプト
- "昨夜のショーからのWhatnotの注文で、まだ出荷が必要なものは?"
- "出荷778899にUPS追跡1Z999AA10123456784を追加。"
- "バリアントSKU WN-CARD-PK1の在庫を50に設定。"
- "私の最後のショーのパフォーマンスはどうだった:視聴者、売上、収益は?"
- "10月の売上レポートを生成。"
次のステップ
このガイドは役に立ちましたか?