概要
Grupo Éxito のセラー API を通じて、コロンビアの exito.com マーケットプレイスのストア運営を AI に任せましょう。商品とその承認ステータスの一覧表示、画像・説明・属性を含む商品の作成、価格と在庫の設定、注文と支払明細の取得ができます。
ガイド付きセットアップ
Grupo Éxito Marketplace を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Grupo Éxito Marketplace を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 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 + Cursor
Grupo Éxito のセラー API を通じて、コロンビアの exito.com マーケットプレイスのストア運営を AI に任せましょう。商品とその承認ステータスの一覧表示、画像・説明・属性を含む商品の作成、価格と在庫の設定、注文と支払明細の取得ができます。
前提条件
コネクタに組み込まれているセットアップ手順の全文を参照してください(コネクタを選択すると、アプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです。
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
ステップ 1 — 認証情報を取得する
Éxito から API アクセスが付与されれば、セットアップは約 10 分で完了します。アクセスが付与されると、Éxito から認証手順が送られてきます。ユーザー名、パスワード、API キー、そしてトークンを発行するアドレスです。数値のセラー ID も必要です。
サンドボックスはありません。Éxito はサンドボックスを提供していないため、書き込みを含むすべての呼び出しが本番ストアに対して実行されます。
- Éxito の手順に記載されている API ユーザー(メールアドレス)を
EXITO_USERNAMEに、API パスワードをEXITO_PASSWORDに貼り付けます。 - 同じ手順に記載されている
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 のモデレーションおよびオファー通知、そして Seller Center の Web アプリでできても API では提供されていない機能です。
よくあるエラー: トークンが発行されない場合は、ユーザー名、パスワード、API キーを Éxito の手順と照らし合わせ、EXITO_LOGIN_URL がその文書に記載されたトークン用アドレスであることを確認してください。401 はトークンが拒否されたことを意味します。403 は通常、API キーがない・誤っている、またはユーザーに対して API が有効になっていないことを意味します。アクセスがどの API を対象としているか、Éxito に問い合わせてください。
ステップ 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 — Cursor にコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "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と置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう — エージェントが
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 | セラーの支払明細(請求): 請求番号、注文番号、支払オーダー、概要、支払日、手数料、合計、IVA など… |
exito_marketplace_create_products | タイトルと HTML の説明などを指定して商品を作成します(既存の商品を変更する場合は同じ EAN を再送信します。ModifyImage "1" で画像を置き換えます)… |
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 月分の支払明細の手数料を合計してください。」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?