摘要
通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。
引导式设置
2 分钟将 Grupo Éxito Marketplace 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Grupo Éxito Marketplace,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
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 + Claude
通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。
前提条件
请查看连接器内置的完整设置说明(在应用内商店选择该连接器时可见)。此连接器所需的环境变量如下:
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
第 1 步 — 获取凭据
在 É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 密钥一起发送。令牌会自动续期,最长每小时一次。密码和密钥经加密存储,绝不会展示给 AI。
云端和自托管的工作方式相同:凭据相同,也无需设置重定向 URL。
在 Éxito 上销售是异步的:
- 使用
exito_marketplace_list_categories选择最具体的类别,并通过exito_marketplace_get_category_features读取其规格。必填规格必须提供;带有取值列表的规格只接受列表中的值。 - 使用
exito_marketplace_create_products创建商品,每次调用最多 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列出与市场中已有的同一商品存在差异的商品。商品获批后,最多需要一小时才能创建报价。 - 使用
exito_marketplace_upsert_offers为已获批的商品设置价格和库存;如果只针对一个 EAN,则使用exito_marketplace_update_offer_price_stock。exito_marketplace_load_products_and_offers可在一个请求中同时发送商品和报价。报价大约在 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 附带一条消息,因此 200 并不意味着所有商品或报价都已被接受。请求和响应均为西班牙语。
不在覆盖范围内:运单标签、Éxito 的审核和报价通知,以及 Seller Center 网页应用中 API 未提供的任何功能。
常见错误:如果没有签发令牌,请对照 Éxito 的说明检查用户名、密码和 API 密钥,并确认 EXITO_LOGIN_URL 是该文档中的令牌地址。401 表示令牌被拒绝。403 通常意味着 API 密钥缺失或错误,或者你的用户未启用该 API:请向 Éxito 询问你的访问权限涵盖哪些 API。
第 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 步 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP Servers → 此连接器所在的服务器,并复制其 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都使用该 URL。
推荐方式:可在 claude.ai 网页版使用,无需编辑任何配置文件。
- 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
- 点击 + Add,然后点击 Add custom connector。
- 输入名称,例如
Grupo Éxito Marketplace,以及远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。 - 选择 Sign in now,点击 Add 并登录 AnythingMCP(OAuth)以授权访问。
下方所有工具都会出现在你的对话中:开始输入提示词即可。
可用工具
| 工具 | 功能 |
|---|---|
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 获取单个类别: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 | 创建商品(或修改现有商品:再次发送相同的 EAN;ModifyImage "1" 会替换图片),包含标题、HTML 描述…… |
exito_marketplace_load_products_and_offers | 在一个请求中同时发送商品及其报价:每个条目包含一个 Product(exito_marketplace_create_products 的字段)和一个…… |
exito_marketplace_upsert_offers | 为 Éxito 已批准的 EAN 创建或更新报价(价格、促销价、库存、运输和配送承诺),适用于所有 Éxito 站点…… |
exito_marketplace_update_offer_price_stock | 修改一个现有报价(一个 EAN)的价格和/或库存。Éxito 要求每次更新都提供 EAN、Stock 和 Price:若只修改价格…… |
exito_marketplace_set_order_tracking | 将订单中的商品标记为已发货,并填写承运商和物流单号(适用于标准配送的订单) |
exito_marketplace_upload_order_invoice | 以 base64 编码的 PDF 或 ZIP 形式为订单附上发票 |
示例提示词
- "Éxito 拒绝了我的哪些商品,原因是什么?"
- "显示本周分配给我、仍需发货的订单。"
- "EAN 7701234567890 在 exito.com 上的价格和库存是多少?"
- "将 EAN 7701234567890 的库存设为 25 件,价格保持不变。"
- "汇总我 10 月结算单中的佣金。"
常见问题
它既支持 Claude Desktop,也支持 Claude Code 吗? 支持,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID 即可。
后续步骤
这份指南对你有帮助吗?