agentCLAWHUBUnverified

Temu美国站-上架商品

Temu 美国站发品(Add Product)API,经 LinkFox 网关转发 Partner US 商品接口:V2发品(temu.local.goods.v2.add)、类目属性、规格、图片上传、商品列表/详情/编辑、类目映射、SKU库存、供货价等。当用户提到 Temu 美国站发品、Temu US Add Product、goods.list、goods.detail、temu.local.goods.v2.add、商品类目映射、SKU库存、供货价、Partner US 发品文档 时触发。订单/物流请用其他 Temu skill。

OpenClaw

Rank

62

Safety

84

Downloads

1.3k

Updated

Oct 10, 2026

Version

1.0.6

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.3K downloadsadoption · observed Oct 10, 2026
Latest release
1.0.6release · observed Aug 14, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-add-product-us
  1. Install using `clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-add-product-us` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-add-product-us/snapshot"

Documentation

CLAWHUB

152,759 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-temu-add-product-us
description: Temu 美国站发品(Add Product)API,经 LinkFox 网关转发 Partner US 商品接口:V2发品(temu.local.goods.v2.add)、类目属性、规格、图片上传、商品列表/详情/编辑、类目映射、SKU库存、供货价等。当用户提到 Temu 美国站发品、Temu US Add Product、goods.list、goods.detail、temu.local.goods.v2.add、商品类目映射、SKU库存、供货价、Partner US 发品文档 时触发。订单/物流请用其他 Temu skill。
---

# Temu 美国站发品 API(Partner US)

本 skill(`linkfox-temu-add-product-us`)覆盖 Partner Platform for US **Product** 菜单(`menu_code=fb16b05f7a904765aac4af3a24b87d4a`)下 **19 个商品接口**:**4 个 V2 推荐发品** + **15 个标准商品 API**(查询、编辑、类目、库存、价格等)。

**网关(本 skill 内置)**:

| 能力 | 方法 | 网关路径 |
|------|------|----------|
| 商品 OpenAPI(全部 `us_goods_*`、`temu_us_proxy`) | POST | `https://tool-gateway.linkfox.com/temu/proxy` |
| 加签文件下载(`temu_us_file_download`) | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |

商品 `type` 写在 Body,**不是** URL 路径。

> **不是订单 skill**:订单、发货、物流见 `linkfox-temu-order-us` 或其它履约类 skill。

## 调用方式

- **API 端点**:`POST /temu/proxy`(不同操作通过请求体区分;完整参数/响应/错误码见 `references/api.md`)
- **Python 脚本**:`python scripts/<脚本名>.py '<JSON 参数>' [--inline]`(可用脚本见上文脚本一览)
- **成本约束**:本工具会消耗积分;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。

**输出策略(脚本默认行为)**:
- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-add-product-us-<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 进入上下文。

## 解决认证和积分问题
发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

### 异常情况
- **未配置API Key**:环境变量未配置 `LINKFOX_AGENT_API_KEY`,也未配置 `LINKFOXAGENT_API_KEY`。
- **响应401或402状态码**
- **响应提示积分或余额不足**:消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

## 默认参数

| 字段 | 默认 | 说明 |
|------|------|------|
| site | `us` | Partner US |
| managementType | `semi-managed` | 半托管 |
| tokenPurpose(storeKey) | `product-inventory` | 酷鸟卖家助手 token |

## 鉴权

1. **LinkFox**:`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`
2. **Temu**:`accessToken` 或 `storeKey`

## Scripts

### V2 推荐发品

| 脚本 | type |
|------|------|
| `us_goods_attrs.py` | `temu.local.product.attributes.get` |
| `us_goods_variation.py` | `temu.local.product.variation.get` |
| `us_goods_image_upload.py` | `temu.local.goods.image.v2.upload` |
| `us_goods_add.py` | `temu.local.goods.v2.add` |

### 查询 / 编辑 / 类目 / 库存

| 脚本 | type |
|------|------|
| `us_goods_list.py` | `temu.goods.list.get` |
| `us_goods_detail.py` | `temu.goods.detail.get` |
| `us_goods_update.py` | `temu.goods.update` |
| `us_goods_edit_property.py` | `temu.goods.edit.property` |
| `us_goods_edit_sensitive.py` | `temu.goods.edit.sensitive.attr` |
| `us_goods_migrate.py` | `temu.goods.migrate` |
| `us_goods_cats.py` | `bg.goods.cats.get` |
| `us_goods_attrs_bg.py` | `bg.goods.attrs.get` |
| `us_goods_parent_spec.p

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-temu-add-product-us",
  "version": "1.0.6",
  "publishedAt": 1786720270857
}

references/access-token.md

# Temu accessToken 授权与获取

Temu **没有** LinkFox 侧自动 OAuth;`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`(LinkFox 用户鉴权)是两套令牌。

## 两种鉴权(勿混淆)

| 令牌 | 用途 | 获取方式 |
|------|------|----------|
| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`;Header `Authorization` + `Token`(同 amazon-store-auth)(如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理) |
| **Temu accessToken** | Temu 业务 API(经紫鸟转发) | Temu 卖家后台授权后复制 |

