概要
商人向けのWish Marketplace API v3:追跡付きの注文と履行、倉庫ごとの価格と在庫を持つ製品とバリエーション、カテゴリと属性、カスタマーサポートチケット、評価、ペナルティ、倉庫と配送設定。プライベートアプリからのOAuthアクセストークン。
ガイド付きセットアップ
Wish を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Wish を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Wish のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comを直接使用してください。 サインインして、Connectors → Wishをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Wish
商人向けのWish Marketplace API v3:追跡付きの注文と履行、倉庫ごとの価格と在庫を持つ製品とバリエーション、カテゴリと属性、カスタマーサポートチケット、評価、ペナルティ、倉庫と配送設定。プライベートアプリからのOAuthアクセストークン。
セットアップ
セットアップには約10分かかります。
- Wish商人ダッシュボード(https://merchant.wish.com)でアカウントメニューを開き、**API設定**を選択し、**プライベートアプリを登録**をクリックします。名前と所有するHTTPSリダイレクトURIを入力します(任意のページで動作し、コードはそのアドレスに表示される必要があります)。Wishは商人ごとに1つのプライベートアプリを許可しています。
https://merchant.wish.com/v3/oauth/authorize?client_id=の後にアプリのクライアントIDを続けて開き、サインインして承認します。WishはリダイレクトURIに?code=を含むアドレスでリダイレクトします;コードは5分間有効で、一度だけ使用できます。- コードを交換します:
https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=...を自分の値で開きます。data.access_tokenをWISH_ACCESS_TOKENにコピーし、data.refresh_tokenを安全に保管します。
トークンの有効期限:Wishのアクセストークンは30日後に期限切れになります。それ以前に、https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=...を開き、新しいアクセストークンをコネクタに貼り付けます(古いものは無効になります)。WishはGETリクエストでのみトークンを更新するため、コネクタの自動OAuth更新では送信されないので、更新は現在手動です。
どこから始めるか:wish_test_tokenはトークンをチェックし、そのスコープを表示します。wish_list_ordersは出荷するための状態がAPPROVEDの注文をリストします;wish_list_productsはカタログをリストします;wish_list_warehousesは在庫が必要な倉庫IDを提供します。
注文:wish_list_orders、wish_get_order。wish_fulfill_orderで出荷します(キャリアはwish_list_shipping_carriersから、追跡番号、発信国);同じ呼び出しで後で追跡を修正します。出荷と返金は非同期です:結果を確認するために再度注文を読み取ります。wish_list_refund_reasonsは有効な理由を表示します;wish_refund_orderは顧客に返金し、デフォルトではオフになっています。
製品:wish_list_products、wish_get_product、wish_create_product、wish_update_product(価格、倉庫ごとの在庫、バリエーションIDによるバリエーションの状態)、wish_create_variation。カテゴリ:wish_get_categories、wish_get_category、wish_get_category_attributes。wish_delete_productはデフォルトでオフになっています;代わりにバリエーションを無効にします。wish_get_product_ratingは評価を読み取ります。
カスタマーチケット:wish_list_tickets(状態AWAITING_MERCHANTは回答が必要)、wish_get_ticket、wish_reply_to_ticket、wish_update_ticket(クローズ、再オープン、アピール)。
アカウント:wish_get_account_details、wish_list_penalties、wish_get_shipping_settings、wish_list_warehouses。
ページング:リストは最大limitアイテムを時間順に返します;次のページを取得するには、最後のアイテムの時間をupdated_at_max(またはcreated_at_max)に設定して再度呼び出します。すべての回答はcode、message、dataの形を持ちます;codeが0は成功を意味します。
IDとフォーマット:注文、製品、バリエーション、チケット、倉庫のIDは24文字の16進文字列です。時間はISO 8601形式(2026-11-01T00:00:00Z)です。価格はamountとcurrency_codeを持つオブジェクトです。トークンのスコープが何が機能するかを決定します:スコープが不足していると403が返されます。
レート制限:商人とアプリごと;ヘッダーWish-Rate-Limit-Remainingは残りの数を示し、429はWish-Rate-Limit-Resetを含みます。Wishに呼び出しについて連絡する際はWish-Request-Idヘッダーを引用してください。
前提条件:WISH_ACCESS_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を開き、Wishを選択し、前提条件の下にリストされた環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
wish_test_token | アクセストークンが機能するか確認します:商人IDとトークンのスコープを返します |
wish_get_account_details | 商人アカウント:ID、表示名、連絡先、国、状態、その他のアカウント詳細 |
wish_list_orders | 注文をリストします。デフォルトでは最近更新されたものから順に:ID、状態(出荷のためのAPPROVED、SHIPPED、REFUNDED、REQUIRE_REVIEW)、注文タイプ、製品… |
wish_get_order | IDによる1つの注文:状態、製品とバリエーション、数量、価格と支払い、配送先住所、履行要件と期限… |
wish_list_shipping_carriers | 受け入れられた配送キャリア:すべてのキャリア(GENERAL)または目的国への確認済み配送ポリシーに受け入れられたキャリア… |
wish_fulfill_order | 注文を出荷済みとしてマークするか、追跡を更新します:キャリア、追跡番号、発信国。非同期です;再度注文を読み取って… |
wish_list_refund_reasons | 現在の注文に対して有効な返金理由(注文のライフサイクル中に変わります)。返金の直前に読み取ります |
wish_refund_order | wish_list_refund_reasonsからの理由で注文を返金またはキャンセルします。顧客はお金を返金され、元に戻すことはできません;返金は… |
wish_list_products | 製品をリストします。デフォルトでは最近更新されたものから順に:ID、parent_sku、名前、状態、カテゴリ、画像、バリエーション(ID、SKU、価格、在庫… |
wish_get_product | IDによる1つの製品とそのバリエーション、価格、倉庫ごとの在庫、画像、属性、配送およびレビュー状態 |
wish_create_product | 少なくとも1つのバリエーションを持つ製品を作成します。名前、説明(プレーンテキスト、最大4,000文字)、親SKU、カテゴリ、主要… |
wish_update_product | 製品を更新します:名前、説明、タグ、カテゴリ、画像、デフォルトの配送価格、状態、または既存のバリエーション(バリエーションIDによる… |
wish_delete_product | 製品リストを削除します。元に戻すことはできません。デフォルトでオフになっています;代わりにwish_update_productでバリエーションを無効にします |
wish_create_variation | 既存の製品にバリエーションを追加します:SKU、価格、倉庫ごとの在庫、オプション値と画像 |
wish_get_categories | Wishのカテゴリツリーのルートとその子カテゴリ(ID、名前、is_leaf)。wish_get_categoryでリーフに降りてcategory_idを取得します |
wish_get_category | IDによる1つのカテゴリとその子カテゴリ;リーフカテゴリはcategory_idとして使用できます |
wish_get_category_attributes | 製品を作成する際に属性とオプションを埋めるためのカテゴリの属性(名前、必須、許可される値) |
wish_get_product_rating | 製品の全体的な評価:平均評価と評価数 |
wish_list_tickets | カスタマーサポートチケット、最近更新されたものから順に:ID、タイプ(ORDER、PRE_PURCHASE、POST_CUSTOMER_SUPPORT)、状態(AWAITING_MERCHANT… |
wish_get_ticket | メッセージ、関連する注文と状態を持つ1つのサポートチケット |
wish_reply_to_ticket | 状態AWAITING_MERCHANTのチケットに返信します(最大2,000文字、Markdownが許可されています)。Wishは返信後に状態を更新します |
wish_update_ticket | チケットをクローズ(CLOSED)するか、クローズされたものを再オープン(AWAITING_MERCHANT、許可されている場合)するか、Wishサポートにアピール(AWAITING_WISH)します |
wish_list_penalties | アカウントのペナルティ、最新のものから順に:ID、タイプ、金額と通貨、理由、注文または製品、作成された時間と逆転時間。最大500件… |
wish_get_shipping_settings | Wishが配送する目的国ごとの商人の配送設定:有効な国、配送価格と地域 |
wish_list_warehouses | 商人の倉庫:ID、名前、タイプ(標準倉庫が最初)、住所。倉庫IDは在庫と配送価格に必要です |
例のプロンプト
- "今日履行が必要なWishの注文はどれですか?"
- "注文64a1b2c3d4e5をUSPS追跡9400111899223197428490で履行します。"
- "私の返信を待っているサポートチケットはどれですか?"
- "今月私のアカウントに新しいペナルティはありますか?"
- "製品5f9e8d7c6b5aの評価は何ですか?"
次のステップ
このガイドは役に立ちましたか?