agentCLAWHUBUnverified
Temu全球站-广告
Temu 全球站电商广告 Ads API，经 LinkFox 网关转发 Partner Global Ads / 广告投放 相关 bg/temu 接口（广告计划、广告组、创意、报表、预算出价等，接口将按 Partner 文档逐条接入）。当用户提到 Temu Global 广告、Ads、广告投放、广告计划、广告组、创意、出价、预算、广告报表、ad campaign、product-inventory 广告 时触发。商品管理用 linkfox-temu-manage-product-global；促销用 linkfox-temu-promotion-global；订单用 linkfox-temu-order-global。
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-ads-global- Install using `clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-ads-global` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-ads-global/snapshot"
Documentation
CLAWHUB
152,911 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: linkfox-temu-ads-global description: Temu 全球站电商广告 Ads API，经 LinkFox 网关转发 Partner Global Ads / 广告投放 相关 bg/temu 接口（广告计划、广告组、创意、报表、预算出价等，接口将按 Partner 文档逐条接入）。当用户提到 Temu Global 广告、Ads、广告投放、广告计划、广告组、创意、出价、预算、广告报表、ad campaign、product-inventory 广告 时触发。商品管理用 linkfox-temu-manage-product-global；促销用 linkfox-temu-promotion-global；订单用 linkfox-temu-order-global。 --- # Temu 全球站 — 电商广告（Ads） 本 skill（`linkfox-temu-ads-global`）覆盖 Partner Platform for Global **Ads / 电商广告**（广告计划、投放、报表等；`menu_code` 与各 `sub_menu_code` 以 Partner 后台为准，见 [partner-global-catalog.md](./references/partner-global-catalog.md)）。 已接入 **7** 条 Partner **Ads**（`temu.searchrec.ad.*`）接口，清单见 [partner-global-catalog.md](./references/partner-global-catalog.md)。 **网关（本 skill 内置）**： | 能力 | 方法 | 路径 | |------|------|------| | 广告 OpenAPI（`global_ads_*`、`temu_global_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` | | 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` | ## 相关 skill | 场景 | skill | |------|--------| | **广告 Ads**（本 skill） | **`linkfox-temu-ads-global`** | | 商品列表/详情/编辑/库存/上下架 | `linkfox-temu-manage-product-global` | | 促销/营销活动 | `linkfox-temu-promotion-global` | | 发品 | `linkfox-temu-add-product-us` | | 价格/供货价、定价单 | `linkfox-temu-price-global` | | 订单列表/详情 | `linkfox-temu-order-global` | | 退货与退款 | `linkfox-temu-returns-refunds-global` | | 网关与 Temu token | 本 skill `scripts/` | ## 调用方式 - **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`） - **Python 脚本**：`python scripts/<脚本名>.py '<JSON 参数>' [--inline]`（可用脚本见上文脚本一览） - **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。 **输出策略（脚本默认行为）**： - **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-ads-global-<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 | `global` | Partner Global | | managementType | `semi-managed` | 半托管（具体接口以 Partner 文档为准） | | tokenPurpose | `product-inventory` | 卖家助手默认（若 Partner 某 Ads 接口要求其他 `tokenPurpose`，以该接口文档为准） | ## 鉴权 1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token` 2. **Temu**：`accessToken` 或 `storeKey`（`storeKey` 时建议带 `tokenPurpose=product-inventory`） ## Scripts | 脚本 | 说明 | |------|------| | `temu_global_proxy.py` | 任意 type | | `temu_global_file_download.py` | 加签下载 | | `global_ads_searchrec_ad_roas_pred.py` | `temu.searchrec.ad.roas.pred` | | `global_ads_searchrec
references/apis/README.md
# Ads — 接口文档索引 网关见 [../api.md](../api.md)；目录见 [../partner-global-catalog.md](../partner-global-catalog.md)。 ## 查询 / 预测 | type | 说明 | 文档 | |------|------|------| | `temu.searchrec.ad.roas.pred` | 广告 ROAS 预测 | [temu-searchrec-ad-roas-pred.md](./apis/temu-searchrec-ad-roas-pred.md) | | `temu.searchrec.ad.goods.create.query` | 广告可创建商品查询 | [temu-searchrec-ad-goods-create-query.md](./apis/temu-searchrec-ad-goods-create-query.md) | ## 创建 / 修改 | type | 说明 | 文档 | |------|------|------| | `temu.searchrec.ad.create` | 创建广告 | [temu-searchrec-ad-create.md](./apis/temu-searchrec-ad-create.md) | | `temu.searchrec.ad.modify` | 修改广告 | [temu-searchrec-ad-modify.md](./apis/temu-searchrec-ad-modify.md) | ## 报表 / 日志 | type | 说明 | 文档 | |------|------|------| | `temu.searchrec.ad.reports.mall.query` | 店铺广告报表查询 | [temu-searchrec-ad-reports-mall-query.md](./apis/temu-searchrec-ad-reports-mall-query.md) | | `temu.searchrec.ad.detail.query` | 广告详情查询 | [temu-searchrec-ad-detail-query.md](./apis/temu-searchrec-ad-detail-query.md) | | `temu.searchrec.ad.log.query` | 广告操作日志查询 | [temu-searchrec-ad-log-query.md](./apis/temu-searchrec-ad-log-query.md) |
_meta.json
{
"ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
"slug": "linkfox-temu-ads-global",
"version": "1.0.6",
"publishedAt": 1786720305395
}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=global` / `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-global.temu.com |
| global | 全球区 | openapi-b-global.temu.com |
| eu | 全球站 | openapi-b-global.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 会过期，过期后重新在references/api.md
# linkfox-temu-ads-global — API 参考
Temu **全球站电商广告（Ads）**，经本 skill `temu_global_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_global_file_download.py`） |
| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |
| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |
| 默认 | `site=global`，`managementType=semi-managed`，`tokenPurpose=product-inventory` |
| 上游 OpenAPI（Global） | `https://openapi-b-global.temu.com/openapi/router`（网关按 `site` 解析） |
### 网关请求 Body（`/temu/proxy`）
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | `global`（本 skill 默认） |
| managementType | string | 是 | `semi-managed` |
| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |
| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |
| tokenPurpose | string | 否 | 建议 **`product-inventory`**（以各 Ads 接口 Partner 文档为准） |
| type | string | 是 | Temu 接口名，如 Partner **Ads** 菜单下的 `bg.*` / `temu.*` |
| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |
### 网关响应
| 字段 | 类型 | 说明 |
|------|------|------|
| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |
| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |
解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。
### 脚本调用
```bash
export LINKFOXAGENT_API_KEY="<key>"
python scripts/temu_global_proxy.py '{"accessToken":"TOKEN","tokenPurpose":"product-inventory","type":"<API_TYPE>","params":{"request":{}}}'
```
业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。
---
## 接口一览
完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-global-catalog.md](./partner-global-catalog.md)。
**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。
| type | 说明 | 文档 |
|------|------|------|
| `temu.searchrec.ad.roas.pred` | 广告 ROAS 预测 | [apis/temu-searchrec-ad-roas-pred.md](./apis/temu-searchrec-ad-roas-pred.md) |
| `temu.searchrec.ad.reports.mall.query` | 店铺广告报表查询 | [apis/temu-searchrec-ad-reports-mall-query.md](./apis/temu-searchrec-ad-reports-mall-query.md) |
| `temu.searchrec.ad.create` | 创建广告 | [apis/temu-searchrec-ad-create.md](./apis/temu-searchrec-ad-create.md) |
| `temu.searchrec.ad.detail.query` | 广告详情查询 | [apis/temu-searchrec-ad-detail-query.md](./apis/temu-searchrec-ad-detail-query.md) |
| `temu.searchrec.ad.log.query` | 广告操作日志查询 | [apis/temu-searchrec-ad-log-query.md](./apis/temu-searchrec-ad-log-query.md) |
| `temu.searchrec.ad.goods.create.query` | 广告可创建商品查询 | [apis/temu-searchrec-ad-gooGithub 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-ads-global",
"sourceUrl": "https://clawhub.ai/linkfox-ai/skills/linkfox-temu-ads-global",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T17:41:34.082Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-ads-global/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-ads-global/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T17:41:34.082Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global",
"sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T17:41:34.082Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.6",
"href": "https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global",
"sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-14T15:11:45.395Z",
"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-ads-global/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-ads-global/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-ads-global",
"sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-temu-ads-global",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-14T15:11:45.395Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.