摘要
Temu 合作伙伴 API 适用于拥有本地商店的卖家:包含买家地址和金额的订单,使用自己的承运人和追踪号码确认发货,追踪、产品和 SKU、库存、基础价格、类别,以及退款、退货和取消请求。自开发的应用程序,具有 App Key、App Secret 和商店的访问令牌;调用已签名。
引导式设置
2 分钟将 Temu 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Temu,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Temu 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Temu,粘贴你的凭据,生成 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Temu + Cursor
Temu 合作伙伴 API 适用于拥有本地商店的卖家:包含买家地址和金额的订单,使用自己的承运人和追踪号码确认发货,追踪、产品和 SKU、库存、基础价格、类别,以及退款、退货和取消请求。自开发的应用程序,具有 App Key、App Secret 和商店的访问令牌;调用已签名。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
TEMU_REGION, TEMU_APP_KEY, TEMU_APP_SECRET, TEMU_ACCESS_TOKEN
第一步 — 获取凭据
设置大约需要 20 分钟。你需要 Temu 对你的应用程序的审核。
- 在 Temu 合作伙伴平台(美国使用 https://partner-us.temu.com,欧洲使用 https://partner-eu.temu.com,其他国家使用 https://partner.temu.com)创建一个帐户,选择合作伙伴类型 自开发应用卖家 并链接你的卖家中心 主账户。一个卖家中心账户可以拥有一个自开发的应用。
- 填写应用信息和合规性及安全性问卷。合规部分的第 5 问询问你的调用来源的 IP 地址:输入此 AnythingMCP 服务器的出站 IP 地址。只有这些地址可以调用 API,中国的云服务提供商不被接受,服务器必须位于商店所在的区域(美国商店使用美国地址,欧洲商店使用欧洲地址)。后续更改通过 编辑应用信息、仅 IP 地址列表和支持网站 进行,并再次审核。
- 审核通过后,将 App Key 复制到
TEMU_APP_KEY,将 App Secret 复制到TEMU_APP_SECRET,并在TEMU_REGION中选择商店的区域。 - 在卖家中心打开 系统管理,授权管理(https://seller.temu.com/open-platform/client-manage,欧洲使用 https://seller-eu.temu.com/open-platform/client-manage),点击 授权新应用,选择你的应用和权限,提交,并将 访问令牌 复制到
TEMU_ACCESS_TOKEN。
访问令牌会过期:卖家中心的授权列表显示日期,temu_get_token_info 将其作为 expiredTime 返回。再次授权并粘贴新令牌;AnythingMCP 不会自动续期。
从哪里开始:temu_get_token_info 显示商店(mallId,regionId)、过期时间和令牌可以调用的操作。然后是 temu_list_orders。
订单:temu_list_orders,temu_get_order,temu_get_order_shipping_address(买家地址,个人数据),temu_get_order_amount。购买是一个父订单(parentOrderSn,以 PO- 开头)和每个产品行的一个子订单(orderSn)。状态:1 待处理(尚未发货),2 待发货,3 已取消,4 已发货,41 部分发货,5 已送达,51 部分送达。
发货:使用 temu_list_carriers(传递区域 ID)读取承运人,使用 temu_list_warehouses 读取仓库,然后使用 temu_confirm_shipment 进行发货,传递承运人 ID、追踪号码、仓库 ID 和订单行。temu_list_combinable_orders 列出可以共享包裹的父订单。使用 temu_get_shipment 检查结果,并使用 temu_get_tracking 跟踪包裹。在发货前查看 temu_list_cancel_requests:temu_agree_cancel_request 默认关闭,因为它会取消订单并退款给买家。
产品、库存和价格:temu_list_products,temu_get_product,temu_list_skus,temu_list_categories。temu_get_stock 和 temu_update_stock 读取和更改每个 SKU 的库存。temu_list_sku_prices 读取基础价格,temu_change_sku_price 向 Temu 请求新的价格,temu_list_price_offers 跟踪请求;这两个价格订单工具仅适用于 Temu 已启用的商店。temu_set_sale_status(下架产品)默认关闭。
退款和退货:temu_list_after_sales 列出它们。退款、退货标签和退货决定不属于此连接器。
字段说明
- Ids:
goodsId是产品,skuId是变体,均为数字;outGoodsSn和outSkuSn是你自己的代码。订单号为文本。 - 订单和售后中的时间为 Unix 秒;产品列表的创建过滤器为 Unix 毫秒。
- 金钱是一个对象,包含
amount和currency。以整数形式给出的订单金额为货币的最小单位(分)。 - 答复包含
success、errorCode、errorMsg和result。连接器报告success: false作为调用失败。 - 速率限制:每个应用程序每秒 20 次调用;某些操作有自己的限制(产品列表 20 次,价格报价每秒 10 次)。错误 4000004 表示调用次数过多。
错误:3000001 签名错误(App Secret 不属于 App Key)。3000026 未知的 App Key。3000031 未知的访问令牌,3000033 令牌和 App Key 不匹配,3000034 令牌过期或被替换。3000032 卖家未授权此操作:再次授权并勾选权限。5000003 调用的 IP 地址不在应用的允许列表中。3000011 和 3000012:服务器时钟偏差超过 300 秒。
未覆盖:Temu 发货标签(Buy-Shipping)、取件、广告、促销、创建和编辑产品、退款。
第二步 — 安装适配器
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已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
Temu的工具。
可用工具
| 工具 | 功能 |
|---|---|
temu_get_token_info | 读取访问令牌代表的内容:mallId、mallType(1 半托管,100 本地)、商店的 regionId(211 是美国)… |
temu_list_orders | 列出订单,最新的在前。返回 totalItemNum 和 pageItems,每个包含 parentOrderMap(parentOrderSn、parentOrderStatus、parentOrderTime… |
temu_get_order | 读取一个父订单及其子订单:parentOrderMap(状态、订单、确认和最新发货时间、区域名称、支付… |
temu_get_order_shipping_address | 读取一个父订单的送货地址:receiptName、mobile、虚拟邮件地址、regionName1 到 regionName4(国家、州、市… |
temu_get_order_amount | 读取一个父订单的金额:销售收入(基础价格总额、卖家折扣、运费、产品和运费税、估计… |
temu_list_combinable_orders | 列出可以一起发货的父订单组(相同买家和地址):combinedShippingGroups,每个为一个列表… |
temu_list_warehouses | 列出商店的发货仓库:warehouseId、warehouseName、regionId1、defaultWarehouse、warehouseManagementType(0 合作,1… |
temu_list_carriers | 列出 Temu 接受的区域承运人:logisticsServiceProviderId(temu_confirm_shipment 的 carrierId)… |
temu_confirm_shipment | 使用自己的承运人和追踪号码标记订单为已发货:订单从待发货状态转为已发货,买家看到… |
temu_get_shipment | 读取一个订单的发货信息:shipmentInfoDTO 包含 carrierId、carrierName、trackingNumber、skuId、数量、packageSn… |
temu_get_tracking | 读取一个包裹的追踪事件:trackingNum(最后一公里号码)和 trackingInfo,每个包含 logisticsUpdatedAt(Unix 秒)… |
temu_list_products | 列出商店的产品。返回总数和 goodsList,包含 goodsId、goodsName、specName、outGoodsSn(你的产品代码)、状态和… |
temu_get_product | 读取一个完整的产品:goodsName、goodsDesc、bulletPoints、catId 和 catName、outGoodsSn、产品类型、画廊(轮播和详细… |
temu_list_skus | 列出跨产品的 SKU(变体)。返回总数和 skuList,包含 skuId、skuSn(你的 SKU 代码)、goodsId、goodsName、specName 和… |
temu_get_stock | 读取 SKU 的库存:每个 goodsId 的 stockList,包含 skuStockInfoList(skuId、outSkuSn、selfOrdinaryStock、selfPreSaleStock 和… |
temu_update_stock | 更改一个产品的 SKU 库存:设置为目标数量(targets)或增加和减少(changes)。返回… |
temu_list_sku_prices | 读取一个产品的 SKU 当前基础价格(Temu 支付给卖家的价格):按 SKU skuId 和 supplierPrice 及金额和… |
temu_list_price_offers | 列出价格报价(价格订单):Temu 的定价评估和价格变更请求,包含 priceOrderId、goodsId、skuIdList、pricingType… |
temu_change_sku_price | 请求 Temu 更改一个产品的 SKU 基础价格。返回 successSkuList、failedSkuList 和 failedSkuReasonMap,以及… |
temu_list_categories | 列出父类别下的类别:catId、catName、level、parentId、leaf(产品仅进入叶子类别)、catType 和… |
temu_set_sale_status | 将产品或其部分 SKU 下架,或重新上架。下架后,买家无法再订购。返回成功… |
temu_list_after_sales | 列出退款和退货请求。返回总数和数据,包含 parentAfterSalesSn、parentOrderSn、afterSalesType(1 仅退款,2 退货和… |
temu_list_cancel_requests | 列出买家在发货前请求取消订单的请求:总数和数据,包含 parentAfterSalesSn、parentAfterSalesStatus 和… |
temu_agree_cancel_request | 同意买家的请求以取消订单:订单被取消,买家由 Temu 退款。无法撤销。默认关闭… |
示例提示
- "哪些 Temu 订单等待发货,是否有可组合的订单?"
- "确认订单 PO-211-12345678901234 的发货,使用 UPS 追踪 1Z999AA10123456784。"
- "哪些 SKU 库存少于 10 个?"
- "在今天发货之前,我是否应该查看取消请求?"
- "我的 Temu 访问令牌何时过期?"
常见问题
凭据来自哪里? 来自 Temu 合作伙伴平台上的自开发应用程序:在 Temu 批准后,复制 App Key 和 App Secret。然后在卖家中心的授权管理中授权应用并粘贴访问令牌。令牌会过期;再次授权并粘贴新令牌。
Temu 是否限制调用来源? 是的。应用的问卷询问调用 API 的 IP 地址:输入你的 AnythingMCP 服务器的出站地址,必须位于商店所在的区域(美国或欧洲)。
哪些工具默认关闭? temu_agree_cancel_request,它会取消订单并退款给买家,以及 temu_set_sale_status,它会下架产品。仅在 AI 应该使用它们时在连接器页面上启用它们。
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?