概要
ライブショッピングマーケットプレイスの販売者向けWhatnot Seller API:注文、注文アイテム、出荷および追跡コード、製品およびバリアント、在庫、今すぐ購入のためのマーチャンダイジング、オークションおよびショー、ショーの分析およびレポート。個人用アクセストークン。
ガイド付きセットアップ
Whatnot を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Whatnot を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Whatnot のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → Whatnotをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Whatnot + Meta Muse
ライブショッピングマーケットプレイスの販売者向けWhatnot Seller API:注文、注文アイテム、出荷および追跡コード、製品およびバリアント、在庫、今すぐ購入のためのマーチャンダイジング、オークションおよびショー、ショーの分析およびレポート。個人用アクセストークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
WHATNOT_API_TOKEN
ステップ 1 — 認証情報を取得する
セットアップには約2分かかります。
- Whatnotに販売者アカウントの所有者としてサインインし、開発者ダッシュボードのPersonal access tokensタブを開きます(https://www.whatnot.com/dashboard/developer?tab=tokens)。トークンを作成できるのはアカウントの所有者のみです。
- Generate new tokenをクリックし、名前を付け、期限(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)を付与し、再試行が1回だけ適用されるようにします。
ショーとマーチャンダイジング: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を秒単位で返します。
ステップ 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 — Museにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
Whatnotのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます(Web、iOS・Android アプリ、WhatsApp)。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
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になります)。各アイテムには一意の… |
whatnot_get_product_merchandising | 製品がどのようにどこで販売されるか:transaction_type(buy_it_nowまたはauction)、reserve_for_liveおよび今後のショーまたはライブショーに割り当てられているかどうか |
whatnot_update_product_merchandising | 製品の販売形式を設定し、ライブショーのために予約したり、ショーに追加または削除したりすることを1回の呼び出しで行います;省略されたフィールドは変更されません… |
whatnot_list_product_shows | 製品が割り当てられている今後またはライブのショー、スケジュールされた開始時間によって、デフォルトでは最新のものから表示:ID(UUID)、タイトル、ステータス… |
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月の売上レポートを生成します。"
FAQ
トークンはどこから来ますか? Whatnotの開発者ダッシュボード、Personal access tokensタブで、アカウントの所有者がツールに必要な権限で作成します。一度だけ表示されます。Seller APIはまだWhatnotによってベータ版としてマークされています。
何をカバーしていますか? 注文、注文アイテム、出荷および追跡コード、製品およびバリアント、在庫、今すぐ購入のためのマーチャンダイジング、オークションおよびショー、ショーの分析およびレポート。
どのツールが初期状態でオフになっていますか? whatnot_cancel_order、whatnot_delete_productおよびwhatnot_generate_shipping_label。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?