What makes TikTok官方-达人API notable?

1.1K downloads. Trust evidence available

How should TikTok官方-达人API be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

TikTok官方-达人API

TikTok 达人（Creator/affiliate creator）数据与可购物视频技能，经 LinkFox 网关代理调用 TikTok Shop 达人开放接口：达人主页/档案、达人绑定店铺商品、橱窗商品、可购物视频的上传/内容预检/发布/发布状态查询。需要达人 access_token（user_type=1），由 linkfox-tiktok-video-auth 完成达人授权后取得。当用户提到 TikTok 达人、TikTok creator、达人主页、达人档案、达人资料、达人店铺商品、达人绑定店铺商品、达人橱窗商品、showcase 商品、上传可购物视频、发布可购物视频、视频发布状态、视频内容预检、shoppable video、affiliate creator、TikTok 带货达人信息、TikTok creator profile、shop products、showcase products、post shoppable video、video status、precheck 时触发此技能。即使用户未写 EHunt/紫鸟，只要需求是查 TikTok Shop 达人的资料、绑定商品或可购物视频带货操作，也应触发。**不含达人授权**（授权请用 linkfox-tiktok-video-auth）。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 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.1K downloads reported by the source. Last updated 10/11/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 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.6release · observed Aug 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-tiktok-creator

Install using `clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-tiktok-creator` 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-tiktok-creator before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-tiktok-creator/snapshot"

Documentation

CLAWHUB

142,841 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-tiktok-creator
description: TikTok 达人（Creator/affiliate creator）数据与可购物视频技能，经 LinkFox 网关代理调用 TikTok Shop 达人开放接口：达人主页/档案、达人绑定店铺商品、橱窗商品、可购物视频的上传/内容预检/发布/发布状态查询。需要达人 access_token（user_type=1），由 linkfox-tiktok-video-auth 完成达人授权后取得。当用户提到 TikTok 达人、TikTok creator、达人主页、达人档案、达人资料、达人店铺商品、达人绑定店铺商品、达人橱窗商品、showcase 商品、上传可购物视频、发布可购物视频、视频发布状态、视频内容预检、shoppable video、affiliate creator、TikTok 带货达人信息、TikTok creator profile、shop products、showcase products、post shoppable video、video status、precheck 时触发此技能。即使用户未写 EHunt/紫鸟，只要需求是查 TikTok Shop 达人的资料、绑定商品或可购物视频带货操作，也应触发。**不含达人授权**（授权请用 linkfox-tiktok-video-auth）。
---

# TikTok 达人（Creator）数据

本 skill 通过 **LinkFox 网关 → 紫鸟代理 → TikTok Shop 达人(affiliate_creator)开放接口**，提供 TikTok 带货达人的数据查询（达人资料、绑定店铺商品、橱窗商品）与可购物视频带货操作（上传、内容预检、发布、状态查询）。全部接口收录在 `references/api.md`。

> 📌 **前置依赖**：本 skill 需要 **达人 access_token（`user_type=1`）**。请先用 **`linkfox-tiktok-video-auth`** 完成达人授权，经 `/tiktokVideo/accountTokens` 取得 `accessToken`，再作为本 skill 调用的 `ttsAccessToken` 传入。**勿使用** `linkfox-tiktok-shop-auth`（`/tiktokShop`）做达人授权。

## Core Concepts

- **调用链路**：业务请求统一经 LinkFox 网关的 **`/tiktokShop/developerProxy`** 转发：传入 **`appType=creator`**、TikTok Shop API 的相对 `path`（如 `affiliate_creator/202508/profiles`）、`method` 与达人令牌 `ttsAccessToken`；紫鸟自动注入 `app_key` / `timestamp` / `sign`，并透传 TikTok 原始响应。达人接口的 `appType` 必须为 `creator`（脚本已默认）。
- **达人令牌**：`ttsAccessToken` 为达人 access_token（`user_type=1`），来自 **`linkfox-tiktok-video-auth`**。令牌过期时回到该 skill 刷新。
- **响应透传**：网关返回 `httpStatus` / `contentType` / `body`，其中 `body` 为 TikTok 原始 JSON 字符串；TikTok 业务层的成功/失败以其 `code` / `message` 为准。

