TikTok 主页视频采集

要解决什么问题

做 TikTok 账号分析或内容归档时，你往往需要从用户名拿到两样东西：主页上的账号统计与简介，以及该账号下视频的完整列表（播放、互动、id、uniqueId 等字段）。手动翻页复制既慢，也容易漏掉分页接口里的字段。

本技能的目标很明确：给定 TikTok 用户名，在不登录（公开主页）的前提下，抽出视频列表与主页侧元数据，并支持向下滚动触发的分页，直到接口返回 hasMore === false 或 itemList 为空。

工作原理

技能的操作边界与你在浏览器里能做的事一致：只读取页面上已触发的网络数据，不绕过登录或访问控制。实现上依赖 browser-act，通过导航与抓包完成，而不是手写签名。

TikTok 的 /api/post/item_list/ 需要动态签名和用户的 secUid。正确做法是：

1. navigate 到 https://www.tiktok.com/@{username}，等待页面稳定；
2. 用 network requests 过滤 post/item_list，再 network request 取响应；
3. 从首包 URL 中记录 secUid（长串内部 ID），用于理解后续分页；
4. 需要更多页时 向下滚动，等待新的 XHR/fetch，找到 cursor 变化 的那条请求并解析。

每条视频的可分享地址可按 https://www.tiktok.com/@{item.author.uniqueId}/video/{item.id} 拼装。账号维度信息通常来自首条数据的 author 与 authorStats（粉丝、关注、获赞、作品数、简介、认证等）。脚本在 scripts/ 下，通过 eval "$(python scripts/xxx.py {params})" 注入页面侧逻辑。

批量时建议同一 session 串行多个用户名，主页切换间隔 2～3 秒；先测 1 个账号再跑全量；按 profile 落盘，出错可从失败用户名续跑。执行前可读工作目录下的经验文件 tiktok-scraper-tiktok-profile-videos.memory.md。

边界与注意点

• 浏览器须能访问 https://www.tiktok.com，且使用非香港代理（香港已关停 TikTok 服务）。
• 私密账号会得到空的 itemList；若抓不到请求，先截图确认页面是否加载完成或是否被地区拦截。
• authorStats.heartCount 在极高赞账号上可能溢出为负数，应优先看 authorStats.heart。
• 粉丝/关注列表不在本技能范围内（需登录与另外的采集能力）。