概要
AIエージェントからSuper-Pharmマーケットプレイスでショップを運営する: 注文、承認、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはイスラエルで販売されており、Super-Pharm販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Super-Pharm Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Super-Pharm Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Super-Pharm Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインして、Connectors → Super-Pharm Marketplaceをクリックし、認証情報を貼り付けて、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Super-Pharm Marketplace
AIエージェントからSuper-Pharmマーケットプレイスでショップを運営する: 注文、承認、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはイスラエルで販売されており、Super-Pharm販売者バックオフィスからショップAPIキーでサインインします。
セットアップ
国: イスラエル。これはイスラエルのshop.super-pharm.co.ilのマーケットプレイスです; ポーランドのSuper-Pharmサイトはマーケットプレイスの販売者を受け付けていません。
販売できる人: Super-Pharmは各販売者を承認してからリストに掲載できます; 販売者は自分の在庫を保持し、イスラエルの顧客に自ら配送し、Super-Pharmは各販売に対して手数料を取ります。コネクタには、Super-Pharmがすでに開設した販売者アカウントが必要です。
セットアップには約5分かかります。
- Super-Pharm販売者バックオフィスにサインインします:
https://superpharm-prod.mirakl.net/login。 - バックオフィスでユーザー名を開き(右上)、My user settings > API keyを選択し、Generate a new keyをクリックします(または既存のキーをコピーします)。これを
SUPER_PHARM_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効化されるため、他のツールで使用している場合は動作しなくなります。 SUPER_PHARM_SHOP_IDは空のままにします。ユーザーがSuper-Pharmで複数のショップを管理している場合のみ、SUPER_PHARM_SHOP_IDをこのコネクタが動作するショップの数値IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、super_pharm_get_accountによってshop_idとして返されます)。これがない場合はデフォルトのショップが使用されます。super_pharm_get_accountをインストールして実行します: これにより、キーが属するショップが返されます。
どこから始めるか: super_pharm_get_accountはキーの背後にあるショップ(ID、名前、状態、通貨、チャネル)を表示します。日常業務には、super_pharm_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫にはsuper_pharm_list_offers、メッセージの返信を待つにはsuper_pharm_list_threadsを使用します。
製品と競合オファー: super_pharm_get_productsはEANまたは他の参照でSuper-Pharmカタログ内の製品を検索し、マーケットプレイス製品SKUを返します; super_pharm_list_product_offersは指定された製品の各ショップのオファーをリストし、最良価格を最初に表示し、約5回の呼び出しで取得します。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。super_pharm_accept_orderは各行を承認(または拒否)します; 顧客が引き落とされると、注文はSHIPPINGに移動します。その後、super_pharm_update_trackingは運送業者と追跡番号を保存し(運送業者コードはsuper_pharm_list_carriersから取得)、super_pharm_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはsuper_pharm_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します; super_pharm_resolve_incidentは問題が解決されると、1つの注文行のインシデントを閉じます。注文に添付された文書(納品書、ラベル、顧客請求書)はsuper_pharm_list_order_documentsでリストされます。
書き込み: まず確認してください。 super_pharm_accept_order、super_pharm_update_tracking、super_pharm_ship_order、super_pharm_resolve_incident、super_pharm_accept_return、super_pharm_receive_return、super_pharm_update_offers、super_pharm_reply_thread、super_pharm_create_order_thread、super_pharm_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか(注文IDと行、追跡番号、古い価格と新しい価格のオファーSKU、メッセージテキストと受取人)を表示し、はいを待ちます。注文行を拒否すると、それは永久にキャンセルされます。ここでは、ツールが返金、注文のキャンセル、またはお金の移動を行うことはありません; それはバックオフィスで行ってください。super_pharm_import_offersはオファーを削除できます(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、したがって、オフにスイッチされた状態でインストールされています。
オファーの更新(価格と在庫): super_pharm_update_offers(OF24)はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます: quantityが欠けていると0になり、discountまたはdescriptionが欠けていると削除されます。常にオファーを最初に読み取ります(super_pharm_get_offerまたはsuper_pharm_list_offersをskuで使用)し、意図した変更のみを含む完全な状態で返送します: shop_sku、product_id、product_id_type(product_referencesから)、state_code、price、quantity、leadtime_to_ship、logistic_class(そのコード)、min_quantity_alert、description、discount、all_prices、available_started / available_ended(available_start_date / available_end_dateとして読み取ります)および任意のoffer_additional_fields。update_deleteは空のままにするか、updateに設定します。呼び出しはimport_idを返します; 変更は非同期で適用されるため、再度オファーを読み取る前にsuper_pharm_get_offer_importで確認してください。state_codeの条件コードはsuper_pharm_list_offer_conditionsから取得し、物流クラスコードはsuper_pharm_list_logistic_classesから取得します。
ファイルインポート: super_pharm_import_products(P41)およびsuper_pharm_import_offers(OF01)は、Super-Pharmが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタはそれをダウンロードしてSuper-Pharmにアップロードします。super_pharm_list_product_imports / super_pharm_get_product_importおよびsuper_pharm_list_offer_imports / super_pharm_get_offer_importで追跡します。
返品: super_pharm_list_returns(RT11)は返品リクエストをリストします。Super-Pharmがショップに決定を任せる場合、super_pharm_accept_returnはWAITING_ACCEPTANCEの返品を承認または拒否し、super_pharm_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: super_pharm_list_threadsは顧客とSuper-Pharmとの会話をリストします(1つの注文についてはentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリングします; entity_typeなしのentity_idは拒否されます)、super_pharm_get_threadはそのメッセージを読み取り、super_pharm_reply_threadは(受取人CUSTOMERまたはOPERATOR、つまりSuper-Pharm)に返信し、super_pharm_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはsuper_pharm_list_reasonsから取得します; マーケットプレイスがその言語を持っていることを知っている場合を除き、localeは空のままにします(非アクティブなロケールは400で応答します)。
お金: super_pharm_list_invoices(IV01)はSuper-Pharmがショップに発行する会計文書をリストし、super_pharm_list_transactions(TL02)は取引行(販売、手数料、返金、支払い)をリストします。Super-PharmがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません; その場合はsuper_pharm_list_document_requests(DR11)と取引を使用してください。
全カタログ: すべてのオファーを読み取るには(カタログ全体の在庫または価格チェック、オファーのカウント)、super_pharm_export_offersでエクスポートを開始し、super_pharm_get_offer_export_statusを約1分ごとにポーリングしてCOMPLETEDになるまで待ち、super_pharm_get_offer_export_fileでファイルを1つずつ読み取ります; include_fieldsは必要な列のみを保持します。完全なエクスポートは1日に1回許可されます; それ以降に変更されたものについては、last_request_dateを渡します(差分エクスポート、最大1分に1回)。super_pharm_list_offersで各オファーをページングしないでください: これは一度にいくつかのオファーのために設計されており、大規模なカタログをページングすると429で応答します。
複数のショップ: 各ツールはオプションのshop_idを受け取ります。このマーケットプレイスで複数のショップを管理しているユーザー(代理店、または国ごとに1つのショップ)は、1つのインストールでそれらすべてを操作できます: 各呼び出しでショップのIDを渡し、super_pharm_get_accountでどのショップかを確認します。同じshop_idを使用します。shop_idがない場合、呼び出しはSUPER_PHARM_SHOP_IDを使用するか、ユーザーのデフォルトショップが空の場合はそれを使用します。ユーザーにショップのIDを尋ねてください; バックオフィスに表示されます。
参照リスト: super_pharm_list_channels(国サイト)、super_pharm_list_carriers、super_pharm_list_shipping_zones、super_pharm_list_shipping_methods、super_pharm_list_logistic_classesはあまり変更されないため、会話ごとに1回読み取ります。
ページネーション: 注文、オファー、請求書、製品インポートはmax(最大100)とoffsetでページングします。スレッド、返品、取引、文書リクエスト、オファーインポートはnext_page_tokenを返します; 次のページを取得するにはそれをpage_tokenとして渡します(他のすべてのフィルターは無視されます); それが欠けるまで続けます。
日付はISO 8601形式で、例: 2026-10-01T00:00:00Z; 応答はUTCで行われます。
レート制限: 各APIには独自の制限があり、Super-Pharmはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品とオファーのインポートは最大15分ごと、super_pharm_get_accountと参照リストは約1日に1回です。429はRetry-Afterヘッダーに待機する秒数を含みます; ループで再試行しないでください。
エラー: 401はキーが間違っているか、新しいものに置き換えられたことを意味し、403はユーザーにこのアクションの権限がないことを示し、404はこのショップに対して注文、オファー、またはスレッドが存在しないか、マーケットプレイスがその機能を使用していないことを示します(返品など)、400は不正なパラメータまたは間違った状態の注文を示します(メッセージがそれを示します、例: ORDER_INVALID_STATE)。
前提条件: SUPER_PHARM_API_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を開き、Super-Pharm Marketplaceを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
super_pharm_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレード、承認率、連絡先… |
super_pharm_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリングします(例: WAITING_ACCEPTANCE… |
super_pharm_list_offers | ショップのオファーをリストします(OF21):SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
super_pharm_get_offer | オファーID(OF22)によって1つのオファーを完全に読み取ります:すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
super_pharm_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新しいまたは中古のように、オファーを更新する際にstate_codeに入れるコード |
super_pharm_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからとsuper_pharm_update_offersからのステータス(WAITING、RUNNING、COMPLETE、FAILED)、行… |
super_pharm_get_offer_import | 1つのオファーインポートまたはオファー更新(OF02)のステータスをそのimport_idによって読み取ります; super_pharm_update_offersまたは… |
super_pharm_export_offers | ショップのすべてのオファーをファイルとしてエクスポートを開始します(OF52):カタログ全体を読み取る方法(すべてのSKUと価格、在庫)… |
super_pharm_get_offer_export_status | super_pharm_export_offersで開始されたオファーエクスポートのステータス(OF53):PENDING、COMPLETEDまたはFAILED(エラーコードとエラー詳細付き)… |
super_pharm_get_offer_export_file | 完了したオファーエクスポートの1つのファイルを読み取ります(OF54):SKU、製品、数量、価格、他のエクスポートされたフィールドを持つオファー… |
super_pharm_list_product_imports | ステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)を持つ製品インポートをリストします(P51):変換カウントと… |
super_pharm_get_product_import | 1つの製品インポート(P42)のステータスをそのimport_idによって読み取ります:インポートステータス、理由、変換カウント、統合詳細… |
super_pharm_get_products | その識別子(P31)によってマーケットプレイスカタログ内の製品を検索し、マーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
super_pharm_list_product_offers | 指定された製品の各ショップのオファーをリストします(P11):最良価格でソートし、競合と価格を比較します。product_idsを渡します… |
super_pharm_list_threads | 顧客とSuper-Pharmとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最終メッセージ日付、いつから… |
super_pharm_get_thread | すべてのメッセージ、送信者、受取人、添付ファイル、リンクされた注文またはオファーを持つ1つのメッセージスレッドを読み取ります(M10) |
super_pharm_list_returns | 状態、返品行、理由、RMA、追跡、リンクされた注文を持つ返品リクエストをリストします(RT11)。状態、注文または日付でフィルタリングします… |
super_pharm_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金、メッセージの理由、ラベルとショップが… |
super_pharm_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):コード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
super_pharm_list_invoices | Super-Pharmがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
super_pharm_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジット、支払い、金額、タイプ… |
super_pharm_list_document_requests | 会計文書リクエストをリストします(DR11):Super-PharmがEnhanced Seller Invoicingを実行する際に使用される請求書とクレジットノート… |
super_pharm_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書、他のファイル、ID、ファイル… |
super_pharm_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
super_pharm_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例: フランス本土またはコルシカ。変更はあまりない: 呼び出します… |
super_pharm_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例: 標準、エクスプレス、またはピックアップ、コード、ラベル、追跡番号の有無… |
super_pharm_list_logistic_classes | マーケットプレイスの物流クラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
super_pharm_accept_order | 承認待ちの注文の行を承認または拒否します(OR21)。注文の各行をリストする必要があります。行を拒否するとそれはキャンセルされます… |
super_pharm_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。super_pharm_list_carriersからcarrier_codeを渡すか、carrier_nameとcarrier_urlを使用します… |
super_pharm_ship_order | SHIPPINGの注文が発送されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
super_pharm_update_offers | オファーを作成または更新します。価格と在庫を含む(OF24)。各オファーを完全に置き換えます: 省略されたすべてのフィールドはリセットされます(欠けている… |
super_pharm_reply_thread | メッセージスレッド(M12)で顧客またはSuper-Pharmに返信します。メッセージは即座に配信され、取り消すことはできません: ユーザーに… |
super_pharm_create_order_thread | 注文に関する新しいメッセージスレッドを顧客、Super-Pharm、または両方で開始します(OR43)。メッセージは即座に配信されます: ユーザーに… |
super_pharm_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決されたとき。reason_codeはINCIDENT_CLOSEである必要があります… |
super_pharm_accept_return | WAITING_ACCEPTANCEの返品リクエストを承認または拒否します(RT21)。Super-Pharmが販売者バックオフィスで返品を処理し、… |
super_pharm_receive_return | 承認された返品の商品の到着を倉庫で確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
super_pharm_import_products | マーケットプレイスに製品ファイルを送信します(P41); カタログ内の製品を作成または強化します。file_urlはCSV、XLSX、またはXMLのアドレスです… |
super_pharm_import_offers | オファーファイルをインポートします(OF01); オファーを一括で作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "私の承認を待っているSuper-Pharmの注文はどれで、ILSでの価値はどれくらいですか?"
- "私のビタミンDドロップSKU SP-VITD-30の価格を49.90 ILSに設定し、在庫を保持してください。"
- "SHIPPING中の注文でまだ追跡番号がないものはどれですか?"
- "私のSuper-Pharmの注文に関するオープンインシデントを表示してください。"
- "先月の取引を表示してください: 販売、手数料、支払い。"
次のステップ
このガイドは役に立ちましたか?