Walmart Marketplace MCPをGemini CLIに接続

💡 インストール不要？cloud.anythingmcp.comに直接アクセスして使用してください。 サインインし、Connectors → Walmart Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerもgit cloneもローカルサーバーも不要です。

Walmart Marketplace + Gemini

米国の売り手向けのWalmart Marketplace API：追跡付きの注文確認と出荷、返品、アイテムおよびカタログ検索、在庫、価格、大量フィード、リクエストに基づくレポート、WFSの入荷出荷および出荷設定。クライアントIDとシークレット。

前提条件

コネクタに組み込まれた完全なセットアップ手順を参照してください（コネクタを選択するとアプリ内ストアに表示されます）。このコネクタに必要な環境変数は次のとおりです：

WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

ステップ1 — 資格情報を取得する

設定には約5分かかります。

1. https://developer.walmart.com にSeller Centerのログイン情報でサインインします（Marketplaceの売り手を選択）。
2. My Accountを開き、次にAPI Keys（キー管理）を開き、productionのクライアントIDとクライアントシークレットを作成またはコピーします。
3. クライアント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 — Geminiにコネクタを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が Walmart Marketplace のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

• "今日出荷する必要があるリリースされた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が使用する必要がある場合のみ、コネクタページでオンにしてください；変更ごとに確認を求められます。

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディングページ
• Claudeに接続する