连接器指南阅读约 3 分钟16 个 MCP 工具7 种语言

Éxito MCP 服务器:商品、报价与订单

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场的店铺:列出商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Grupo Éxito Marketplace

Grupo Éxito Marketplace

Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.

个工具

16

区域

INTL

类别

电子商务

身份验证

Sign-in token

所需环境变量

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场的店铺:列出商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

引导式设置

2 分钟将 Grupo Éxito Marketplace 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Grupo Éxito Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Grupo Éxito Marketplace 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Grupo Éxito Marketplace · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → Grupo Éxito Marketplace,粘贴你的凭据,生成 MCP API 密钥即可完成。无需 Docker,无需 git clone,无需本地服务器。

Grupo Éxito Marketplace

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场的店铺:列出商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

设置

在 Éxito 授予你 API 访问权限后,设置大约需要 10 分钟。获得访问权限后,Éxito 会发送认证说明:用户名、密码、API 密钥以及签发令牌的地址。你还需要你的数字卖家 ID。

没有沙盒环境:Éxito 没有提供沙盒,因此每次调用(包括写入操作)都会作用于你的正式店铺。

  1. 将 API 用户(一个电子邮件地址)粘贴到 EXITO_USERNAME,将 API 密码粘贴到 EXITO_PASSWORD,两者都来自 Éxito 的说明。
  2. 将同一说明中的 x-api-key 粘贴到 EXITO_API_KEY。
  3. 将令牌请求的完整 https:// 地址粘贴到 EXITO_LOGIN_URL。该地址未在 developers.exito.com 上公布,请从 Éxito 发给你的文档中复制。
  4. 将你的数字卖家 ID(idSeller,例如 11795)填入 EXITO_SELLER_ID。exito_marketplace_get_bulk_upload_status 也会以 data.idSeller 的形式显示它。
  5. 安装连接器。运行 exito_marketplace_list_categories 以检查连接。

登录方式:连接器使用你的用户名、密码和 API 密钥向令牌地址请求令牌,并在每次调用时连同 API 密钥一起发送。令牌会自动续期,最长每小时一次。密码和密钥经加密存储,绝不会展示给 AI。

云端和自托管的工作方式相同:凭据相同,也无需设置重定向 URL。

在 Éxito 上销售是异步的:

  1. 使用 exito_marketplace_list_categories 选择最具体的类别,并用 exito_marketplace_get_category_features 读取其规格。必填规格必须提交;带有值列表的规格只接受列表中的值。
  2. 使用 exito_marketplace_create_products 创建商品,每次调用最多 400 个 EAN。图片为公开 URL,尺寸 1000x1000 px(服装为 733x1000 px)。品牌必须已存在于 Éxito;如缺少品牌,请联系你的 Éxito 客户经理创建。
  3. 使用 exito_marketplace_get_bulk_upload_status 跟踪批次。在有批次正在启动或处理时,不会接受新的批次。
  4. Éxito 的内容团队会审核每个商品。exito_marketplace_get_products_waiting 列出审核中的商品,exito_marketplace_get_products_rejected 列出被拒绝的商品及原因,exito_marketplace_get_products_pending_seller_approval 列出与市场中已有的同一商品存在差异的商品。商品获批后,最多需要一小时才能创建报价。
  5. 使用 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。

前置条件: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 获取单个类别: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 月份结算单中的佣金总额。"

后续步骤

这份指南对你有帮助吗?

2 分钟将 Grupo Éxito Marketplace 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Grupo Éxito Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

通过 MCP 将 Éxito 连接到 ChatGPT:报价与库存

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

通过 MCP 将 Éxito 连接到 Claude:商品与订单

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

通过 MCP 将 Éxito 连接到 Microsoft Copilot

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

通过 MCP 将 Éxito 连接到 Cursor:商品目录上传

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

通过 MCP 将 Éxito 连接到 Gemini CLI:订单

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

通过 MCP 将 Éxito 连接到 Meta Muse:店铺订单

通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。