TikTok Shop ERP 数据分析（Analytics）
本 skill 调用 TikTok Shop 卖家 ERP 分析开放接口。统一经 LinkFox 网关：
linkfox-tiktok-shop-auth → openId（选店）
↓
POST /tiktokShop/developerProxy
appType = erp
openId = <ERP openId>
path / method / queryString
↓
401 或 token 失效 → 网关自动 refresh 并重试一次
📌 前置依赖：
linkfox-tiktok-shop-auth📌 勿手动刷新 token 📌 官方入口：Get Video Performances 📌 完整参考：references/apis/<api>.md
Prerequisites
python scripts/check_auth_dependency.py；exit 42 → 先完成linkfox-tiktok-shop-auth。- 需要时间范围：
start_date/end_date（通常YYYYMMDD）。
Core Concepts
| 概念 | 说明 |
|---|---|
| path 白名单 | analytics/、authorization/ |
| Get Video Performances | GET analytics/202403/shop_videos/performance |
| 时间窗 | Query：start_date、end_date（必填） |
| 分页 | page_size / page_token |
Available Scripts
| 脚本 | 作用 |
|---|---|
check_auth_dependency.py |
检测 auth skill |
analytics_api.py |
具名 API |
analytics_proxy.py |
通用 path/method |
get_authorized_shops.py |
取 shop_cipher |
get_video_performances.py |
视频表现列表 |
Usage Examples
python scripts/get_video_performances.py '{
"openId": "...",
"start_date": "20240301",
"end_date": "20240331",
"page_size": 20
}'
python scripts/analytics_api.py '{
"api": "get_video_performances",
"openId": "...",
"start_date": "20240301",
"end_date": "20240331"
}'
Important Limitations
- 当前以 Get Video Performances（202403） 为主；单视频详情/商品绩效等可后续扩展。
- 不含达人可购物视频发布（
linkfox-tiktok-video）。
Feedback：skillName = linkfox-tiktok-shop-analytics。