```bash
export LINKFOXAGENT_API_KEY="<your-key>"
python scripts/check_linkfox_token.py
```

## tokenPurpose 与场景

| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |
|--------------|----------|-----------|----------|
| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |
| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |
| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |
| `local-native` | 本土(美/欧主体) | `us` 等 | Cyber-ERP |

## 1. 半托管 — 商品/库存 Token

1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)
2. **系统管理** → **服务市场** → **授权管理**
3. **获取授权** → 选择 **「酷鸟卖家助手」**
4. 全选常规和特殊授权 → 确认 → **复制 access_token**
5. 调用 API:`site=cn` 或 `partner`,`managementType=semi-managed`

## 2. 半托管 — 订单/发货 Token

1. 登录 Temu 卖家后台
2. 右上角 **Seller Central** → 切换到目标区域(美区 / 欧区 / 全球)
3. **服务市场** → **授权管理**
4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**
5. 全选授权 → 确认 → 复制 token
6. 调用 API:`site=us` / `global` / `eu`,`managementType=semi-managed`

## 3. 全托管店铺

1. 登录 Temu 平台
2. **系统管理** → **服务市场** → **授权管理**
3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token
4. 调用 API:`managementType=full-managed`,`site` 通常 `cn` 或 `partner`

## 4. 本土店铺(美区、欧区主体)

1. 登录 Temu
2. **Apps And Services** → **Manage Your Apps**
3. **Authorize a new app** → 搜索 **「Cyber-ERP」**
4. 一般权限与敏感权限全选 → 确认 → 复制 token

## 站点与 OpenAPI 网关

| site | 说明 | Temu 网关 |
|------|------|-----------|
| cn | 中国站 | openapi.kuajingmaihuo.com |
| partner | Partner 网关 | openapi-b-partner.temu.com |
| us | 美国站 | openapi-b-us.temu.com |
| global | 全球区 | openapi-b-global.temu.com |
| eu | 欧洲站 | openapi-b-eu.temu.com |

## 本地保存 Token(推荐)

默认存储:`~/.linkfox/temu-access-tokens.json`(可用 `TEMU_TOKEN_STORE_PATH` 覆盖)。

```bash
# 查看授权步骤
python scripts/temu_token_guide.py '{"shopType":"semi-managed","tokenPurpose":"product-inventory","site":"cn"}'

# 保存 token
python scripts/save_temu_access_token.py '{
  "storeKey": "my-shop",
  "label": "中国半托管",
  "site": "cn",
  "managementType": "semi-managed",
  "tokenPurpose": "product-inventory",
  "accessToken": "PASTE_TOKEN"
}'

# 列出已保存(脱敏)
python scripts/list_temu_access_tokens.py

# 用 storeKey 调 API(无需每次粘贴 token)
python scripts/temu_proxy.py '{
  "storeKey": "my-shop",
  "site": "cn",
  "managementType": "semi-managed",
  "tokenPurpose": "product-inventory",
  "type": "bg.goods.category.mapping",
  "params": {"goodsName": "测试", "goodsNameEn": "Test"}
}'
```

## 注意事项

1. **子账号**:可能无法进入服务市场,需主账号授权。
2. **多站点**:美国站、英国站等需分别登录对应后台获取 Token。
3. **有效期**:Token 会过期,过期后重新在后台复制并 `save_

references/api.md

# linkfox-temu-add-product-us — API 参考

Temu **美国站商品发布**(Partner US **Product > Add Products > Recommended V2 Interfaces**),经本 skill `temu_us_proxy`(`POST /temu/proxy`) 转发。Temu 的 `type` 写在 Body,**不是** URL 路径。

> 网关与鉴权:本 skill `scripts/`(`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`)。授权步骤见同仓库 `references/access-token.md`。

---

## 调用规范

| 项 | 说明 |
|----|------|
| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`(可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖) |
| 商品 OpenAPI | `POST /temu/proxy` |
| 加签文件下载 | `POST /temu/fileDownload`(`temu_us_file_download.py`) |
| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**(同值);或环境变量 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`;或 JSON `token` / `linkfoxToken`(如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理) |
| Temu 鉴权 | Body `accessToken`,或 `storeKey` + `site` + `managementType` + `tokenPurpose` |
| 默认 | `site=us`,`managementType=semi-managed`,`tokenPurpose=product-inventory` |
| 上游 OpenAPI(US) | `https://openapi-b-us.temu.com/openapi/router`(由网关按 `site` 解析,调用方勿直连) |

