技能介绍

要解决什么问题

做 TikTok 话题（hashtag）调研时，你需要的不只是话题名，而是可分页的视频列表：每条视频的作者、playCount 等互动指标、配乐与基础元数据。TikTok 的 /api/challenge/item_list/ 带动态签名（X-Bogus / X-Gnarly），在会话外直接 fetch 往往拿不到有效 itemList。

本技能把操作边界限定在浏览器里你本来就能看到的公开页：通过导航触发已签名的 XHR，再读取响应体，而不是绕过登录或访问控制。

如何工作

解析话题 ID：用 get-challenge-id.py 调用 challenge/detail（无需签名），确认 # 后的话题名存在并得到 challengeId。
首屏列表：navigate 到 https://www.tiktok.com/tag/{hashtag}，等待页面稳定后，在 xhr/fetch 里筛选 URL 含 challenge/item_list 且 cursor=0 的请求，再 network request 取回 JSON。
分页：向下滚动触发下一页；找 cursor 递增（如 0 → 30 → 60，每页约 30 条）的新请求，合并各页 itemList，直到 hasMore === false 或列表为空。

脚本在 scripts/ 下，经 eval "$(python scripts/xxx.py {params})" 调用；流程输出语言跟随用户设置。

边界与注意

需非香港代理（TikTok 已在港停用）；若出现地区限制提示，换浏览器/代理后重试。
私密或年龄限制话题可能返回空 itemList；高流量话题需要多次滚动。
批量时同一会话内串行多个标签，导航间隔 2～3 秒；先测 1 个话题再跑全量，并按页落盘以便失败后从最后一页续跑。
执行前可读工作目录下 browser-act-skill-forge-memories/tiktok-scraper-tiktok-hashtag-videos.memory.md 中的历史踩坑记录。