概要
AIエージェントからRomanマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはイギリスで販売されており、Roman販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Roman Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Roman Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Roman Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Roman Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Roman Marketplace
AIエージェントからRomanマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはイギリスで販売されており、Roman販売者バックオフィスからショップAPIキーでサインインします。
セットアップ
国: イギリス。マーケットプレイスの販売者からの製品は、北アイルランド、チャンネル諸島、マン島を含むイギリスの住所にのみ配送されます。
誰が販売できるか: Romanは、販売者ページの問い合わせフォームを通じて販売者を選定します。このフォームでは、ビジネスがイギリスから注文を発送するかどうかなどが尋ねられます。このコネクタには、Romanがすでに開設した販売者アカウントが必要です。
セットアップには約5分かかります。
- Roman販売者バックオフィスにサインインします:
https://romanoriginalsuk-prod.mirakl.net/login。 - バックオフィスでユーザー名を開き(右上)、マイユーザー設定 > APIキーを選択し、新しいキーを生成をクリックします(または既存のキーをコピーします)。それを
ROMAN_ORIGINALS_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になり、他のツールはそれを使用できなくなります。 ROMAN_ORIGINALS_SHOP_IDは空のままにします。ユーザーがRomanで複数のショップを管理している場合のみ、コネクタが機能するショップの数値IDをROMAN_ORIGINALS_SHOP_IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの横に表示され、roman_originals_get_accountによってshop_idとして返されます)。これがない場合、デフォルトのショップが使用されます。roman_originals_get_accountをインストールして実行します: それはキーに属するショップを返します。
どこから始めるか: roman_originals_get_accountはキーの背後にあるショップ(ID、名前、状態、通貨、チャネル)を表示します。日常業務には、roman_originals_list_ordersを使用してorder_state_codes=WAITING_ACCEPTANCEの注文を、roman_originals_list_offersを使用して価格と在庫を、roman_originals_list_threadsを使用して返信を待っているメッセージを確認します。
製品と競合オファー: roman_originals_get_productsは、EANまたは他の参照によってRomanカタログで製品を検索し、マーケットプレイス製品SKUを返します; roman_originals_list_product_offersは、指定された製品のすべてのショップのオファーをリストし、最良の価格を最初に表示します(約5回の呼び出し/分)。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。roman_originals_accept_orderは各行を受け入れ(または拒否します);顧客が請求された後、注文はSHIPPINGに移動します。その後、roman_originals_update_trackingは運送業者と追跡番号を保存し(運送業者コードはroman_originals_list_carriersから取得)、roman_originals_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはroman_originals_list_ordersを使用してorder_state_codes=WAITING_ACCEPTANCEを、オープンインシデントにはhas_incident=trueを使用します;roman_originals_resolve_incidentは、問題が解決された後に1つの注文行のインシデントを閉じます。注文に添付された文書(納品書、ラベル、顧客請求書)はroman_originals_list_order_documentsによってリストされます。
書き込み: 最初に確認してください。 roman_originals_accept_order、roman_originals_update_tracking、roman_originals_ship_order、roman_originals_resolve_incident、roman_originals_accept_return、roman_originals_receive_return、roman_originals_update_offers、roman_originals_reply_thread、roman_originals_create_order_thread、roman_originals_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか(注文IDと行、追跡番号、古い価格と新しい価格または在庫のオファーSKU、メッセージテキストと受取人)を表示し、はいを待ちます。注文行を拒否すると、それは完全にキャンセルされます。ここではどのツールも返金、注文のキャンセル、またはお金の移動を行いません;それはバックオフィスで行ってください。roman_originals_import_offersはオファーを削除できます(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、そのため、オフに切り替えられた状態でインストールされます。
オファーの更新(価格と在庫): roman_originals_update_offers(OF24)はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます:省略されたquantityは0になり、discountやdescriptionが省略されると削除されます。常に最初にオファーを読み取ります(roman_originals_get_offerまたはroman_originals_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を返します;変更は非同期で適用されるため、再度オファーを読み取る前にroman_originals_get_offer_importで確認してください。state_codeの条件コードはroman_originals_list_offer_conditionsから、ロジスティッククラスコードはroman_originals_list_logistic_classesから取得します。
ファイルインポート: roman_originals_import_products(P41)とroman_originals_import_offers(OF01)は、Romanが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取ります;コネクタはそれをダウンロードし、Romanにアップロードします。それらをroman_originals_list_product_imports / roman_originals_get_product_importおよびroman_originals_list_offer_imports / roman_originals_get_offer_importで追跡します。
返品: roman_originals_list_returns(RT11)は返品リクエストをリストします。Romanがショップに決定を任せる場合、roman_originals_accept_returnはWAITING_ACCEPTANCEで1つを受け入れるか拒否し、roman_originals_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: roman_originals_list_threadsは顧客とRomanとの会話をリストします(1つの注文についてはentity_type=MMP_ORDERとentity_id=<order id>でフィルタリングします;entity_typeなしのentity_idは拒否されます)、roman_originals_get_threadはそのメッセージを読み取り、roman_originals_reply_threadは回答します(受取人はCUSTOMERまたはOPERATOR、つまりRomanです)およびroman_originals_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはroman_originals_list_reasonsから取得します;マーケットプレイスがその言語を持っていることがわからない限り、そのlocaleは空のままにします(非アクティブなロケールは400を返します)。
お金: roman_originals_list_invoices(IV01)はRomanがショップに発行する会計文書をリストし、roman_originals_list_transactions(TL02)は取引行(売上、手数料、返金、支払い)をリストします。RomanがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません;その場合はroman_originals_list_document_requests(DR11)を使用し、その後取引を確認します。
全カタログ: すべてのオファーを読み取るには(カタログ全体の在庫または価格チェック、オファーをカウント)、roman_originals_export_offersでエクスポートを開始し、roman_originals_get_offer_export_statusを約1分ごとにポーリングしてCOMPLETEDになるまで待ち、roman_originals_get_offer_export_fileでファイルを1つずつ読み取ります;include_fieldsは必要な列のみを保持します。完全なエクスポートは1日に1回許可されます;それ以降に変更されたものについては、last_request_dateを渡します(差分エクスポート、最大1分ごと)。roman_originals_list_offersで各オファーをページングしないでください:これは一度に数件のオファー用に設計されており、大規模なカタログをページングすると429を返します。
複数のショップ: すべてのツールはオプションのshop_idを受け取ります。このマーケットプレイスで複数のショップを管理しているユーザー(代理店や国ごとの1ショップ)は、1つのインストールでそれらすべてを操作できます:各呼び出しでショップのIDを渡し、roman_originals_get_accountと同じshop_idでどのショップかを確認します。shop_idがない場合、呼び出しはROMAN_ORIGINALS_SHOP_IDを使用するか、空の場合はユーザーのデフォルトショップを使用します。ユーザーにショップのIDを尋ねてください;バックオフィスに表示されます。
参照リスト: roman_originals_list_channels(国サイト)、roman_originals_list_carriers、roman_originals_list_shipping_zones、roman_originals_list_shipping_methodsおよびroman_originals_list_logistic_classesはあまり変更されません;会話ごとに1回読み取ります。
ページネーション: 注文、オファー、請求書および製品インポートはmax(最大100)とoffsetでページングします。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します;それをpage_tokenとして渡して次のページを取得します(他のすべてのフィルターはその後無視されます)まで、トークンがなくなるまで続けます。
日付はISO 8601形式、例: 2026-10-01T00:00:00Z;回答はUTCで行われます。
レート制限: 各APIには独自の制限があり、Romanはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品とオファーのインポートは最大15分ごと、roman_originals_get_accountと参照リストは約1日に1回です。429はRetry-Afterヘッダーに待機する秒数を含みます;ループで再試行しないでください。
エラー: 401はキーが間違っているか、新しいものに置き換えられたことを意味し、403はユーザーがこのアクションの権限を持っていないことを示し、404はそのショップに対して注文、オファー、またはスレッドが存在しないか、マーケットプレイスがその機能(返品など)を使用していないことを示します。400は不正なパラメーターまたは注文が不正な状態にあることを示します(メッセージがそれを名指しします、例: ORDER_INVALID_STATE)。
前提条件: ROMAN_ORIGINALS_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を開き、Roman Marketplaceを選択し、前提条件の下にリストされた環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
roman_originals_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレード、承認率、連絡先… |
roman_originals_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリングします(例: WAITING_ACCEPTANCE… |
roman_originals_list_offers | ショップのオファーをリストします(OF21):SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
roman_originals_get_offer | オファーIDによって1つのオファーを完全に読み取ります(OF22):すべての価格フィールド、割引、数量、状態、ロジスティッククラス、リードタイム、カスタム… |
roman_originals_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新規または中古など、オファーを更新する際にstate_codeに入れるコード |
roman_originals_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからおよびroman_originals_update_offersから:ステータス(WAITING、RUNNING、COMPLETE、FAILED)… |
roman_originals_get_offer_import | 1つのオファーインポートまたはオファー更新のステータスを読み取ります(OF02):roman_originals_update_offersまたは…によって返されたimport_idによって |
roman_originals_export_offers | ショップのすべてのオファーをファイルとしてエクスポートを開始します(OF52):カタログ全体を読み取る方法(すべてのSKUと価格と在庫)… |
roman_originals_get_offer_export_status | roman_originals_export_offersで開始されたオファーエクスポートのステータス(OF53):PENDING、COMPLETEDまたはFAILED(エラーコードと… |
roman_originals_get_offer_export_file | 完了したオファーエクスポートの1つのファイルを読み取ります(OF54):SKU、製品、数量、価格と他のエクスポートされたフィールドを持つオファー… |
roman_originals_list_product_imports | 製品インポートをリストします(P51):そのステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
roman_originals_get_product_import | 1つの製品インポートのステータスを読み取ります(P42):インポートステータス、理由、変換カウントと統合の詳細… |
roman_originals_get_products | その識別子(P31)によってマーケットプレイスカタログで製品を検索します:例:EAN、マーケットプレイス製品SKU、タイトルとカテゴリを取得します… |
roman_originals_list_product_offers | 指定された製品のすべてのショップのオファーをリストします(P11):最良の価格でソートし、競合と価格を比較します。product_idsを渡します… |
roman_originals_list_threads | 顧客とRomanとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最終メッセージの日付、ショップが… |
roman_originals_get_thread | すべてのメッセージ、送信者、受取人、添付ファイル、およびリンクされた注文またはオファーを持つ1つのメッセージスレッドを読み取ります |
roman_originals_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡およびリンクされた注文。状態、注文または日付でフィルタリングします… |
roman_originals_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金およびメッセージの理由、ラベルとショップが… |
roman_originals_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
roman_originals_list_invoices | Romanがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
roman_originals_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットと支払い、金額、タイプ… |
roman_originals_list_document_requests | 会計文書リクエストをリストします(DR11):RomanがEnhanced Seller Invoicingを実行する際に使用されます:Romanまたはショップが… |
roman_originals_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書および他のファイル、ID、ファイル… |
roman_originals_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
roman_originals_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例:フランス本土またはコルシカ。変更はあまりありません:呼び出します… |
roman_originals_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例:標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
roman_originals_list_logistic_classes | マーケットプレイスのロジスティッククラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
roman_originals_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文のすべての行をリストする必要があります。行を拒否すると、それはキャンセルされます… |
roman_originals_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。roman_originals_list_carriersからcarrier_codeを渡すか、運送業者名を… |
roman_originals_ship_order | SHIPPINGの注文が出荷されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
roman_originals_update_offers | オファーを作成または更新します。価格と在庫を含みます(OF24)。各オファーを完全に置き換えます:省略されたすべてのフィールドはリセットされます(省略された… |
roman_originals_reply_thread | メッセージスレッド(M12)で顧客またはRomanに返信します。メッセージは即座に配信され、取り消すことはできません:ユーザーにテキストを表示します… |
roman_originals_create_order_thread | 顧客、Roman、またはその両方との注文に関する新しいメッセージスレッドを開始します(OR43)。メッセージは即座に配信されます:ユーザーにテキストを表示します… |
roman_originals_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決された後。reason_codeはINCIDENT_CLOSEでなければなりません… |
roman_originals_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。Romanが販売者バックオフィスで返品を処理し、… |
roman_originals_receive_return | 受け入れられた返品の商品の到着を確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
roman_originals_import_products | 製品ファイルをマーケットプレイスに送信します(P41):カタログに製品を作成または追加します。file_urlはCSV、XLSXまたはXMLのアドレスです… |
roman_originals_import_offers | オファーファイルをインポートします(OF01):オファーを一括で作成、更新または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "どのRomanの注文が私の受け入れを待っていますか?"
- "私のリネンミディドレスSKU LMD-NAVY-12の在庫を25に設定し、価格はそのままにします。"
- "Romanでの私のオファーをエクスポートし、在庫切れのSKUをすべて表示します。"
- "注文5531207-AにRoyal Mailの追跡番号AB123456789GBを追加し、出荷を確認します。"
- "私の決定を待っている返品リクエストはどれで、どの顧客メッセージがまだ返信を必要としていますか?"
次のステップ
このガイドは役に立ちましたか?