### 网关请求 Body(`/temu/proxy`)

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | `us`(本 skill 默认);半托跨境发品偶用 `cn` / `partner` |
| managementType | string | 是 | `semi-managed` |
| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌,最长约 8192 |
| storeKey | string | 与 accessToken 二选一 | 本地 `~/.linkfox/temu-access-tokens.json` 中的店铺键 |
| tokenPurpose | string | 否 | 建议 `product-inventory`(酷鸟卖家助手) |
| type | string | 是 | Temu 接口名,如 `temu.local.goods.v2.add` |
| params | object | 否 | 业务参数,结构见下文各接口文档 |

### 网关响应

| 字段 | 类型 | 说明 |
|------|------|------|
| body | string | Temu 原始 JSON **字符串**;脚本会尽量解析为 `temuBody` |
| code | integer | 网关错误码(非 Temu 业务码),如 `1002` 参数/用户 Token 无效,`1003` 转发失败 |

解析顺序:**先看网关 `code`/`message`** → 再 `JSON.parse(body)` → 读 Temu 层 `success`、`errorCode`、`errorMsg`、`result`。

### Temu 业务响应信封(`body` 解析后)

| 字段 | 类型 | 说明 |
|------|------|------|
| success | boolean | 是否成功 |
| errorCode | integer | 业务错误码;`1000000` 或 `0` 常表示成功(以实网为准) |
| errorMsg | string | 错误说明,成功时多为空 |
| requestId | string | 请求追踪 ID |
| result | object | 业务数据,结构因 `type` 而异 |

### curl 示例(经网关)

```bash
curl -X POST https://tool-gateway.linkfox.com/temu/proxy \
  -H "Authorization: $LINKFOXAGENT_API_KEY" \
  -H "Token: $LINKFOXAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "us",
    "managementType": "semi-managed",
    "accessToken": "TEMU_PRODUCT_TOKEN",
    "type": "temu.local.product.attributes.get",
    "params": { "catId": 12345 }
  }'
```

### 脚本调用

```bash
export LINKFOXAGENT_API_KEY="<key>"
python scripts/us_goods_attrs.py '{"accessToken":"TOKEN","params":{"catId":12345}}'
```

业务字段可放在顶层或嵌套 `params`;脚本会通过 `extract_business_params` 提取后写入网关 Body 的 `params`。

---

## 接口一览

共 **19** 个商品接口(4 V2 + 15 标准),完整 `sub_menu_code` 对照见 [partner-us-catalog.md](./partner-us-catalog.md)。

| 分组 | 文档 |
|------|------|
| 查询(list / detail) | 

references/authorization-flow.md

# Temu 授权流程

```text
用户确认店铺类型与用途
        ↓
temu_token_guide.py(输出后台操作步骤)
        ↓
用户在 Temu 卖家后台复制 access_token
        ↓
save_temu_access_token.py(可选,写入本地 store)
        ↓
temu_proxy.py / temu_file_download.py
  - 直接传 accessToken,或
  - 传 storeKey + site + managementType + tokenPurpose
```

## 决策表

| 用户需求 | shopType | tokenPurpose | site |
|----------|----------|--------------|------|
| 半托管查商品/库存 | semi-managed | product-inventory | cn / partner |
| 半托管查订单/发货 | semi-managed | order-shipping | us / global / eu |
| 全托管任意接口 | full-managed | full-managed | cn / partner |
| 美欧本土店 | local-native | local-native | us 等 |

## 与 API 调用的对应关系

紫鸟转发路径:`/temu-proxy/{site}/{managementType}`

- 全托管 CN:`cn` + `full-managed`
- 半托管商品:`cn`/`partner` + `semi-managed` + 商品 token
- 半托管订单:`us`/`global`/`eu` + `semi-managed` + 订单 token

授权应用名称必须与后台一致:**酷鸟卖家助手** 或 **Cyber-ERP酷鸟助手** / **Cyber-ERP**。
Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/linkfox-ai/skills/linkfox-temu-add-product-us",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/skills/linkfox-temu-add-product-us",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T16:31:36.837Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-add-product-us/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-add-product-us/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T16:31:36.837Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.3K downloads",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T16:31:36.837Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.6",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-14T15:11:10.857Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-add-product-us/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-add-product-us/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.6",
      "description": "Update from 1.0.5 to 1.0.6",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-add-product-us",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-14T15:11:10.857Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Temu美国站-上架商品 and adjacent AI workflows.