TTokenySpace
返回 Skills 列表

TikTok官方-达人API

TikTok 达人（Creator/affiliate creator）数据与可购物视频技能，经 LinkFox 网关代理调用 TikTok Shop 达人开放接口：达人主页/档案、达人绑定店铺商品、橱窗商品、可购物视频的上传/内容预检/发布/发布状态查询。需要达人 access_token（user_type=...

#中文
下载 ZIP 来源页面
0

安装到 Tokeny（自动）

下载 ZIP
安装"linkfox-tiktok-creator"技能
技能信息：
- 名称: TikTok官方-达人API
- 标识: linkfox-tiktok-creator
- 描述: TikTok 达人（Creator/affiliate creator）数据与可购物视频技能，经 LinkFox 网关代理调用 TikTok Shop 达人开放接口：达人主页/档案、达人绑定店铺商品、橱窗商品、可购物视频的上传/内容预检/发布/发布状态查询。需要达人 access_token（user_type=...
- 版本: 1.0.0
下载地址：
https://www.tokeny.space/api/skills/linkfox-tiktok-creator/download
继续

复制上方内容到 Tokeny 客户端并在会话中发送即可自动安装；也可直接 下载 ZIP并拖动到技能窗口安装。

SKILL.md

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-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 调用任意已收录的达人接口。

已收录接口

能力上游 pathMethod
获取达人主页/档案（Get Creator Profile）affiliate_creator/202508/profilesGET
搜索达人绑定店铺的商品（Get Shop Products）affiliate_creator/202509/shop_productsGET
达人橱窗商品列表（Get Showcase Products）affiliate_creator/202405/showcases/productsGET
上传可购物视频文件（Upload Shoppable Video File，multipart）affiliate_creator/202505/videos/video_filesPOST
发布可购物视频（Post Shoppable Video）affiliate_creator/202603/videosPOST
查询可购物视频发布状态（Get Shoppable Video Status）affiliate_creator/202509/videos/{video_id}/statusGET
可购物视频内容预检（Pre-check Shoppable Video）affiliate_creator/202511/videos/precheck_taskPOST
查询视频预检结果（Get Shoppable Video Pre-check Result）affiliate_creator/202511/videos/precheck_tasks/{task_id}GET

⚠️ 含 multipart/form-data 二进制上传的接口（Upload Shoppable Video File）不走通用 creator_proxy.py，需 multipart 链路，详见 references/api.md。

解决认证和积分问题

发生以下异常情况时，采用以下措施来处理：

异常情况

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

措施

典型编排流程

A. 选品 / 查达人数据

  1. 达人资料：Get Creator Profile（接口 1）
  2. 商品：Get Shop Products（接口 2，按关键词搜店铺商品）或 Get Showcase Products（接口 3，达人橱窗/直播袋）→ 拿到 product_id

B. 可购物视频带货（发布全链路）

  1. 上传视频：Upload Shoppable Video File（接口 4）→ 拿 file_id（⚠️ multipart，见限制）
  2. 内容预检：Pre-check Shoppable Video（接口 7，传 file_id + product_id）→ 拿 task_id
  3. 查预检结果：Get Shoppable Video Pre-check Result（接口 8，凭 task_id）→ result=SUCCESS 才继续；FAIL 看 issues[] 整改
  4. 发布：Post Shoppable Video（接口 5，传 file_id + product_id + 标题/封面）→ 拿 video.id
  5. 查发布状态：Get Shoppable Video Status（接口 6，凭 video_id）→ post_status 为 SUCCESS/FAIL/PROCESSING

所有调用都需先经 linkfox-tiktok-video-auth 拿到达人 accessToken 作为 ttsAccessToken。

Display Rules

  1. 只呈现数据：展示达人资料字段即可，不做主观评价。
  2. 令牌安全：不要明文输出完整 ttsAccessToken，仅展示掩码。
  3. 错误说明：失败时依据 TikTok 业务 code / message 与网关 httpStatus 解释原因。
  4. 前置校验：无达人令牌时，先引导用户经 linkfox-tiktok-video-auth 授权。

Important Limitations

  • 达人令牌必备：所有接口都需 user_type=1 的达人 access_token；店铺(erp)令牌不适用。
  • 达人权限：达人须具备相应电商（EC）/选品区域权限，否则返回 16015006 / 16015007 / 16504002 等。
  • 限流：短时间内请求过多会触发 36009002，请退避重试。

User Expression & Scenario Quick Reference

Applicable：

User SaysScenario
"查一下这个 TikTok 达人的资料" / "Get TikTok creator profile"获取达人主页/档案
"搜一下达人店铺里的商品" / "Get shop products of the creator"搜索达人绑定店铺的商品
"看看达人橱窗里有哪些商品" / "Get creator showcase products"达人橱窗商品列表
"上传一个可购物视频" / "Upload shoppable video"上传可购物视频文件
"发布可购物视频 / 把视频和商品绑定发出去" / "Post shoppable video"发布可购物视频
"视频发布成功了吗 / 查下视频发布状态" / "Get shoppable video status"查询可购物视频发布状态
"发布前先检测下视频有没有违规" / "Pre-check shoppable video"可购物视频内容预检
"预检结果出来了吗 / 视频违规检测结果" / "Get video pre-check result"查询视频预检结果
"看看达人的带货信息"达人数据查询（按已收录接口）

Not applicable：

  • TikTok 达人授权本身 → 用 linkfox-tiktok-video-auth（勿用 linkfox-tiktok-auth）。
  • TikTok 选品 / 商品销量（EchoTik 等数据源）→ 由对应 skill 负责。

积分消耗规则

不消耗积分。

Feedback：

当出现以下任一情况时，自动通过 Feedback API 上报反馈：

  1. 本 skill 描述的功能与实际行为不符
  2. skill 的结果与用户意图不符
  3. 用户表达了对本 skill 的不满或赞赏
  4. 任何你认为可以改进的点

按 references/api.md 中的规范调用 Feedback API，不要打断用户的主流程。

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

评论

加载中…