## 调用方式

- **API 端点**：`POST /tiktokShop/developerProxy`（完整参数/响应/错误码见 `references/api.md`）
- **Python 脚本**：`python scripts/creator_proxy.py '<JSON 参数>' [--inline]`
- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

**输出策略（脚本默认行为）**：
- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-tiktok-creator-<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 进入上下文。

### Available Scripts

- `scripts/creator_proxy.py` — 通用达人接口代理：按 `path` + `method` + `ttsAccessToken` 调用任意已收录的达人接口。

### 已收录接口

| 能力 | 上游 path | Method |
|------|-----------|--------|
| 获取达人主页/档案（Get Creator Profile） | `affiliate_creator/202508/profiles` | GET |
| 搜索达人绑定店铺的商品（Get Shop Products） | `affiliate_creator/202509/shop_products` | GET |
| 达人橱窗商品列表（Get Showcase Products） | `affiliate_creator/202405/showcases/products` | GET |
| 上传可购物视频文件（Upload Shoppable Video File，multipart） | `affiliate_creator/202505/videos/video_files` | POST |
| 发布可购物视频（Post Shoppable Video） | `affiliate_creator/202603/videos` | POST |
| 查询可购物视频发布状态（Get Shoppable Video Status） |

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-tiktok-creator",
  "version": "1.0.6",
  "publishedAt": 1786720821826
}

references/api.md

# TikTok 达人（Creator）API Reference

本文档收录 TikTok Shop **达人（affiliate_creator）** 开放接口，经 LinkFox 网关 `/tiktokShop/developerProxy` 代理调用。接口随提示文档逐步补充。

## Calling Conventions

- **网关代理端点**：`POST /tiktokShop/developerProxy`
- **Base URL**：`${LINKFOX_TOOL_GATEWAY}`（默认；可用环境变量 `TIKTOK_SHOP_API_BASE_URL` 覆盖）
- **Content-Type**：`application/json`
- **网关鉴权**：Header `Authorization: <api_key>`，读取环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）
- **达人令牌**：`ttsAccessToken` = 达人 access_token（`user_type=1`），由 `linkfox-tiktok-video-auth` 授权获得，对应上游请求头 `x-tts-access-token`
- **签名**：上游 `app_key` / `timestamp` / `sign` 由紫鸟代理自动注入，调用方**无需**传

### developerProxy 入参（通用）

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| path | string | 是 | TikTok Shop API 相对路径（不含 tiktok-proxy 前缀），见下方各接口 |
| method | string | 是 | `GET` / `POST` / `PUT` / `DELETE` |
| ttsAccessToken | string | 是 | 达人 access_token（user_type=1） |
| queryString | string | 否 | 查询字符串（不含 `?`） |
| body | string | 否 | POST/PUT 请求体（字符串；当前仅支持文本/JSON，详见下方上传说明） |
| appType | string | 否 | 代理侧应用类型，正则 `^(erp\|creator)$`，默认 `erp`。**达人(affiliate_creator)接口须传 `creator`**（脚本默认已置为 `creator`） |
| region | string | 否 | 默认 `global` |
| contentType | string | 否 | 默认 `application/json` |

> **重要**：所有达人接口（`path` 以 `affiliate_creator/` 开头）调用 `developerProxy` 时 **`appType` 必须为 `creator`**；脚本 `creator_proxy.py` 已默认置为 `creator`。

### developerProxy 返回（通用）

| 字段 | 类型 | 说明 |
|------|------|------|
| httpStatus | integer | 上游 HTTP 状态码 |
| contentType | string | 响应 Content-Type |
| body | string | TikTok Shop API 原始响应正文（JSON 字符串） |

---

## 1. Get Creator Profile（获取达人主页/档案）

- **上游接口**：`GET /affiliate_creator/202508/profiles`
- **用途**：获取达人的主页/档案信息（creator profile）。
- **达人令牌**：需 `user_type=1` 的达人 access_token（`x-tts-access-token`）。

### 上游请求

**Header**

