用途:针对已知的 TikTok Shop 商品 ID,查询与该商品关联的推广视频列表,分析哪些视频和达人带来播放、互动、销量或 GMV,用于视频营销效果评估与达人内容策略判断。
主要能力:返回视频互动指标(播放、点赞、评论、分享、收藏)、预估归因(视频销量与 GMV)、视频元数据(时长、分辨率、发布时间)及达人 ID;支持按播放(1)、点赞(2)、分享(3)、视频销量(4)、视频 GMV(5)、发布时间(6)排序,可按达人 userId 过滤、按发布时间范围过滤、分页。
使用方式:需先确认或获取 productId(缺失时先用商品搜索或热销榜工具获取)。调用 NexScope 代理 API,可参考 references/api.md,或直接运行 scripts/tiktok_product_video.py。必填环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY。默认按播放降序、pageSize 50、不限达人。pageSize 须为 10 的倍数,最大 100。响应较大时可用 scripts/response_io.py 落盘后按字段读取,输出目录应放在 git 工作区之外,数据可能含敏感信息,勿提交,任务完成后清理。
适用场景:查询某商品推广视频、按视频销量或 GMV 找高转化视频、查看特定达人为该商品发布的视频、按时间范围看近期视频、从榜单选定商品后做视频级验证。
限制:仅适用于已知具体 TikTok 商品的视频分析;不用于商品搜索、类目热销榜、达人主页分析、直播数据、视频创作建议、广告投放管理及非 TikTok 平台数据。视频销量与 GMV 为预估值;playAddr 可能较快失效,分享优先用 officialUrl。输出默认含查询假设、视频表格、关键观察、注意事项与建议下一步。