摘要
ZALORA 卖家中心 API v2 适用于新加坡、马来西亚、印度尼西亚、菲律宾和香港的时尚市场卖家:订单和订单项、打包、跟踪和运输文件、产品和产品集、库存、各国价格、品牌和类别。OAuth 应用程序 ID 和密钥。
引导式设置
2 分钟将 ZALORA 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ZALORA,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ZALORA 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → ZALORA,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
ZALORA + Cursor
ZALORA 卖家中心 API v2 适用于新加坡、马来西亚、印度尼西亚、菲律宾和香港的时尚市场卖家:订单和订单项、打包、跟踪和运输文件、产品和产品集、库存、各国价格、品牌和类别。OAuth 应用程序 ID 和密钥。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_CLIENT_SECRET
第一步 — 获取凭据
设置大约需要 5 分钟。
- 使用具有 卖家完全访问 角色的用户登录 ZALORA 卖家中心。
- 打开 设置、集成管理、OAuth 应用程序 并创建一个应用程序。将 应用程序 ID 复制到
ZALORA_CLIENT_ID,将 应用程序密钥 复制到ZALORA_CLIENT_SECRET。密钥仅显示一次。 - 在
ZALORA_DOMAIN中选择你的卖家中心国家:新加坡zalora.sg,马来西亚zalora.com.my,印度尼西亚zalora.co.id,菲律宾zalora.com.ph,香港zalora.com.hk。
连接器在 https://sellercenter.<country domain>/oauth/client-credentials(客户端凭据,HTTP Basic)交换这两个值以获取一个有效期为一小时的 Bearer 令牌,并在过期时续订。没有作用域:应用程序可以执行其创建者角色允许的操作。
从哪里开始:zalora_get_order_counters 获取概览,然后使用 zalora_list_orders 和状态为 pending(待打包的订单)以及 zalora_get_order 获取项目、地址和价格。
订单:zalora_list_orders,zalora_get_order,zalora_list_order_items,zalora_get_order_history,zalora_get_order_item_returns。订单 id 是数字,工具使用此值;number 是客户看到的内容。状态存在于项目上:pending、ready_to_ship、shipped、delivered、failed、canceled、returned 以及退货状态。
打包和运输:首先检查 zalora_list_shipment_providers。zalora_set_ready_to_ship 将一个订单的待处理项目打包成一个带有跟踪号码的包裹(仅对 apiIntegrationAvailable 为 true 的提供商可选);zalora_set_packed_by_marketplace 将运输交给 ZALORA 的物流。直销卖家随后使用 zalora_set_shipped 和 zalora_set_delivered。zalora_update_tracking_code 和 zalora_update_shipping_provider 修正一个准备发货的包裹。zalora_print_document 返回运输标签、发票或拣货单作为 base64 PDF(在标签仍在制作时为 202)。注意项目键:id 在 set_ready_to_ship 中,orderItemId 在 set_packed_by_marketplace 中。
安装时关闭:zalora_cancel_order_items(无法撤销,客户会退款),zalora_set_delivery_failed,zalora_approve_return(导致退款)和 zalora_set_price_status(inactive 会将产品下架)。取消和交付失败的原因来自 zalora_list_failure_reasons。仅在工作区希望 AI 执行时在连接器中启用工具。
目录:产品集是目录项;其产品是变体(尺寸、颜色),每个都有自己的数字产品 ID,用于库存和价格。zalora_list_products(按卖家 SKU 搜索),zalora_list_product_sets,zalora_list_product_set_products,zalora_list_brands,zalora_get_category_tree(大型:一次性获取),zalora_get_category_attributes,zalora_get_seller。
库存和价格:zalora_get_product_stock,zalora_get_product_set_stock 和 zalora_update_stock(绝对数量,每次调用最多 100 个产品,仅在库存确实更改时;不适用于由 ZALORA 完成的产品)。zalora_get_product_set_prices 显示各国价格;zalora_update_price 更改一个国家中一个产品的价格、销售价格和销售日期(仅更改你发送的字段)。创建产品、大批量导入和数据馈送不包括在内。
分页:列表接受 limit 和 offset;答案包含 pagination,带有 hasNext(订单、订单项)或 totalCount(产品、品牌)。产品集和品牌最多返回 100 行。
速率限制:每个卖家每秒 30 个请求,由每个应用程序和令牌共享;超过此限制 ZALORA 返回 429。错误携带真实的 HTTP 状态,带有 title 和 detail(422 是命名字段的验证错误,503 维护模式)。
第二步 — 安装适配器
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
第三步 — 在 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已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
ZALORA的工具。
可用工具
| 工具 | 功能 |
|---|---|
zalora_list_orders | 列出订单,按时间从旧到新排序,除非已排序:id(数字,所有其他订单工具使用),number(客户看到的订单号)和状态… |
zalora_get_order | 读取一个订单:number、status、dates、customer 和 shipping 和 billing address、payment method、totals 和 currency,以及其项目(id… |
zalora_get_order_counters | 每个状态(pending、ready to ship、shipped、delivered、canceled 等)的订单大致数量,以及请求的退货数量… |
zalora_list_order_items | 列出跨订单的订单项:id、orderId、status、shopSku、sellerSku、name、unitPrice、paidPrice、shipment provider 和 tracking code… |
zalora_get_order_history | 一个订单的项目的状态历史:orderItemId、shopSku、status、note、createdAt 和谁进行了更改。只读 |
zalora_get_order_item_returns | 订单项的退货详情:退货包裹、原因、评论和退货运输提供商。只读 |
zalora_list_shipment_providers | 卖家可以使用的运输提供商:id、name、default、apiIntegrationAvailable(true:可能省略跟踪号码)… |
zalora_list_failure_reasons | 取消项目或标记交付失败时接受的原因:id、type、name、description 和 outOfStock。只读 |
zalora_print_document | 生成一个订单文档作为 base64 PDF:运输标签、发票、拣货单、检查单、承运人清单等,具体取决于订单… |
zalora_list_products | 列出产品(变体):id、uuid、shopSku、sellerSku、productSetId、status 和变体,按 id 排序,带有 pagination(limit… |
zalora_list_product_sets | 列出产品集(将尺寸或颜色分组的目录项):id、name、parent SKU、brand、category、status 和质量控制… |
zalora_list_product_set_products | 一个产品集的产品(变体):id(用于库存和价格的产品 ID)、sellerSku、shopSku、variation、status… |
zalora_get_product_stock | 一个产品(变体)的库存:数量(可在你的仓库中销售)、reservedStock、available、ZALORA 的寄售库存… |
zalora_get_product_set_stock | 一个产品集的每个产品(变体)的库存:shopSku、sellerSku、数量、reservedStock、available、寄售和仓库… |
zalora_get_product_set_prices | 每个国家的一个产品集的每个产品的价格:price、salePrice、saleStartDate、saleEndDate 和 status,适用于有… |
zalora_list_brands | 品牌:id、uuid、name、isRestricted 和 isAccessible(你是否可以销售),带有 pagination(totalCount)。只读 |
zalora_get_category_tree | 整个类别树:id、parentId、name、attributeSetId、path 和 children。大型答案:一次性获取并保留 ids。只读 |
zalora_get_category_attributes | 一个类别的属性:id、name、label、isMandatory、inputType、attributeType 和允许的选项。只读 |
zalora_get_seller | 凭据背后的卖家账户:id、name、short code、status、下架原因(假期模式、订单限制)和联系信息… |
zalora_set_ready_to_ship | 将一个订单的待处理项目打包成一个包裹并设置为准备发货,带有跟踪号码和运输提供商。每个… |
zalora_set_packed_by_marketplace | 将待处理项目标记为已打包,以便 ZALORA 安排运输(市场物流)。每个项目必须来自同一订单。回答… |
zalora_set_shipped | 将一个订单的准备发货项目设置为已发货(仅限直销;对于交叉对接或需要清单的情况不可行)。回答… |
zalora_set_delivered | 将一个订单的已发货项目设置为已交付(仅限直销)。回答已更改的订单项 ids |
zalora_update_tracking_code | 更改准备发货项目的跟踪号码;适用于同一包裹中的每个项目。发送空字符串以让 ZALORA… |
zalora_update_shipping_provider | 更改准备发货项目的运输提供商(可选地更改跟踪号码);适用于同一包裹中的每个项目 |
zalora_update_stock | 在一次调用中设置最多 100 个产品(变体)的库存数量,作为绝对数字。对于由 ZALORA 完成的产品不可行… |
zalora_update_price | 更改一个国家中一个产品(变体)的价格。仅更改你发送的字段:价格(标价)、销售价格和… |
zalora_set_price_status | 将一个国家中一个产品的价格行切换为激活或非激活。非激活会将该国家的产品下架 |
zalora_cancel_order_items | 以来自 zalora_list_failure_reasons 的原因取消一个订单的项目。无法撤销;客户会退款,取消… |
zalora_set_delivery_failed | 将一个订单的项目标记为交付失败,原因来自 zalora_list_failure_reasons(仅限直销) |
zalora_approve_return | 批准等待批准的项目的退货(仅在卖家处理退货的情况下)。批准会导致客户退款 |
示例提示
- "哪些 ZALORA 订单待处理并需要今天打包?"
- "将订单项 81234567 设置为准备发货并获取运输标签。"
- "哪些产品集的库存少于 5 个单位?"
- "将 SKU ZL-DRESS-NVY-M 的价格设置为 59.90 新加坡元。"
- "显示订单 260112345 的退货及其原因。"
常见问题
凭据来自哪里? ZALORA 卖家中心,设置,集成管理,OAuth 应用程序:以具有卖家完全访问权限的用户身份创建应用程序并复制其应用程序 ID 和密钥。还要选择你的卖家中心国家。
它覆盖哪些国家? 新加坡、马来西亚、印度尼西亚、菲律宾和香港。每个国家都有自己的卖家中心,因此每个国家安装一个连接器。
哪些工具安装时关闭? zalora_cancel_order_items,zalora_set_delivery_failed,zalora_approve_return 和 zalora_set_price_status。仅在 AI 应该使用时在连接器页面上启用它们。
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?