概要
アメリカのセラー向けWalmart Marketplace API: 追跡付きの注文の確認と出荷、返品、アイテムおよびカタログ検索、在庫、価格、大量フィード、リクエストに応じたレポート、WFSの入荷出荷および出荷設定。クライアントIDとシークレット。
ガイド付きセットアップ
Walmart Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Walmart Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Walmart Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Walmart Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Walmart Marketplace
アメリカのセラー向けWalmart Marketplace API: 追跡付きの注文の確認と出荷、返品、アイテムおよびカタログ検索、在庫、価格、大量フィード、リクエストに応じたレポート、WFSの入荷出荷および出荷設定。クライアントIDとシークレット。
セットアップ
セットアップには約5分かかります。
- https://developer.walmart.com にSeller Centerのログイン情報でサインインします(Marketplaceセラーを選択)。
- My Accountを開き、次にAPI Keys(キー管理)を選択し、productionクライアントIDとクライアントシークレットを作成またはコピーします。
- クライアントIDを
WALMART_CLIENT_IDに、クライアントシークレットをWALMART_CLIENT_SECRETに貼り付けます。
コネクタはPOST /v3/token(HTTP Basic、クライアント資格情報)でそれらを交換し、15分間有効なアクセストークンを取得します。トークンが期限切れになる直前まで再利用し、自動的に新しいトークンを取得します。すべての呼び出しにはWM_SEC.ACCESS_TOKEN、WM_SVC.NAME、および新しいWM_QOS.CORRELATION_IDが含まれます。自分のセラークライアント資格情報を使用してください: ソリューションプロバイダー用のDelegated Accessキーは廃止されつつあり(新しいものは作成できず、既存のものは2027年4月30日以降に機能しなくなります)。
開始する場所: walmart_marketplace_list_released_orders(あなたを待っている注文)、次にwalmart_marketplace_get_order。walmart_marketplace_list_itemsはあなたのカタログをリストし、walmart_marketplace_get_inventoryはSKUの在庫を示します。
注文: walmart_marketplace_list_orders(すべてのステータス)、walmart_marketplace_list_released_orders(Createdステータスの行)、walmart_marketplace_get_order。行はCreated、Acknowledged、Shipped、Delivered、またはCancelledになります。新しい注文はすぐにwalmart_marketplace_acknowledge_orderで確認し、各行をwalmart_marketplace_ship_order_lineで出荷します(キャリア、方法、追跡番号、エポックミリ秒での出荷時間);出荷は顧客の支払いをキャプチャします。walmart_marketplace_cancel_order_lineとwalmart_marketplace_refund_order_linesはオフに設定されています: キャンセルはあなたのセラーメトリクスに悪影響を及ぼし、返金はお金を移動させます。注文リストは最大180日遡り、最大10,000件の注文があり、デフォルトでは過去7日間に設定されています。
ページング: 注文と返品はmeta.nextCursorで応答し、?で始まる準備されたクエリ文字列です。これを変更せずにnext_cursorとして渡し、他のフィルターは省略します。アイテムはnextCursor(*で始まり、有効期限は2分)または制限とオフセットを使用します。
返品: walmart_marketplace_list_returns(ステータスINITIATED、DELIVERED、COMPLETED)。walmart_marketplace_refund_returnは顧客に返金するためオフに設定されています。
アイテムとカタログ: walmart_marketplace_list_items、walmart_marketplace_get_item、walmart_marketplace_count_items、walmart_marketplace_search_my_catalog(未公開アイテムなどのフィルター付きのあなたのカタログ)およびwalmart_marketplace_search_walmart_catalog(キーワード、UPC、GTINによる公開Walmart.comカタログ)。walmart_marketplace_retire_itemはオフに設定されています: 引退するとリストが削除されます。
在庫と価格: walmart_marketplace_get_inventory、walmart_marketplace_get_inventory_by_ship_node、walmart_marketplace_update_inventory(絶対数量、単位はEACH)、walmart_marketplace_get_wfs_inventory(WFSが保持する在庫)。walmart_marketplace_update_priceは1SKUのBASE価格をUSDで設定します(1時間あたり100回の呼び出し);walmart_marketplace_get_promotional_pricesは販売価格を表示します。
フィード: 大量変更はフィードを通じて行われます。walmart_marketplace_submit_item_feedとwalmart_marketplace_submit_price_feedはオフに設定されています。なぜなら、1つのフィードが多くのライブリストを変更し、大量価格フィードは時間と日ごとに制限されているからです(1時間あたり10件、すべての価格およびプロモーションフィードで共有)。結果はwalmart_marketplace_list_feedsとwalmart_marketplace_get_feed_status(詳細を含むアイテムエラー)で確認します。
レポート: walmart_marketplace_request_report、次にwalmart_marketplace_list_report_requestsまたはwalmart_marketplace_get_report_requestがREADYになるまで、次にwalmart_marketplace_get_report_download_url。ステータスとダウンロード呼び出しはそれぞれ1時間あたり20回に制限されているため、チェックの間に数分待ってください。リンクは短命の圧縮CSVです。
WFS: walmart_marketplace_list_inbound_shipments、walmart_marketplace_list_inbound_shipment_items、walmart_marketplace_create_inbound_shipment_label(PDFまたはZPLとしての受取ラベル、無料)。
設定(読み取り専用): walmart_marketplace_list_ship_nodes(出荷ノードID)、walmart_marketplace_list_carrier_methods、walmart_marketplace_list_shipping_templates、walmart_marketplace_get_lag_time(1時間あたり20回の呼び出し)。
レート制限: 各APIには独自のトークンバケットがあります(すべての注文は1分あたり5,000件、リリースされた注文は1分あたり60件、出荷、確認、キャンセルは1分あたり60件、在庫は1分あたり200件、アイテムは1分あたり300件)。429はバケットが空であることを意味します;ヘッダーx-current-token-countとX-Next-Replenishment-Timeは再試行のタイミングを示します。
フォーマット: 日付はUTCのISO 8601形式;回答内の注文日付はエポックミリ秒です。通貨はUSDです。SKUはあなた自身のセラーSKUです;Walmart IDはpurchaseOrderId(注文)、returnOrderId(返品)、wpidおよびitemId(カタログ)です。エラーはerrors.error[]として返され、コード、フィールド、説明が含まれます;400 INVALID_REQUEST_HEADERは通常、トークンまたはヘッダーの問題を意味します。
前提条件: WALMART_CLIENT_ID、WALMART_CLIENT_SECRET
コネクタをローカルにインストールする
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を開き、Walmart Marketplaceを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
walmart_marketplace_list_orders | 購入注文をリスト(最新順):list.meta(totalCount、limit、nextCursor)およびlist.elements.order[]にpurchaseOrderId… |
walmart_marketplace_list_released_orders | リリースされた注文をリスト:Createdステータスの行を持つ購入注文、確認して出荷する準備ができています。同じフィールド… |
walmart_marketplace_get_order | 1つの購入注文を読み取る:purchaseOrderId、customerOrderId、customerEmailId(中継アドレス)、orderDate、shippingInfo(電話… |
walmart_marketplace_acknowledge_order | 1つの購入注文全体を確認(すべての行がCreatedからAcknowledgedに移動)、履行することを確認します。Walmartはこれを期待しています… |
walmart_marketplace_ship_order_line | 1つの注文行をキャリアと追跡番号で出荷済みとしてマークします。Walmartはその後、顧客の支払いをキャプチャしますので、実際に出荷するものだけを出荷してください… |
walmart_marketplace_cancel_order_line | 出荷できない1つの注文行のユニットを理由を添えてキャンセルします。これは元に戻せず、キャンセル率にカウントされます;使用… |
walmart_marketplace_refund_order_lines | 出荷済みの注文行(全額または一部)を顧客に返金します。これは顧客にお金を戻し、元に戻せません。行は… |
walmart_marketplace_list_returns | 返品注文(RMA)をリスト(最新順):meta(totalCount、limit、nextCursor)およびreturnOrders[]にreturnOrderId、customerOrderId… |
walmart_marketplace_refund_return | 返品注文(RMA)の行に対して返金を発行します。これは顧客にお金を戻し、元に戻せません。返金結果を返します… |
walmart_marketplace_list_items | あなたのWalmartカタログ内のアイテムをリスト:ItemResponse[]にsku、wpid、upc、gtin、productName、productType、shelf、price(amount… |
walmart_marketplace_get_item | SKU(デフォルト)または他の識別子によってあなたのカタログの1つのアイテムを読み取ります:sku、wpid、upc、gtin、productName、shelf、productType、price… |
walmart_marketplace_search_my_catalog | クエリ、フィルター、ソートを使用してあなた自身のセラーカタログを検索します:items[]にsku、itemId、productName、brand、price、publishedStatus… |
walmart_marketplace_search_walmart_catalog | キーワードまたはUPC、GTIN、EAN、ISBNによって公開Walmart.comカタログ(すべてのセラー)を検索し、製品がすでに存在するかどうかを確認します… |
walmart_marketplace_count_items | 1つのステータス(PUBLISHED、UNPUBLISHED、SYSTEM_PROBLEM、IN_PROGRESSまたはALL)でのカタログ内のアイテムをカウントします。読み取り専用、安価な概要… |
walmart_marketplace_retire_item | SKUによってWalmart.comから1つのアイテムを引退(永久に削除)します。リストは削除されます;戻すには新しいアイテムの設定が必要です。返します… |
walmart_marketplace_get_inventory | デフォルトの出荷ノードまたは指定された出荷ノードで1SKUの在庫を読み取ります:sku、quantity(単位EACH、amount = 売却可能なユニット… |
walmart_marketplace_get_inventory_by_ship_node | あなたのアカウントのすべての出荷ノード(または1つのノード)で1SKUの在庫を読み取ります:skuとnodes[]にshipNode、inputQty(設定したもの… |
walmart_marketplace_update_inventory | デフォルトの出荷ノード(または指定された出荷ノード)で1SKUの在庫を絶対数量に設定します。量は現在の値を置き換えます… |
walmart_marketplace_get_wfs_inventory | Walmart Fulfillment Services(WFS)の在庫を読み取ります:headers(totalCount、limit、offset)およびpayload.inventory[]にitemInformation(sku、gtin… |
walmart_marketplace_update_price | 1SKUの通常(BASE)販売価格をUSDで設定します。ItemPriceResponseをskuとメッセージで返します。1時間あたり100回の呼び出しに制限されています… |
walmart_marketplace_get_promotional_prices | 1SKUのプロモーション価格を読み取ります:payload.itemIdentifierとpricingList.pricing[]にcurrentPriceType(BASE、REDUCED、CLEARANCE… |
walmart_marketplace_submit_item_feed | 大量アイテムフィードを提出します(最大10,000アイテムを作成または更新)をWalmartのアイテム仕様のJSONドキュメントとして、例:MP_ITEMで… |
walmart_marketplace_submit_price_feed | 大量価格フィードを提出します(feedType PRICE_AND_PROMOTION、最大10,000SKU、1,000推奨)… |
walmart_marketplace_list_feeds | 最近のフィード(または1つのフィード)をリスト:totalResultsとresults.feed[]にfeedId、feedType、feedSource、feedStatus(RECEIVED、INPROGRESS… |
walmart_marketplace_get_feed_status | 1つのフィードのステータスを読み取ります:feedStatus、itemsReceived、itemsSucceeded、itemsFailed、itemsProcessingおよび、include_detailsを含む… |
walmart_marketplace_request_report | Walmartにリクエストレポートを生成するように依頼します(ITEMカタログ、INVENTORY、BUYBOX、CANCELLATION、RETURN_OVERRIDES、ITEM_PERFORMANCE、WFS… |
walmart_marketplace_list_report_requests | 過去30日間の1種類のレポートリクエストをリスト:requests[]にrequestId、requestStatus(RECEIVED、INPROGRESS、READY、ERROR)… |
walmart_marketplace_get_report_request | 1つのレポートリクエストのステータスを読み取ります:requestId、requestStatus(RECEIVED、INPROGRESS、READY、ERROR)、reportType、reportVersion… |
walmart_marketplace_get_report_download_url | READYレポートのダウンロードリンクを取得します:downloadURL(事前署名された、圧縮CSV)、downloadURLExpirationTime、reportTypeおよび… |
walmart_marketplace_list_inbound_shipments | WFSの入荷出荷をリスト(Walmartのフルフィルメントセンターに向かうあなたの在庫):headers.totalCountとpayload[]にinboundOrderId… |
walmart_marketplace_list_inbound_shipment_items | WFSの入荷出荷のSKUをリスト:headers.totalCountとpayload[]にinboundOrderId、shipmentId、sku、gtin、itemDesc、itemQty… |
walmart_marketplace_create_inbound_shipment_label | 入荷出荷のためのWFS受取ラベルを生成します(キャリアラベルではなく:これによりフルフィルメントセンターは箱やパレットを一致させることができます… |
walmart_marketplace_list_ship_nodes | あなたのフルフィルメントセンター(出荷ノード)をリスト:shipNode(他のツールが使用するID)、shipNodeName、nodeType、status、timeZone、postalAddress… |
walmart_marketplace_list_carrier_methods | あなたの出荷設定に利用可能なキャリア方法をリスト:carrierMethodId、carrierMethodName、carrierMethodTypeおよび… |
walmart_marketplace_list_shipping_templates | あなたの出荷テンプレートをリスト:totalRecordsとshippingTemplates[]にid、name、type(DEFAULT、CUSTOM、DELIVERR)、status(ACTIVE… |
walmart_marketplace_get_lag_time | 1SKUのフルフィルメント遅延時間を読み取ります:skuとfulfillmentLagTime(注文と出荷の間の日数;2日以上はWalmartが必要です… |
例のプロンプト
- "今日出荷する必要があるリリースされたWalmartの注文はどれですか?"
- "顧客の配送先住所と行を含む購入注文1234567890123を表示してください。"
- "私の出荷ノード全体で在庫が5ユニット未満のSKUはどれですか?"
- "SKU WM-1001の価格を24.99 USDに設定してください。"
- "今日のすべてのリリースされた注文を確認し、追跡がまだないものをリストしてください。"
次のステップ
このガイドは役に立ちましたか?