概要
ギリシャとキプロスのマーケットプレイス向けのSkroutz Marketplace (Smart Cart) API: 注文の読み取り、受け入れ、スケジュール設定、準備完了の設定、追跡、請求書のアップロード、返品、Skroutzによる履行在庫、発注書とサプライヤー、大量の価格と在庫の更新、CPS注文。マーチャントパネルからのAPIトークン。
ガイド付きセットアップ
Skroutz を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Skroutz を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Skroutz のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Skroutzをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Skroutz
ギリシャとキプロスのマーケットプレイス向けのSkroutz Marketplace (Smart Cart) API: 注文の読み取り、受け入れ、スケジュール設定、準備完了の設定、追跡、請求書のアップロード、返品、Skroutzによる履行在庫、発注書とサプライヤー、大量の価格と在庫の更新、CPS注文。マーチャントパネルからのAPIトークン。
セットアップ
セットアップには約3分かかります。
- Skroutzマーチャントパネルにサインインし、サービス、Skroutz Marketplace(Smart Cart設定ページ)を開きます。
- APIトークンを生成し、
SKROUTZ_API_TOKENに貼り付けます。ショップには1つのアクティブトークンがあります:新しいトークンを生成すると、以前のトークンは無効になりますので、他の統合で使用されているトークンはそこで機能しなくなります。 - オプションとして、大量の価格と在庫の更新のために、製品、フィード更新で製品APIトークンを生成し、
SKROUTZ_PRODUCTS_TOKENに貼り付けます。 - オプションとして、自分のウェブショップのCPS注文のために、Παραγγελίες καταστήματος, Αυτόματη διαχείριση(ショップ注文、自動処理)でCPSトークンを生成し、
SKROUTZ_CPS_TOKENに貼り付けます。
すべての呼び出しは、メディアタイプapplication/vnd.skroutz+json; version=3.0でAuthorization: Bearerとしてトークンを送信します。インストールチェックはデモ注文DEMO-OPENを読み取り、実際のデータに触れることなくマーケットプレイストークンを確認します。
どこから始めるか: APIには注文リストがありません。注文は注文Webhook、マーチャントパネル、注文メールを通じてショップに届くため、ユーザーに注文コード(191128-1234567のような)を尋ね、skroutz_get_orderで読み取ります。デモコードDEMO-OPEN、DEMO-ACCEPTED、DEMO-REJECTED、DEMO-INVOICE、DEMO-FBS、DEMO-STORE-PICKUP、DEMO-RETURNはテスト用に安全に読み取り、受け入れ、拒否できます:何も保存されません。
注文: オープン注文にはaccept_optionsとreject_optionsがあり、expires_atの前に処理する必要があります。skroutz_accept_orderで受け入れ、ピックアップ場所のIDとその場所のピックアップウィンドウの1つのIDを送信します(ウィンドウは場所ごとに異なります)。その後、Skroutzが宅配便を手配し、バウチャーPDFがcourier_voucherに表示されます。エクスプレス注文はSkroutzによって自動的に受け入れられます。skroutz_reject_orderはオフに設定されています:拒否は元に戻せず、ショップに対してカウントされます。受け入れた注文のピックアップを変更するには、action_optionsを使って1つ読み取り、skroutz_reschedule_order_pickup(reschedule_optionsからの日付)またはskroutz_relocate_order_pickup(relocate_optionsからのID)を使用します;リストは時間とともに縮小します。skroutz_request_preorder_voucherは受け入れたプレオーダーのバウチャーを早期に作成します。
準備完了の設定: 注文がset_as_ready_requiredがtrueを示す場合、Skroutz Last Mileはskroutz_set_order_readyの後にのみピックアップします;バウチャーをダウンロードすることはもはや準備完了を示しません(2026年3月30日以降)。早期にマークすると、ピックアップを早いウィンドウに移動できます。skroutz_set_order_not_readyはピックアップ前に元に戻します。set_as_ready_requiredがfalseのショップは必要ありません。
配送と書類: skroutz_update_tracking_detailsは、Fulfilled by Merchant (FBM)注文の宅配便と追跡コードを送信します。skroutz_upload_invoiceとskroutz_upload_credit_invoiceは、PDF、PNG、またはJPGへの公開リンクを受け取ります(最大7MB);コネクタはそれをダウンロードし、ファイルをアップロードします。1注文につき1ファイルで、以前のアップロードを置き換えます。
返品: skroutz_get_returnは、そのコード(R-111111-1111111のように、返品Webhookまたはマーチャントパネルから)で返品を読み取ります;注文のreturnsはUUIDと追跡IDのみを提供します。skroutz_handle_return(review.expires_atの前にレビュー待ちの返品を決定し、ショップの費用で欠品を送信することを含む)とskroutz_submit_service_inspection(不良品の技術レポート、ファイルリンクとして)はオフに設定されています。なぜなら、これらは返金、交換、または有料配送につながるからです。skroutz_file_compensation_requestもオフです:返品されたアイテムに対してSkroutzから補償を請求しますが、このコネクタを通じては写真を必要としない理由のみです。
Skroutzによる履行: skroutz_list_fbs_products(Skroutz倉庫の在庫)、skroutz_list_fbs_purchase_orders、skroutz_list_fbs_purchase_order_items、skroutz_list_fbs_suppliers、skroutz_create_fbs_supplier、skroutz_update_fbs_supplier。skroutz_create_fbs_purchase_orderはオフに設定されています。なぜなら、倉庫手数料がそれに従うからです。リストはpageでページ分けされ、meta.pagination(1ページあたり100行)を伴います。FBSのないショップはここで401を受け取ります。
製品API(SKROUTZ_PRODUCTS_TOKENが必要): skroutz_validate_product_updatesは、何も変更せずにバッチをチェックします;skroutz_update_products(オフに設定されています)は、最大500の既存製品とそのバリエーションの可用性、価格、数量を非同期で更新します;skroutz_get_product_update_statusは、製品ごとの成功、変更なし、または失敗を報告します。ここでの価格は整数ユーロセント(1050は10.50 EUR)であり、注文金額は小数ユーロです。製品を作成することはありません:それらはXMLフィードから来ます。XMLがスキャン中であることを示す422は、後で再試行することを意味します。
CPS注文(SKROUTZ_CPS_TOKENが必要): skroutz_get_cps_orderは、自分の注文番号で自分のウェブショップの販売を読み取り、収益と手数料を取得します;skroutz_reject_cps_order(オフに設定されています)は、手数料が請求されないようにそれを拒否します。
フィールドノート: 時間はISO 8601で、アテネのオフセット(冬は+02:00、夏は+03:00)です。ピックアップウィンドウ、拒否理由、CPS状態などのラベルはギリシャ語で提供されます。ラインアイテムIDは短い文字列(l39vKqxqwe)です;shop_uidは自分の製品IDです。エラーはerrors配列を持ち、codeとmessagesを含みます:422 order_statusは、そのアクションに対して注文がその状態にないことを意味します。間違ったまたは置き換えられたマーケットプレイストークンは403で応答します。コネクタは決してお金を移動しません:拒否、返品決定、補償請求、発注書、大量製品更新は、管理者が意図的にオンにするためにオフに設定されています。
前提条件: SKROUTZ_API_TOKEN
コネクタをローカルにインストールする
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を開き、Skroutzを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
skroutz_get_order | コードによって1つのSkroutz Marketplace (Smart Cart)注文を読み取ります:状態(オープン、受け入れ、拒否、キャンセル、期限切れ、発送済み、配達済み… |
skroutz_accept_order | オープン注文を受け入れます:その後、Skroutzが宅配便を手配し、バウチャーを発行します(それは注文にcourier_voucherとして到着します)。送信… |
skroutz_reject_order | 理由IDを持つreject_optionsからの行アイテムごとにオープン注文を拒否します(理由がある場合はavailable_quantityとともに… |
skroutz_reschedule_order_pickup | 受け入れた注文の宅配便ピックアップを別の日に移動します。アクションオプション1を使って注文を読み取り、その… |
skroutz_relocate_order_pickup | 受け入れた注文の宅配便ピックアップをショップの別のピックアップ場所に移動し、ピックアップ日とスロットを保持します。宅配便は… |
skroutz_set_order_ready | 受け入れた注文を梱包済みで発送準備完了としてマークします(準備完了の設定)。set_as_ready_requiredがtrueのショップに必要です… |
skroutz_set_order_not_ready | 宅配便がまだピックアップしていない受け入れた注文の準備完了を元に戻します。Skroutzはピックアップを元の日付に戻そうとします… |
skroutz_update_tracking_details | Fulfilled by Merchant (FBM)注文の各出荷の宅配便と追跡コードを送信し、顧客がそれを追跡できるようにします。FBMのみに対応… |
skroutz_request_preorder_voucher | 計画された出荷日より前に製品が到着した場合、受け入れたプレオーダーの宅配便バウチャーを今すぐ要求します(パネルの作成… |
skroutz_upload_invoice | 注文の領収書または請求書をファイルへのリンクからアップロードします(PDF、PNG、またはJPG、最大7MB)。1注文につき1ファイル:新しいアップロード… |
skroutz_upload_credit_invoice | キャンセル、返品、部分的に返品された、または受領後に送り返された注文のクレジット請求書をアップロードします… |
skroutz_file_compensation_request | 返品された行アイテムに対してショップに補償を請求します。写真なしでJSONとして送信されるため、写真を必要としない理由のみ… |
skroutz_get_return | コードによって1つの返品を読み取ります:状態(pending_merchant_review、returning、pending_physical_review、pending_service_inspection、returned… |
skroutz_handle_return | pending_merchant_reviewの状態の返品を決定します。handle_optionsの1つを使用します:承認、not_faultyのような拒否(コメントがある場合… |
skroutz_submit_service_inspection | 不良品の返品の技術検査結果を提出します(pending_service_inspectionの状態の返品):アイテムID、1つの… |
skroutz_list_fbs_products | Skroutz倉庫に保存されているショップのFulfilled by Skroutz (FBS)製品をリストします:ID、shop_uid(あなたの製品ID)、アクティブ(購入可能… |
skroutz_list_fbs_purchase_orders | Skroutz倉庫に送信されたショップのFulfilled by Skroutz購入注文をリストします:コード、created_at、expected_date、received_at… |
skroutz_list_fbs_purchase_order_items | 1つのFulfilled by Skroutz購入注文の行アイテムをリストします:product_id、shop_uid、active、expected_quantity、actual_quantity… |
skroutz_create_fbs_purchase_order | 新しいFulfilled by Skroutz購入注文を発表します:Skroutz倉庫に納品する在庫、期待される日付、サプライヤー… |
skroutz_list_fbs_suppliers | ショップのFulfilled by Skroutzサプライヤーをリストします:ID(発注書に使用)、コード、名前、住所、都市、地域、郵便番号、電話… |
skroutz_create_fbs_supplier | Fulfilled by Skroutzサプライヤーを追加します(あなたのためにSkroutz倉庫に在庫を出荷する)ユニークなコード、名前、住所、都市、地域、郵便番号… |
skroutz_update_fbs_supplier | Fulfilled by Skroutzサプライヤーのフィールドを変更します;送信したフィールドのみが変更されます。success: trueで応答します |
skroutz_validate_product_updates | 何も変更せずに製品更新のバッチ(可用性、価格(セント)、数量、バリエーション)をチェックします:Skroutzはすべてのチェックを実行します… |
skroutz_update_products | 最大500の既存製品とそのバリエーションの可用性、価格(ユーロセント)、数量を1つのバッチで更新します;製品を作成することはありません… |
skroutz_get_product_update_status | 製品バッチ更新の結果を読み取ります:ステータス(進行中は任意の製品が保留中、次に完了)、created_at、製品ごとの… |
skroutz_get_cps_order | 自分のウェブショップのCPS注文(Skroutzから来た販売、手数料で支払われた)を、ショップが与えた注文コードで読み取ります:日付… |
skroutz_reject_cps_order | CPS注文を拒否し、Skroutzが手数料を請求しないようにします。reject_optionsの1つを使用します(user_cancel、user_return、undelivered… |
例のプロンプト
- "注文251114-3920517をそのアイテム、ピックアップオプション、期限とともに表示してください。"
- "注文251114-3920517をアテネの倉庫の最初のピックアップウィンドウで受け入れます。"
- "注文251112-1187340は準備完了の設定が必要です:マークする準備はできていますか、ピックアップはいつですか?"
- "返品R-251110-2045318は何と言っていますか、いつまでにレビューする必要がありますか?"
- "Skroutz倉庫に各製品のユニットはいくつありますか?"
次のステップ
このガイドは役に立ちましたか?