概要
販売者向けのSpartooマーケットプレイスウェブサービス: 顧客および配送の詳細を含む注文、追跡番号付きの注文の受け入れと配送、返品、サイト上の商品の状態、サイズごとの在庫更新。パートナーコードをフォームフィールドとして、XMLの回答をJSONとして読み取ります。
ガイド付きセットアップ
Spartoo Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Spartoo Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Spartoo Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Spartoo Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Spartooマーケットプレイス
販売者向けのSpartooマーケットプレイスウェブサービス: 顧客および配送の詳細を含む注文、追跡番号付きの注文の受け入れと配送、返品、サイト上の商品の状態、サイズごとの在庫更新。パートナーコードをフォームフィールドとして、XMLの回答をJSONとして読み取ります。
セットアップ
セットアップには約3分かかります。
- Spartooマーケットプレイスのバックオフィスにサインインし、Documentationを開き、次にWebservicesと任意のサービスページ(例: Exporting orders)を開きます。
- Webservice URLの行には、あなたのSpartooサイトのウェブサービスアドレスが表示されます(例:
https://sws.spartoo.euまたはhttps://sws.spartoo.it)。/mp/の前の部分をSPARTOO_HOSTに入れます。 - 同じページの
partnerの行には、サインインしているときのあなたのユニークコードが表示されます。それをSPARTOO_PARTNER_KEYに入れます。ページにコードが表示されない場合は、Spartooマーケットプレイスの担当者にアカウントのウェブサービスコードを尋ねてください。
開始する場所: spartoo_list_ordersと開始日。spartoo_get_orderはIDで1つの注文を読み取ります。
注文: 注文はステータス11(確認済み)で到着します。spartoo_accept_orderはそれを2(準備中)に移動させます。その後、名前、住所、運送業者は変更できなくなります。spartoo_ship_orderはそれを2から3(出荷済み)に移動させ、運送業者の追跡番号を付け、Spartooが顧客に追跡リンクをメールします。spartoo_cancel_order(ステータス41)はオフに設定されています: 顧客は返金され、元に戻すことはできません。ステータス45(荷物紛失)および47(荷物未配達)はSpartooによって設定されます。
返品: spartoo_list_returnsおよびspartoo_get_return。1つの返品は1つの製品を保持します。返品ステータス: 2 受領待ち、3 拒否、4 荷物受領および返品受理、5 支払い済み、7 返金、14 商人の前払い返品ラベル待ち。このコネクタは返品を受け入れたり拒否したりしません。
製品と在庫: spartoo_check_product_statusは、製品がサイトにあるかどうかを示します(OK)、在庫切れ(OS)、作成されたがまだオンラインでない(EC)、または不明(KO)で、その理由を示します。spartoo_update_stockは1つのサイズの在庫を設定します。両方ともあなた自身の参照を使用します: reference_partenaireは1色の製品、size_referenceはその1サイズです。在庫0はそのサイズをサイトから削除します。
フィールドノート
- 注文IDと返品IDは、
90D813EA1A2365A8のような短いコードです。 - 注文日フィルターは
YYYY-MM-DD:hh:mm:ssの形式で、日と時間の間にコロンがあります。返品日フィルターはUnixタイムスタンプ(秒単位)です。Spartooはタイムゾーンを文書化していません。 - 価格は注文のサイトの通貨での小数点数です;
products_final_priceは割引後の単価に数量を掛けたものです。 - ピックアップポイントの注文には、配送先住所の代わりに
relay_infoがあります。 - テキスト値は文字列として到着し、数値も含まれます。リスト内の1つの注文または製品はオブジェクトとして到着し、複数は配列として到着します。
エラー: すべての回答にはコードが含まれています。1はエラーなしを意味します。-1および-2: パートナーコードが欠落または不明です。-3: 日付またはIDが欠落しています。-4: 日付形式が間違っています。-6および-28: 注文または返品が見つかりません。-8: 追跡番号が拒否されました。-9: 注文はすでにそのステータスを持っています。-19: ステータスの順序が間違っています(2は11からのみ、3は2からのみ)。-14: 製品が見つかりません。-16、-18および-20: 在庫が変更されませんでした(不可能、すでにその値、またはサイズが無効です)。-30: 注文が古すぎて出荷できません、Spartooに連絡してください。-428: アカウントが無効化されました。-429: 1時間にリクエストが多すぎます。このコネクタは、失敗した呼び出しとして負のコードを報告します。
カバーされていないもの: 製品の作成および編集、価格および割引(これらはXMLカタログファイルを通じて行われます)、梱包伝票、および返品の決定。
前提条件: SPARTOO_HOST, SPARTOO_PARTNER_KEY
コネクタをローカルにインストールする
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を開き、Spartoo Marketplaceを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
spartoo_list_orders | 指定した日以降に行われた注文をリスト表示し、オプションで1つのステータスのものだけを表示します。各注文の下にroot.orders.order: orders_id, customers… |
spartoo_get_order | IDで1つの注文を読み取ります: 顧客および配送の詳細(またはrelay_infoのピックアップポイント)、支払い方法、配送名と価格、注文… |
spartoo_accept_order | 新しい注文を受け入れます: ステータス11(確認済み)から2(準備中)に移動します。その後、注文の名前、配送先住所、運送業者は… |
spartoo_ship_order | 受け入れた注文を運送業者の追跡番号で出荷済みとしてマークします: ステータス2から3に移動し、Spartooが追跡リンクを顧客にメールします… |
spartoo_cancel_order | 出荷されていない注文をキャンセルします(ステータス41)。顧客は注文を受け取らず、Spartooによって返金されます; 元に戻すことはできません… |
spartoo_list_returns | 一定の時点以降に登録された返品をリスト表示し、オプションで1つのステータスのものだけを表示します。各返品の下にroot.returns.return: return_id… |
spartoo_get_return | 1つの注文の返品を読み取るか、IDで1つの返品を読み取ります: 返品IDと日付、ステータスIDと名前、理由、注文IDおよび返品された製品… |
spartoo_check_product_status | あなたの製品の1つがSpartooサイトにあるかどうかを確認します。root.products.productの下にあなたの参照、ステータス(サイト上でのOK… |
spartoo_update_stock | 1つの製品の1サイズの在庫をリアルタイムで設定します。在庫0はそのサイズをサイトから削除します; すべてのサイズが0の製品はオフラインになります… |
例のプロンプト
- "月曜日以降に入ったSpartooの注文で、まだ受け入れられていないものはどれですか?"
- "注文90D813EA1A2365A8を受け入れ、Royal Mailの追跡AB123456789GBで出荷します。"
- "受領待ちの返品はどれですか?"
- "私の製品REF-BOOT-221はオンラインですか?もしそうでないなら、なぜですか?"
- "REF-BOOT-221のサイズ38の在庫を6に設定します。"
次のステップ
このガイドは役に立ちましたか?