概要
AIエージェントからVertbaudetマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書、取引。マーケットプレイスはフランスとドイツで販売されており、VertbaudetセラーのバックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Vertbaudet Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Vertbaudet Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Vertbaudet Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Vertbaudet Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Vertbaudet Marketplace
AIエージェントからVertbaudetマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書、取引。マーケットプレイスはフランスとドイツで販売されており、VertbaudetセラーのバックオフィスからショップAPIキーでサインインします。
セットアップ
国: フランスとドイツ。ドイツの自由形式の製品属性はドイツ語で記述する必要があります。
販売できる人: Vertbaudetは新しい、中価格帯またはそれ以上の子供用品とマタニティ製品を持つブランドと小売業者を選定します。メールで連絡してください ([email protected])。ビジネスはEUに登録されている必要があり、ユーロ圏からフランスに発送し、フランス語のコンテンツとカスタマーサービスを提供する必要があります。手数料は17%のコミッションに加えて月額49.90ユーロです。このコネクタには、Vertbaudetがすでに開設したセラーアカウントが必要です。
このコネクタのセラーアドレスは、プラットフォームがこの小売業者に割り当てたものです。まだセラーガイドで名前が付けられていません。もしセラーバックオフィスが異なるアドレスで開かれている場合は、チャットでお知らせください。修正します。
セットアップには約5分かかります。
- Vertbaudetセラーバックオフィスにサインインします:
https://vertbaudetfr-prod.mirakl.net/login。 - バックオフィスでユーザー名を開き (右上) > マイユーザー設定 > APIキーをクリックし、新しいキーを生成をクリックします (または既存のキーをコピーします)。それを
VERTBAUDET_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、他のツールで使用している場合は動作しなくなります。 VERTBAUDET_SHOP_IDは空のままにします。ユーザーがVertbaudetで複数のショップを管理している場合のみ、このコネクタが動作するショップの数値IDをVERTBAUDET_SHOP_IDに設定します (バックオフィスのダッシュボードでIdentifierまたはShop IDの横に表示され、vertbaudet_get_accountによってshop_idとして返されます)。これがない場合はデフォルトのショップが使用されます。vertbaudet_get_accountをインストールして実行します: それはキーに属するショップを返します。
どこから始めるか: vertbaudet_get_accountはキーの背後にあるショップを表示します (id、名前、状態、通貨、チャネル)。日常業務では、vertbaudet_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫のためにvertbaudet_list_offersを、返信を待っているメッセージにはvertbaudet_list_threadsを使用します。
製品と競合オファー: vertbaudet_get_productsはEANまたは他の参照でVertbaudetカタログの製品を検索し、マーケットプレイス製品SKUを返します; vertbaudet_list_product_offersは指定された製品の各ショップのオファーをリストし、最良価格を最初に表示し、約5回の呼び出しで行います。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。vertbaudet_accept_orderは各行を受け入れ (または拒否) します; 顧客が引き落とされると、注文はSHIPPINGに移動します。その後、vertbaudet_update_trackingは運送業者と追跡番号を保存し (運送業者コードはvertbaudet_list_carriersから取得)、vertbaudet_ship_orderは発送を確認します (SHIPPED)。後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のToDoリストにはorder_state_codes=WAITING_ACCEPTANCEでvertbaudet_list_ordersを使用し、オープンインシデントにはhas_incident=trueを使用します; vertbaudet_resolve_incidentは問題が解決された後に1つの注文行のインシデントを閉じます。注文に添付された書類 (納品書、ラベル、顧客請求書) はvertbaudet_list_order_documentsでリストされます。
書き込み: まず確認してください。 vertbaudet_accept_order、vertbaudet_update_tracking、vertbaudet_ship_order、vertbaudet_resolve_incident、vertbaudet_accept_return、vertbaudet_receive_return、vertbaudet_update_offers、vertbaudet_reply_thread、vertbaudet_create_order_thread、vertbaudet_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変わるかを示し (注文IDと行、追跡番号、古い価格または在庫と新しい価格のオファーSKU、メッセージテキストと受取人) 、はいを待ちます。注文行を拒否すると、それは永久にキャンセルされます。ここではどのツールも返金、注文のキャンセル、またはお金の移動は行いません; それはバックオフィスで行ってください。vertbaudet_import_offersはオファーを削除できます (REPLACEモードはファイルに存在しないすべてのオファーを削除します)ので、オフに切り替えられた状態でインストールされます。
オファーの更新 (価格と在庫): vertbaudet_update_offers (OF24)はオファー全体を置き換えます。省略したフィールドはすべてリセットされます: quantityが欠けていると0になり、discountやdescriptionが欠けていると削除されます。常にオファーを最初に読み取り (vertbaudet_get_offerまたはvertbaudet_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を返します; 変更は非同期で適用されるため、再度オファーを読み取る前にvertbaudet_get_offer_importで確認してください。state_codeの条件コードはvertbaudet_list_offer_conditionsから、物流クラスコードはvertbaudet_list_logistic_classesから取得します。
ファイルインポート: vertbaudet_import_products (P41)およびvertbaudet_import_offers (OF01)は、Vertbaudetが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタはそれをダウンロードしてVertbaudetにアップロードします。vertbaudet_list_product_imports / vertbaudet_get_product_importおよびvertbaudet_list_offer_imports / vertbaudet_get_offer_importで追跡します。
返品: vertbaudet_list_returns (RT11)は返品リクエストをリストします。Vertbaudetがショップに決定を任せる場合、vertbaudet_accept_returnはWAITING_ACCEPTANCEで1つを受け入れるか拒否し、vertbaudet_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: vertbaudet_list_threadsは顧客とVertbaudetとの会話をリストします (1つの注文のためにentity_type=MMP_ORDERとentity_id=<order id>でフィルタリング; entity_typeなしのentity_idは拒否されます)、vertbaudet_get_threadはそのメッセージを読み取り、vertbaudet_reply_threadは回答します (受取人はCUSTOMERまたはOPERATOR、つまりVertbaudet) 、vertbaudet_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはvertbaudet_list_reasonsから取得します; マーケットプレイスがその言語を持っている場合を除き、localeは空のままにします (非アクティブなロケールは400で応答します)。
お金: vertbaudet_list_invoices (IV01)はVertbaudetがショップに発行する会計書類をリストし、vertbaudet_list_transactions (TL02)は取引行 (販売、コミッション、返金、支払い) をリストします。VertbaudetがEnhanced Seller Invoicingを使用している場合、IV01は新しい書類を返しません; その場合はvertbaudet_list_document_requests (DR11)を使用し、その後取引を確認します。
全カタログ: すべてのオファーを読み取るには (カタログ全体の在庫または価格チェック、オファーをカウント)、vertbaudet_export_offersでエクスポートを開始し、vertbaudet_get_offer_export_statusを約1分ごとにポーリングしてCOMPLETEDになるまで待ち、vertbaudet_get_offer_export_fileでファイルを1つずつ読み取ります; include_fieldsは必要な列のみを保持します。完全なエクスポートは1日1回許可されており、変更された内容を取得するにはlast_request_dateを渡します (差分エクスポート、最大1分に1回)。vertbaudet_list_offersでオファーをすべてページングしないでください: これは一度にいくつかのオファー用に設計されており、大規模なカタログをページングすると429で応答します。
複数のショップ: すべてのツールはオプションのshop_idを受け取ります。このマーケットプレイスで複数のショップを管理しているユーザー (代理店、または国ごとに1つのショップ) は、1つのインストールでそれらすべてを操作できます: 各呼び出しでショップのIDを渡し、vertbaudet_get_accountと同じshop_idでどのショップかを確認します。shop_idがない場合、呼び出しはVERTBAUDET_SHOP_IDを使用し、空の場合はユーザーのデフォルトショップを使用します。ユーザーにショップのIDを尋ねてください; バックオフィスに表示されます。
参照リスト: vertbaudet_list_channels (国サイト)、vertbaudet_list_carriers、vertbaudet_list_shipping_zones、vertbaudet_list_shipping_methods、vertbaudet_list_logistic_classesはあまり変更されません; 会話ごとに1回読み取ります。
ページネーション: 注文、オファー、請求書、製品インポートはmax (最大100) とoffsetでページングします。スレッド、返品、取引、書類リクエスト、オファーインポートはnext_page_tokenを返します; 次のページを取得するためにそれをpage_tokenとして渡します (他のフィルターはその後無視されます) 。それが欠けているまで続けます。
日付はISO 8601形式で、例: 2026-10-01T00:00:00Z; 応答はUTCで行われます。
レート制限: 各APIには独自の制限があり、Vertbaudetはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品とオファーのインポートは最大15分ごと、vertbaudet_get_accountと参照リストは約1日ごとに行います。429はRetry-Afterヘッダーに待機する秒数を含みます; ループで再試行しないでください。
エラー: 401はキーが間違っているか、新しいもので置き換えられたことを意味し、403はユーザーにこのアクションの権限がないことを示し、404はこのショップに対して注文、オファー、スレッドが存在しないか、マーケットプレイスがその機能を使用していないことを示します (返品など)、400は不正なパラメータまたは誤った状態の注文を示します (メッセージがそれを示します、例: ORDER_INVALID_STATE)。
前提条件: VERTBAUDET_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を開き、Vertbaudet Marketplaceを選択し、前提条件にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
vertbaudet_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります (A01): ショップIDと名前、状態、チャネル、通貨、グレード、承認率、連絡先… |
vertbaudet_list_orders | 注文をリストします (OR11) それらの行、顧客、配送先住所、価格、状態、インシデントを含みます。状態でフィルタリングします (例: WAITING_ACCEPTANCE…) |
vertbaudet_list_offers | ショップのオファーをリストします (OF21): SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
vertbaudet_get_offer | オファーIDによって1つのオファーを完全に読み取ります (OF22): すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
vertbaudet_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします (OF61): 新品または中古など、オファーを更新する際にstate_codeに入れるコード |
vertbaudet_list_offer_imports | オファーのインポートと更新をリストします (OF04)、ファイルからおよびvertbaudet_update_offersから: ステータス (WAITING、RUNNING、COMPLETE、FAILED)、行… |
vertbaudet_get_offer_import | 1つのオファーインポートまたはオファー更新のステータスを読み取ります (OF02) そのimport_idによって、vertbaudet_update_offersまたは… |
vertbaudet_export_offers | ショップのすべてのオファーをファイルとしてエクスポートを開始します (OF52)、カタログ全体を読み取る方法 (すべてのSKUと価格、在庫) ではなく… |
vertbaudet_get_offer_export_status | vertbaudet_export_offersで開始されたオファーエクスポートのステータス (OF53): PENDING、COMPLETEDまたはFAILED (エラーコードとエラー詳細付き)… |
vertbaudet_get_offer_export_file | 完了したオファーエクスポートの1つのファイルを読み取ります (OF54): SKU、製品、数量、価格と他のエクスポートされたフィールドを持つオファーとして… |
vertbaudet_list_product_imports | ステータス (WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED) を持つ製品インポートをリストします (P51)、変換カウントと… |
vertbaudet_get_product_import | 1つの製品インポートのステータスを読み取ります (P42) そのimport_idによって: インポートステータス、理由、変換カウントと統合の詳細… |
vertbaudet_get_products | マーケットプレイスカタログでその識別子 (P31) によって製品を検索し、マーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
vertbaudet_list_product_offers | 指定された製品の各ショップのオファーをリストします (P11)、最良価格でソートし、競合と価格を比較します。product_idsを渡します… |
vertbaudet_list_threads | 顧客とVertbaudetとのメッセージスレッドをリストします (M11): トピック、関連する注文またはオファー、参加者、最終メッセージ日付といつから… |
vertbaudet_get_thread | すべてのメッセージ、送信者、受取人、添付ファイル、関連する注文またはオファーを持つ1つのメッセージスレッドを読み取ります (M10) |
vertbaudet_list_returns | ステータス、返品行、理由、RMA、追跡、関連する注文を持つ返品リクエストをリストします (RT11)。状態、注文または日付でフィルタリングします… |
vertbaudet_list_reasons | マーケットプレイスの理由コードをリストします (RE01): インシデント、キャンセル、返金、メッセージの理由、ラベルとショップが… |
vertbaudet_list_carriers | マーケットプレイスが知っている運送業者をリストします (SH21) そのコード、ラベル、追跡URL。carrier_codeとして使用します… |
vertbaudet_list_invoices | Vertbaudetがショップに発行する会計書類をリストします (IV01): 請求書とクレジットノート、期間、税金ありとなしの合計… |
vertbaudet_list_transactions | ショップの取引行をリストします (TL02): 注文金額、送料、コミッション、返金、手動クレジットと支払い、金額、タイプ… |
vertbaudet_list_document_requests | 会計書類リクエストをリストします (DR11)、VertbaudetがEnhanced Seller Invoicingを実行する際に使用されます: 請求書とクレジットノート… |
vertbaudet_list_order_documents | 1つまたは複数の注文に添付された書類をリストします (OR72): 納品書、発送ラベル、顧客請求書、その他のファイル、ID、ファイル… |
vertbaudet_list_channels | マーケットプレイスの販売チャネルをリストします (CH11)、通常は国サイトごとに1つ、コードとラベルを持ちます。channel_codesとして使用します… |
vertbaudet_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします (SH11) コードとラベル、例: 本土フランスまたはコルシカ。変更はまれです: 呼び出します… |
vertbaudet_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします (SH12)、例: 標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
vertbaudet_list_logistic_classes | マーケットプレイスの物流クラスをリストします (SH31)、配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
vertbaudet_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します (OR21)。注文の各行をリストする必要があります。行を拒否するとそれはキャンセルされます… |
vertbaudet_update_tracking | 注文の運送業者と追跡番号を設定します (OR23)。vertbaudet_list_carriersからcarrier_codeを渡すか、carrier_nameとcarrier_urlを使用します… |
vertbaudet_ship_order | SHIPPINGの注文が発送されたことを確認します (OR24); それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
vertbaudet_update_offers | オファーを作成または更新します、価格と在庫を含む (OF24)。各オファーを完全に置き換えます: 省略されたすべてのフィールドはリセットされます (欠けている… |
vertbaudet_reply_thread | メッセージスレッド (M12) で顧客またはVertbaudetに返信します。メッセージは即座に配信され、取り消すことはできません: ユーザーに… |
vertbaudet_create_order_thread | 顧客、Vertbaudet、またはその両方との注文に関する新しいメッセージスレッドを開始します (OR43)。メッセージは即座に配信されます: ユーザーに… |
vertbaudet_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします (OR64)、顧客の問題が解決された後。reason_codeはINCIDENT_CLOSE… |
vertbaudet_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します (RT21)。Vertbaudetがセラーバックオフィスで返品を処理し、… |
vertbaudet_receive_return | 受け入れられた返品の商品の到着を確認します (RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
vertbaudet_import_products | マーケットプレイスに製品ファイルを送信します (P41) カタログに製品を作成または豊かにするために。file_urlはCSV、XLSX、またはXMLのアドレスです… |
vertbaudet_import_offers | オファーファイルをインポートします (OF01) 一括でオファーを作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "どのVertbaudetの注文が私の承認を待っていますか?フランスまたはドイツからのものは?"
- "私のベビー寝袋SKU VB-SLP-6Mの在庫を50に設定し、価格はそのままにします。"
- "注文5501234-AにColissimo追跡6A90123456789を追加し、発送を確認します。"
- "どの返品リクエストが私の決定を待っていますか?"
- "今月私に発行された請求書を表示してください。"
次のステップ
このガイドは役に立ちましたか?