概要
Wish Marketplace API v3 for merchants: 注文と追跡付きの履行、倉庫ごとの価格と在庫を持つ製品とバリエーション、カテゴリと属性、カスタマーサポートチケット、評価、ペナルティ、倉庫と配送設定。プライベートアプリからのOAuthアクセストークン。
ガイド付きセットアップ
Wish を Claude に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Wish を接続して、MCP URL を Claude に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
こう聞いてみよう
Wish のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comを直接使用してください。 サインインし、Connectors → Wishをクリックして、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Wish + Claude
Wish Marketplace API v3 for merchants: 注文と追跡付きの履行、倉庫ごとの価格と在庫を持つ製品とバリエーション、カテゴリと属性、カスタマーサポートチケット、評価、ペナルティ、倉庫と配送設定。プライベートアプリからのOAuthアクセストークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
WISH_ACCESS_TOKEN
ステップ1 — 資格情報を取得する
設定には約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分間有効で、1回のみ使用できます。- コードを交換します:
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ヘッダーを引用してください。
ステップ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を選択します。
- 名前を入力します(例:
Wish)、リモートMCPサーバーURLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、次にContinue をクリックし、検出された設定のまま、もう一度 Continue をクリックします。 - Sign in now を選んで Add をクリックし、AnythingMCPにサインインして(OAuth)アクセスを許可します。
以下のすべてのツールがチャットに表示されます:プロンプトの入力を開始してください。
利用可能なツール
| ツール | 機能 |
|---|---|
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 | 受け入れられた配送キャリア:すべてのキャリア(一般)または目的国への確認された配送ポリシーに受け入れられたキャリア… |
wish_fulfill_order | 注文を出荷済みとしてマークするか、追跡を更新します:キャリア、追跡番号、原産国。非同期です;再度注文を読み取って結果を確認します… |
wish_list_refund_reasons | 現在の注文に対して有効な返金理由(注文のライフサイクル中に変更されます)。返金の直前に読み取ります |
wish_refund_order | 理由を指定して注文を返金またはキャンセルします。顧客はお金を返金され、元に戻すことはできません;返金は… |
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の評価は何ですか?"
FAQ
Claude CodeとClaude Desktopの両方で動作しますか? はい、両方をhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDにポイントしてください。
トークンは自動的に更新されますか? いいえ。Wishのアクセストークンは30日後に期限切れになり、Wishはコネクタの自動更新が送信しないリクエストでのみ更新します。期限切れになる前にリフレッシュトークンでトークンを更新し、新しいトークンを貼り付けてください。
トークンはどこから来ますか? WishマーチャントダッシュボードのAPI設定で登録したプライベートアプリからです:承認し、コードをアクセストークンと交換し、そのトークンを貼り付けます。
どのツールがオフに切り替えられていますか? wish_refund_orderとwish_delete_product。AIが使用する必要がある場合のみ、コネクタページでオンに切り替えてください。
次のステップ
このガイドは役に立ちましたか?