概要
米国の売り手向けのWalmart Marketplace API:追跡付きの注文確認と出荷、返品、アイテムおよびカタログ検索、在庫、価格、大量フィード、リクエストに基づくレポート、WFSの入荷出荷および出荷設定。クライアントIDとシークレット。
ガイド付きセットアップ
Walmart Marketplace を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Walmart Marketplace を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Walmart Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして使用してください。 サインインし、Connectors → Walmart Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Walmart Marketplace + Cursor
米国の売り手向けのWalmart Marketplace API:追跡付きの注文確認と出荷、返品、アイテムおよびカタログ検索、在庫、価格、大量フィード、リクエストに基づくレポート、WFSの入荷出荷および出荷設定。クライアントIDとシークレット。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
WALMART_CLIENT_ID, WALMART_CLIENT_SECRET
ステップ1 — 資格情報を取得する
設定には約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(UNPUBLISHEDアイテムなどのフィルター付きのカタログ)および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時間および1日あたり制限があるからです(1時間あたり10件、すべての価格およびプロモーションフィードで共有)。結果はwalmart_marketplace_list_feedsとwalmart_marketplace_get_feed_status(include_details付きのアイテムエラー)で確認します。
レポート: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は通常、トークンまたはヘッダーの問題を意味します。
ステップ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 — Cursorにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう — エージェントが
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 | デフォルトの出荷ノードまたは指定された出荷ノードで1つのSKUの在庫を読み取ります:sku、quantity(単位EACH、amount = 販売可能なユニット数)… |
walmart_marketplace_get_inventory_by_ship_node | アカウントのすべての出荷ノード(または1つのノード)で1つのSKUの在庫を読み取ります:skuとnodes[]にshipNode、inputQty(設定したもの)… |
walmart_marketplace_update_inventory | デフォルトの出荷ノード(または指定された出荷ノード)で1つのSKUの在庫を絶対数量に設定します。量は現在の値を置き換えます… |
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,000 SKU、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に設定してください。"
- "今日のすべてのリリースされた注文を確認し、まだ追跡が欠けているものをリスト表示してください。"
よくある質問
どのWalmartマーケットプレイスをカバーしていますか? 米国のWalmart Marketplace(marketplace.walmartapis.com)。Walmart Canada、Mexico、Chileには別のAPIがあり、カバーされていません。
ソリューションプロバイダーアプリやDelegated Accessが必要ですか? いいえ。Walmart Developer Portalで売り手のログイン情報を使用して自分のクライアントIDとシークレットを作成します。Walmartは新しいDelegated Accessキーを発行しなくなりました。
注文をキャンセルしたり、返金を発行したりできますか? ツールは存在しますが、オフに設定されています:walmart_marketplace_cancel_order_line、walmart_marketplace_refund_order_lines、およびwalmart_marketplace_refund_return。AIが使用する必要がある場合のみ、コネクタページでオンにしてください;変更ごとに確認を求められます。
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?