Linkfox Tiktok选品与带货视频（TikTok Product Selection and Shoppable Video）

TikTok 选品与带货视频一站式 AI 工具集，整合 3 类底层工具、10 项子能力，覆盖选品数据（EchoTik 16 区域市场 / FastMoss 全球电商）与官方带货视频发布链路（TikTok 视频号授权 → 可带货商品 → 可购物视频预检/发布）。各子能力完整参数、响应字段与错误码见 references/ 下对应文件，可执行脚本见 scripts/。

能力边界

✅ 能力范围

• TikTok 选品数据（echotik_tiktok，EchoTik，覆盖 16 个区域市场）：新品排行发现热销爆品与新兴趋势（echotik_tiktok list-new-product-rank）；商品搜索按销量/达人/佣金/评分/评论多维筛选（echotik_tiktok list-product）；商品关联带货视频查询播放/互动/视频销量/GMV（echotik_tiktok product-video）；批量商品详情含多周期销量与 GMV、直播销量、带货达人数、价格评分与佣金（echotik_tiktok batch-product-detail）；解析 TikTok 视频链接返回无水印/含水印下载、播放与封面地址（echotik_tiktok get-video-download-url）。
• TikTok 全球电商热销与选品（fastmoss_tiktok，FastMoss）：按日/周/月维度与类目分析热销商品排行榜与 GMV 排名（fastmoss_tiktok product-rank-top-selling）；按类目/销量/佣金率/达人数/店铺类型多维搜索筛选商品（fastmoss_tiktok product-search）。
• TikTok 官方带货视频 API（tiktok_official_video_api）：视频号达人 OAuth 授权、已授权账号列表、令牌查询与 access_token 刷新（tiktok_official_video_api linkfox-tiktok-video-auth）；可购物视频内容预检、查预检结果、发布、查发布状态、达人档案查询及大文件分片上传（tiktok_official_video_api linkfox-tiktok-video）；达人可带货商品查询（店铺商品与橱窗/直播袋商品），取得 product_id 供可购物视频挂车（tiktok_official_video_api linkfox-tiktok-video-products）。
• 覆盖 region/marketplace：EchoTik 16 个 TikTok Shop 区域市场；FastMoss 全球电商（按 region 筛选）；TikTok 官方视频号 region 支持 global（默认）/ us（美国站）。具体取值见各 references。

❌ 边界与限制

• API Key 必需：所有工具均需环境变量 LINKFOX_AGENT_API_KEY（或 LINKFOXAGENT_API_KEY）；各工具独立计费、独立限频，数据时效与区域覆盖随数据源而异。
• 计费约束：同一会话同一参数组合默认只调用一次（脚本带本地缓存）；失败或空结果不得自动换关键词、翻页或改区域连续试探；需继续检索时先向用户说明会产生额外消耗（计费规则见 skills-version.json 与 references 内 api.md 的 costToken 字段：EchoTik 5 项 fixed≈4.5/9000 token，FastMoss 2 项 fixed≈10.5/21000 token，TikTok 官方 3 项免费）。
• TikTok 官方模块隔离：linkfox-tiktok-video / linkfox-tiktok-video-products 仅走 /tiktokVideo/developerProxy，path 须以 affiliate_creator / video / creator 开头（否则 errcode 1005）；不可用于 /tiktokShop/*（TikTok Shop 卖家模块用 linkfox-tiktok-shop-auth）。令牌 ttsAccessToken 由 linkfox-tiktok-video-auth 授权后经 /tiktokVideo/accountTokens 取得，固定 creator 达人端。
• TikTok 官方依赖链：可购物视频发布需先 linkfox-tiktok-video-auth 授权取令牌，再 linkfox-tiktok-video-products 取 product_id，最后 linkfox-tiktok-video 预检/发布；check_auth_dependency.py 探测 linkfox-tiktok-video-auth 是否安装（exit 42=未安装/未授权，需先完成授权）。
• 大文件上传限制：≤10MB 走 upload_shoppable_video_file（multipart，网关暂不支持）；>10MB 走大文件分片三步（Initialize → PUT 分片 → Bind，详见 references/large-file-upload.md，Step 1/3 可经 proxy，Step 2 分片 PUT 不经网关）。
• 不在范围内：TikTok Shop 小店 ERP（商品/订单/财务，用 linkfox-tiktok-shop-auth + 业务 skill）、TikTok Shop 可购物视频（/tiktokShop/developerProxy，用 linkfox-tiktok-creator）、TikTok 广告投放、物流与供应链、非电商任务、与平台或卖家的直接沟通。