概要
ギリシャおよびキプロスのマーケットプレイス向けのSkroutz Marketplace (Smart Cart) API:注文の読み取り、受け入れ、スケジュール設定、準備完了の設定、追跡、請求書のアップロード、返品、Skroutz在庫による履行、発注書とサプライヤー、大量の価格と在庫の更新、CPS注文。マーチャントパネルからのAPIトークン。
ガイド付きセットアップ
Skroutz を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Skroutz を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Skroutz のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして使用してください。 サインインし、Connectors → Skroutzをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Skroutz + Gemini
ギリシャおよびキプロスのマーケットプレイス向けのSkroutz Marketplace (Smart Cart) API:注文の読み取り、受け入れ、スケジュール設定、準備完了の設定、追跡、請求書のアップロード、返品、Skroutz在庫による履行、発注書とサプライヤー、大量の価格と在庫の更新、CPS注文。マーチャントパネルからのAPIトークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
SKROUTZ_API_TOKEN
ステップ 1 — 認証情報を取得する
設定には約3分かかります。
- Skroutzマーチャントパネルにサインインし、Services, Skroutz Marketplace(Smart Cart設定ページ)を開きます。
- APIトークンを生成し、それを
SKROUTZ_API_TOKENに貼り付けます。ショップには1つのアクティブなトークンがあります:新しいトークンを生成すると、以前のトークンは無効になりますので、他の統合で使用されているトークンはそこで機能しなくなります。 - オプションとして、大量の価格と在庫の更新のために、Products, Feed UpdatesでProducts APIトークンを生成し、それを
SKROUTZ_PRODUCTS_TOKENに貼り付けます。 - オプションとして、自分のウェブショップのCPS注文のために、Παραγγελίες καταστήματος, Αυτόματη διαχείριση(ショップ注文、自動処理)でCPSトークンを生成し、それを
SKROUTZ_CPS_TOKENに貼り付けます。
すべての呼び出しは、トークンをAuthorization: Bearerとして送信し、メディアタイプはapplication/vnd.skroutz+json; version=3.0です。インストールチェックはデモ注文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を使って読み取り、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を受け取ります。
Products 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で応答します。コネクタは決してお金を移動しません:拒否、返品決定、補償請求、発注書、大量製品更新は、管理者が意図的にオンにするためにオフに設定されています。
ステップ 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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
Skroutzのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 何をするか |
|---|---|
skroutz_get_order | コードによって1つのSkroutz Marketplace (Smart Cart) 注文を読み取ります:状態(オープン、受け入れ、拒否、キャンセル、期限切れ、発送済み、配達済み… |
skroutz_accept_order | オープン注文を受け入れます:その後、Skroutzが宅配業者を手配し、バウチャーを発行します(それは注文にcourier_voucherとして到着します)。送信… |
skroutz_reject_order | オープン注文を拒否します。理由IDを持つ行アイテムごとに拒否することができます(理由にavailable_quantityがある場合… |
skroutz_reschedule_order_pickup | 受け入れた注文の宅配業者のピックアップを別の日に移動します。action_optionsを使って注文を読み取り、その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状態の返品を決定します。処理オプションの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が手数料を請求しないようにします。拒否オプションの1つを使用します(user_cancel、user_return、undelivered… |
例のプロンプト
- "注文251114-3920517をそのアイテム、ピックアップオプション、期限と共に表示してください。"
- "注文251114-3920517を私のアテネ倉庫の最初のピックアップウィンドウで受け入れます。"
- "注文251112-1187340は準備完了の設定が必要です:マークする準備はできていますか、ピックアップはいつですか?"
- "返品R-251110-2045318は何と言っており、いつまでにレビューする必要がありますか?"
- "Skroutz倉庫に各製品のユニットは何個ありますか?"
FAQ
トークンはどこから来ますか? Skroutzマーチャントパネルからで、3つの別々のトークンがあります:サービスの下のマーケットプレイスAPIトークン、Skroutz Marketplace(注文、返品、Skroutzによる履行)、オプションのProducts APIトークン(大量の価格と在庫の更新用)、および自分のウェブショップの注文用のオプションのCPSトークンです。新しいマーケットプレイストークンを生成すると、古いトークンは無効になります。
私の注文をリストできますか? いいえ。Skroutz APIには注文リストがありません:注文はWebhook、マーチャントパネル、注文メールを通じてショップに届きます。AIに注文コード(251114-3920517のような)を与え、それを読み取ります。DEMO-OPENのようなデモコードはテストに安全です。
どのツールがオフに設定されていますか? skroutz_reject_orderとskroutz_reject_cps_order、拒否は元に戻せないため、返品ツールskroutz_handle_return、skroutz_submit_service_inspection、skroutz_file_compensation_request、skroutz_create_fbs_purchase_order(倉庫手数料が発生するため)、およびskroutz_update_productsです。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?