Falabella MCP 服务器：商品、库存与订单

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

Falabella Seller Center

通过 Falabella Seller Center,让你的 AI 运营你在智利、哥伦比亚或秘鲁的 falabella.com 店铺:商品、各仓库库存、品牌、类目及其属性、订单及订单项、面单和 Feed 结果,还可以创建商品、修改价格、库存和图片。

设置

设置大约需要 5 分钟。你需要一个 Falabella Seller Center 的卖家账号、一个拥有 API 角色的 Seller Center 用户、该用户的 API 密钥,以及你的 Seller ID。

没有沙盒环境:每一次调用(包括写入操作)都会作用于你的正式店铺。

1. 使用连接器要代表的用户登录 sellercenter.falabella.com。管理员可以在 Mi cuenta → Usuarios → Agregar Usuario 下添加专用用户。
2. 打开 Mi cuenta → Usuarios。将该用户的邮箱地址填入 FALABELLA_USER_ID,将该行 API Key 列中的值填入 FALABELLA_API_KEY。
3. 为该用户分配一个 API 角色:Seller API Access(所有方法)、Seller API Product Access(商品、品牌、类目、图片和 Feed)或 Seller API Order Access(订单)。角色范围之外的方法会返回 E009: Access Denied。
4. 将 Mi cuenta 下显示的 Seller ID 复制到 FALABELLA_SELLER_ID。
5. 将 FALABELLA_BUSINESS_UNIT 设置为你所在的国家:FACL 智利,FACO 哥伦比亚,FAPE 秘鲁。一个连接器对应一个国家;如需其他国家,请再添加一个连接器。
6. 安装连接器。运行 falabella_seller_center_feed_count 检查连接:这是一个轻量级调用。

签名方式:每个请求都使用 HMAC-SHA256 签名,以你的 API 密钥作为密钥。密钥本身从不会被发送。时间戳偏差过大的请求会被拒绝(E003)。

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

从哪里开始:falabella_seller_center_get_products 列出商品,支持按状态、搜索、SKU 和日期筛选。falabella_seller_center_get_stock 显示各仓库的库存,包含 Fulfillment by Falabella。订单方面使用 falabella_seller_center_get_orders 和 falabella_seller_center_get_order_items,它们会返回面单和状态变更所需的 OrderItemId 和 PackageId。falabella_seller_center_get_document 返回面单。

新建商品:根据标题用 falabella_seller_center_get_category_suggestion 查找类目,或在 falabella_seller_center_get_category_tree 中查找(商品只能放在叶子类目中)。用 falabella_seller_center_get_category_attributes 读取该类目的属性,用 falabella_seller_center_get_brands 获取准确的品牌名称。然后用 falabella_seller_center_create_products 创建商品,并用 falabella_seller_center_set_images 添加图片。

写入即 Feed:创建、更新、改价、改库存、设置图片和删除商品都是异步的。成功的响应只表示请求已被接受。falabella_seller_center_feed_status 会显示结果:等到 Status 变为 Finished、Error 或 Canceled,然后读取 FailedRecords 和 FeedErrors,因为一个 Feed 完成时可能仍有部分记录被拒绝。Falabella 允许每个卖家自由调用 50 次 Feed,之后每 2 分钟一次,因此 AI 会把多个商品合并到一个请求中,而不是每个 SKU 调用一次。

国家代码:业务单元使用大写(FACL)。在商品 XML 中,同一个国家对应小写的 OperatorCode:facl、faco、fape。

安装时默认关闭:falabella_seller_center_remove_products(删除商品)、falabella_seller_center_set_status_ready_to_ship(将订单项标记为待发货)和 falabella_seller_center_set_status_canceled(取消订单项)。当 AI 需要使用它们时,请在连接器页面中开启;AI 每次调用都会请你确认。创建和更新商品,以及修改价格、库存和图片的工具默认开启(falabella_seller_center_create_products、falabella_seller_center_update_products、falabella_seller_center_update_price、falabella_seller_center_update_stock、falabella_seller_center_update_stock_xml、falabella_seller_center_set_images)。

格式:日期筛选使用 ISO 8601(2026-11-01T00:00:00+00:00)。价格使用英文句点作为小数分隔符。ID 列表放在方括号中:[123456,123457]。更新只会修改其中包含的元素。

常见错误:E007 表示签名不匹配:API 密钥必须属于 FALABELLA_USER_ID 中的用户(即 Mi cuenta → Usuarios 下的同一行),并且需完整复制。E009 表示该用户的角色不包含该方法。E429 表示已达到 Feed 限额:请等待后重试。Falabella 会以 HTTP 200 返回拒绝信息;连接器会将其报告为失败的调用。

前提条件:FALABELLA_USER_ID、FALABELLA_API_KEY、FALABELLA_SELLER_ID、FALABELLA_BUSINESS_UNIT

在本地安装连接器

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,选择 Falabella Seller Center,并粘贴"前提条件"中列出的环境变量。

可用工具

示例提示词

• "今天有哪些订单,哪些订单项还需要发货?"
• "显示 SKU ZAP-RUN-42 在各个仓库的库存。"
• "我最近的 Feed 完成了吗?列出所有被拒绝的记录及原因。"
• "把 SKU ZAP-RUN-42 的价格改为 49990,并设置促销价 39990,有效期到本月底。"
• "为 'Zapatillas running hombre' 推荐一个类目,并列出它的必填属性。"

后续步骤

• 连接到 Claude
• 连接到 ChatGPT