用途
linkfox-temu-fulfillment-global 用于 Temu 全球站(非 US/EU)的电商履行与发货场景,覆盖 Partner Global Fulfillment 域已接入的 23 个 type。美国站请使用 linkfox-temu-fulfillment-us,欧洲站请使用 linkfox-temu-fulfillment-eu。
主要能力
按域划分如下:
- Buy-Shipping(脚本前缀 global_buy_shipping_*,13 个接口):购标、面单、上门揽收等,不含 Scan Form。
- Co-Warehouse(脚本前缀 global_co_warehouse_,4 个接口):bg.cooperativewarehouse.,合作仓授权、提交/取消履约。
- Self-Fulfilled(脚本前缀 global_self_fulfilled_,5 个接口):bg.logistics.shipment.v2.、shippingtype.update 等,卖家自带运单号。
- Tracking(脚本前缀 global_tracking_*,1 个接口):temu.track.trackinginfo.get。
未接入(相对 US 版):temu.logistics.scanform.create、temu.logistics.scanform.get、temu.logistics.scanform.document.get、temu.logistics.candidate.scanform.list.get,请改用 linkfox-temu-fulfillment-us(site=us)。
使用方式
网关:
- 履约 OpenAPI:POST https://tool-gateway.linkfox.com/temu/proxy
- 加签文件下载:POST https://tool-gateway.linkfox.com/temu/fileDownload
调用方式:
- API 端点:POST /temu/proxy,不同操作通过请求体区分;完整参数、响应与错误码见 references/api.md。
- Python 脚本:python scripts/<脚本名>.py '<JSON 参数>' [--inline],可用脚本见脚本一览。
通用脚本:
- temu_global_proxy.py:任意 type。
- temu_global_file_download.py:加签文件下载。
两者为薄封装,统一调用 _global_fulfillment_script.run_cli。
默认参数:site 为 global,managementType 为 semi-managed,tokenPurpose 为 order-shipping。
示例:
export LINKFOXAGENT_API_KEY="<key>"
Buy-Shipping 购标
python scripts/global_buy_shipping_logistics_shipment_create.py '{ "accessToken": "TOKEN", "site": "global", "tokenPurpose": "order-shipping", "request": { } }'
卖家自发货更新跟踪号
python scripts/global_self_fulfilled_logistics_shipment_shippingtype_update.py '{ "accessToken": "TOKEN", "site": "global", "tokenPurpose": "order-shipping", "request": { "editPackageRequestList": [{ "packageSn": "PKG-1", "trackingNumber": "1Z..." }] } }'
输出策略(脚本默认行为):
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json;<cwd> 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<session> 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错。
- 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout。
- 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)。
- 加 --inline 强制全量打印到 stdout(同样落盘)。
读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
适用场景
- Temu 全球站(非 US/EU)的购标、面单与上门揽收。
- 合作仓授权与履约提交/取消。
- 卖家自发货运单号更新。
- 物流跟踪信息查询。
相关 skill:订单列表/详情/地址用 linkfox-temu-order-global;取消订单用 linkfox-temu-cancel-order-global;商品管理用 linkfox-temu-manage-product-global;美国站履约(含 Scan Form)用 linkfox-temu-fulfillment-us;欧洲站履约用 linkfox-temu-fulfillment-eu;退货退款用 linkfox-temu-returns-refunds-global。
限制
- 不含 4 个 Scan Form 接口,需改用美国站技能。
- 成本约束:本工具会消耗算力;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。
- 算力消耗规则:不消耗算力。
- 认证与算力问题:未配置 API Key(环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY)、响应 401 或 402 状态码、响应提示算力或余额不足(消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"或类似含义内容)时,采用 references/onboarding.md 引导解决。
Feedback:skillName:linkfox-temu-fulfillment-global