linkfox-tiktok-auth
Installation
SKILL.md
TikTok Shop 店铺授权与管理
本 skill 负责 TikTok 卖家账号的 OAuth 授权、已授权店铺列表、令牌查询与刷新,是后续通过开发者代理调用 TikTok 开放接口(商品、订单、履约、财务等)的前置依赖。底层经 LinkFox 网关对接紫鸟开放平台代理。
本 skill 同时覆盖两类授权,由 appType 区分:
- TikTok Shop(小店)授权:
appType = erp(默认)。 - TikTok 视频号(带货内容)授权:
appType = creator。授权视频号时必须把appType设为creator;后续对该授权查询/刷新令牌时也须保持appType = creator。 - 联盟授权:
appType = affiliate。
📌 业务调用(拉商品/订单/财务等)通过开发者代理(
/tiktokShop/developerProxy,传入本 skill 取得的accessToken)完成,不属于本授权 skill 的范围。
Core Concepts
TikTok Shop 通过 OAuth 授权获取卖家店铺访问令牌。本 skill 负责授权流程与令牌生命周期:
授权流程:生成授权 URL → 用户在浏览器完成 TikTok Shop 授权 → 紫鸟回调并推送 Token → 系统按 state 落库 access_token / refresh_token。授权 URL 有效期约 1 小时,每次授权须重新获取。
店铺标识(openId + appType):TikTok Shop 授权后以卖家唯一标识 openId 标记店铺;同一店铺在不同 appType(erp / creator / affiliate)下的授权相互独立。查询令牌、刷新令牌都需要 openId,并保证 appType 与授权时一致。