| 字段 | 必填 | 类型 | 说明 |
|------|------|------|------|
| content-type | 是 | string | `application/json` |
| x-tts-access-token | 是 | string | 达人 access_token（user_type=1），即 `ttsAccessToken` |

**Query**

| 字段 | 必填 | 类型 | 说明 |
|------|------|------|------|
| app_key | 是 | string | 应用 key —— **由紫鸟代理自动注入** |
| sign | 是 | string | 签名 —— **由紫鸟代理自动注入** |
| timestamp | 是 | int | Unix 时间戳（GMT/UTC+0）—— **由紫鸟代理自动注入** |

> 该接口无业务 Query/Path 入参；经本 skill 调用时只需提供 `ttsAccessToken`。

### 通过 developerProxy 调用

```json
{
  "appType": "creator",
  "path": "affiliate_creator/202508/profiles",
  "method": "GET",
  "ttsAccessToken": "TTP_xxxxx"
}
```

### 上游响应

| 字段 | 类型 | 说明 |
|------|------|------|
| code | int | 业务状态码（成功/失败） |
| message | string | 业务消息；失败时说明原因 |
| request_id | string | 请求日志 ID |
| data | object | 达人档案信息（具体字段以接口实际返回为准） |

> 说明：上游文档的 `data` 字段明细未在本次抓取中展开，**以接口实际返回为准**，必要时落盘后用 `response_io.py read` 查看 `body` 内的字段。

### 错误码

| Code | Message |
|------|---------|
| 16015006 | 该达人当前无选品区域，请联系达人确认已开通 EC 权限 |
| 16015007 | 无销售区域错误：达人没有销售区域 |
| 16501011 | 用户无权限访问该接口，请检查达人授权信息 |
| 16504002 | 查询达人信息失败，请检查达人 EC 权限是否可用 |
| 36009002 | 请求过于频繁（限流），请稍后重试 |
| HTTP 402 | H

references/onboarding.md

# 解决认证和积分问题

调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。

**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。
1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册
2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册
3. 手机号路径：
   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements
   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）
   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：
     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY "<key>"`
     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.zshrc && source ~/.zshrc`
     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.bashrc && source ~/.bashrc`
     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可

**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。
- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选
- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）
- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）
- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询

排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。

skill-card.md

## Description:

Provides LinkFox-proxied TikTok Shop creator data queries and shoppable-video operations, including creator profiles, shop and showcase products, content pre-checks, posting, and status checks.

This skill is ready for commercial/non-commercial use.

## Publisher:

[linkfox-ai](https://clawhub.ai/user/linkfox-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External developers and commerce operators use this skill to query TikTok Shop creator profile, shop product, and showcase product data, then guide supported shoppable-video pre-check, posting, and status workflows after a creator access token is available.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can handle creator access tokens, LinkFox API keys, and SMS login data.

Mitigation: Use a dedicated environment, mask tokens in user-facing output, and remove shell-profile API keys when they are no longer needed.

Risk: The onboarding flow can create paid plan orders and render payment information.

Mitigation: Confirm billing intent, plan selection, and payment method explicitly before running order commands.

Risk: Supported workflows may publish public shoppable videos or submit content for pre-check.

Mitigation: Confirm publishing actions, target products, titles, and media inputs before invoking posting or pre-check calls.

Risk: Complete API responses and cache entries may be written to local files.

Mitigation: Clean up local response and cache files after use, especially when responses may contain creator or account data.

Risk: The artifact describes automatic external feedback reporting for mismatches or quality issues.

Mitigation: Avoid including secrets, creator tokens, personal data, or unnecessary business data in feedback reports.

## Reference(s):

- [TikTok Creator API Reference](references/api.md)
- [Authentication and Billing Onboarding](references/onboarding.md)
- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-tiktok-creator)

## Skill Output:

**Output Type(s):** [text, JSON, files, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with shell commands and JSON API responses, with full responses saved as local JSON files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Small responses are printed inline; larger responses are summarized and saved locally. The proxy script uses a 24-hour local cache for repeated parameter sets.]

## Skill Version(s):

1.0.6 (source: server release evidence, released 2026-08-14)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

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.