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

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

通过 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

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

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

AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。

试试这样问

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 + 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 没有提供任何沙盒,因此每一次调用(包括写入操作)都会作用于你的真实店铺。

  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。

第 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 网页版使用,无需编辑任何配置文件。

  1. 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
  2. 点击 + Add,然后点击 Add custom connector。
  3. 输入名称,例如 Grupo Éxito Marketplace,以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。
  4. 选择 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 即可。

后续步骤

这份指南对你有帮助吗?

2 分钟将 Grupo Éxito Marketplace 连接到 Claude

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

相关指南

连接器

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

通过 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 市场上的店铺:列出你的商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。

连接器

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

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