概要
Grupo Éxito のセラーAPIを通じて、コロンビアの exito.com マーケットプレイスのストアを AI に運用させましょう。商品と承認ステータスの一覧表示、画像・説明・属性付きの商品作成、価格と在庫の設定、注文と支払い明細の読み取りができます。
ガイド付きセットアップ
Grupo Éxito Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Grupo Éxito Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Grupo Éxito Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要。cloud.anythingmcp.com をそのまま使えます。 サインインして Connectors → Grupo Éxito Marketplace をクリックし、認証情報を貼り付けて MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要です。
Grupo Éxito Marketplace
Grupo Éxito のセラーAPIを通じて、コロンビアの exito.com マーケットプレイスのストアを AI に運用させましょう。商品と承認ステータスの一覧表示、画像・説明・属性付きの商品作成、価格と在庫の設定、注文と支払い明細の読み取りができます。
セットアップ
Éxito から API アクセスが許可されていれば、セットアップは約10分で完了します。アクセスが許可されると、Éxito から認証手順が送られてきます。ユーザー名、パスワード、API キー、そしてトークンを発行するアドレスです。数値のセラー ID も必要です。
サンドボックスはありません: Éxito はサンドボックスを提供していないため、書き込みを含むすべての呼び出しが本番ストアに対して実行されます。
- API ユーザー(メールアドレス)を
EXITO_USERNAMEに、API パスワードをEXITO_PASSWORDに貼り付けます。どちらも Éxito の手順書に記載されています。 - 同じ手順書にある
x-api-keyをEXITO_API_KEYに貼り付けます。 - トークン取得リクエストの
https://から始まる完全なアドレスをEXITO_LOGIN_URLに貼り付けます。このアドレスは developers.exito.com には公開されていないため、Éxito から送られた資料からコピーしてください。 - 数値のセラー ID(idSeller、例:
11795)をEXITO_SELLER_IDに入力します。exito_marketplace_get_bulk_upload_statusでもdata.idSellerとして確認できます。 - コネクタをインストールします。
exito_marketplace_list_categoriesを実行して接続を確認します。
サインインの仕組み: コネクタはユーザー名、パスワード、API キーを使ってトークン用アドレスからトークンを取得し、呼び出しのたびに API キーと一緒に送信します。トークンは自動的に更新され、遅くとも1時間ごとに更新されます。パスワードとキーは暗号化して保存され、AI に表示されることはありません。
クラウド版もセルフホスト版も同じ動作です: 認証情報は同じで、設定するリダイレクト URL もありません。
Éxito での販売は非同期です:
exito_marketplace_list_categoriesで最も具体的なカテゴリを選び、exito_marketplace_get_category_featuresでその仕様を読み取ります。必須の仕様は必ず送信する必要があります。値のリストを持つ仕様には、そのリスト内の値しか指定できません。exito_marketplace_create_productsで商品を作成します。1回の呼び出しで最大400件の EAN を送れます。画像は公開 URL で、1000x1000 px(衣料品は 733x1000 px)です。ブランドは Éxito にすでに存在している必要があります。存在しない場合は、Éxito の担当アカウントマネージャーが作成します。exito_marketplace_get_bulk_upload_statusでバッチの進行状況を確認します。バッチの開始中または処理中は、新しいバッチは受け付けられません。- Éxito のコンテンツチームがすべての商品をレビューします。
exito_marketplace_get_products_waitingはレビュー中の商品、exito_marketplace_get_products_rejectedは理由付きで却下された商品、exito_marketplace_get_products_pending_seller_approvalはマーケットプレイスにすでにある同一商品と内容が異なる商品を一覧表示します。承認後、商品にオファーを設定できるようになるまで最大1時間かかります。 - 承認された商品には、
exito_marketplace_upsert_offersで価格と在庫を設定します。1つの EAN だけならexito_marketplace_update_offer_price_stockを使います。exito_marketplace_load_products_and_offersは、商品とオファーを1回のリクエストで送信します。オファーは約4時間以内に各サイトへ反映されます。
価格と在庫: 価格は8000を超えるコロンビアペソの整数で、区切り文字なしで指定します(45000)。セール価格は通常価格より低くする必要があります。価格だけを変更する場合は、現在の在庫数を IsUpdatedStock を 0 にして送信します。30%を超える価格変更はコード PEX で返され、価格承認付きで再送信する必要があります。その前に AI があなたに確認します。商品の販売を停止するには、在庫を 0 にします。API に削除機能はありません。
注文と支払い: exito_marketplace_get_orders は、exito.com、carulla.com、Éxito のその他のサイトからの注文を、ステータス、合計額、手数料、配送タイプとともに一覧表示します。exito_marketplace_get_bills は支払い明細を一覧表示します。一覧のページ送りには paginationToken を使います。
インストール時はオフ: exito_marketplace_set_order_tracking(注文の商品を、配送業者と追跡番号付きで発送済みにする)と exito_marketplace_upload_order_invoice(注文に請求書を添付する)です。AI に注文を処理させたい場合は、コネクタのページでオンにしてください。AI は呼び出しのたびにあなたへ確認します。商品の作成と価格・在庫の設定はオンになっています(exito_marketplace_create_products、exito_marketplace_load_products_and_offers、exito_marketplace_upsert_offers、exito_marketplace_update_offer_price_stock)。
すべての応答を確認してください: バッチ書き込みは HTTP 200 を返し、拒否された EAN ごとに1件のメッセージが付きます。そのため、200 だからといってすべての商品やオファーが受理されたとは限りません。リクエストと応答はスペイン語です。
対象外: 配送ラベル、Éxito のモデレーション通知とオファー通知、およびセラーセンターの Web アプリでできても API にはない操作です。
よくあるエラー: トークンが発行されない場合は、ユーザー名、パスワード、API キーを Éxito の手順書と照らし合わせ、EXITO_LOGIN_URL がその資料に記載されたトークン用アドレスであることを確認してください。401 はトークンが拒否されたことを意味します。403 は通常、API キーがない、または誤っている、あるいはユーザーに API が有効化されていないことを意味します。アクセスがどの API を対象にしているか、Éxito に問い合わせてください。
前提条件: EXITO_USERNAME、EXITO_PASSWORD、EXITO_API_KEY、EXITO_LOGIN_URL、EXITO_SELLER_ID
コネクタをローカルにインストールする
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 を開き、Grupo Éxito Marketplace を選んで、前提条件に挙げた環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
exito_marketplace_get_products | Éxito マーケットプレイスにあるセラーの商品を、名前、EAN、VTEX PLU、画像、作成日・更新日、価格、セール価格、在庫とともに一覧表示します… |
exito_marketplace_get_products_waiting | Éxito のコンテンツチームによる承認(モデレーション)待ちの商品を、EAN、名前、画像、処理日、親参照とともに表示します |
exito_marketplace_get_products_rejected | Éxito のコンテンツチームに却下され、修正が必要な商品を、EAN、名前、画像、却下の Reason と Comment とともに表示します |
exito_marketplace_get_products_pending_seller_approval | マーケットプレイスにすでにある同一商品と内容が異なるため、あなたの判断が必要な商品です。各行に oldProduct と… |
exito_marketplace_get_bulk_upload_status | 直近の商品作成バッチ(exito_marketplace_create_products)のステータスです。data.status: 4 開始中、1 処理中、2 完了… |
exito_marketplace_list_categories | Éxito マーケットプレイスのすべてのカテゴリを、Id、IdParent、Name、ProductType(Technology または Clothing)とともに表示します |
exito_marketplace_get_category | ID で指定した1つのカテゴリ(Id、IdParent、Name、ProductType)を取得します |
exito_marketplace_get_category_features | カテゴリの仕様グループです。各仕様の specName、label、必須かどうか、許可される値(values[].label、…)を表示します |
exito_marketplace_get_orders | Éxito のサイト(exito.com、carulla.com など)で受けた注文を、注文番号、チャネル、日付、ステータス、合計額、手数料とともに表示します… |
exito_marketplace_get_bills | セラーの支払い明細(billing)です。請求番号、注文番号、支払い注文、概要、支払日、手数料、合計、IVA などを表示します… |
exito_marketplace_create_products | 商品を作成します(既存商品の変更は同じ EAN を再送信。ModifyImage "1" で画像を置き換え)。タイトル、HTML の説明文… |
exito_marketplace_load_products_and_offers | 商品とそのオファーを1回のリクエストで送信します。各項目には Product(exito_marketplace_create_products のフィールド)と… |
exito_marketplace_upsert_offers | Éxito がすでに承認した EAN について、すべての Éxito サイトでオファー(価格、セール価格、在庫、配送、配達予定)を作成または更新します… |
exito_marketplace_update_offer_price_stock | 既存の1つのオファー(1つの EAN)の価格や在庫を変更します。Éxito では更新のたびに EAN、Stock、Price が必要です。価格だけを変更するには… |
exito_marketplace_set_order_tracking | 注文の商品を、配送業者と追跡番号付きで発送済みにします(標準配送の注文) |
exito_marketplace_upload_order_invoice | 注文の請求書を base64 の PDF または ZIP として添付します |
プロンプト例
- 「Éxito に却下された商品はどれで、その理由は何ですか?」
- 「今週私に割り当てられた注文のうち、まだ発送が必要なものを表示して。」
- 「exito.com での EAN 7701234567890 の価格と在庫は?」
- 「EAN 7701234567890 の在庫を25個にして、価格はそのままにして。」
- 「10月の支払い明細の手数料を合計して。」
次のステップ
このガイドは役に立ちましたか?