TikTok — 个人主页视频列表

输入 TikTok 用户名 → 获取用户个人主页信息 + 分页视频列表（含完整元数据）

语言

所有面向用户的流程输出（进度提示、状态通知等）均遵循用户当前系统/界面语言。

目标

通过访问目标用户的 TikTok 个人主页，触发其前端 JS 自动调用 /api/post/item_list/ 接口，从而提取该用户的视频列表及主页元数据。

前置条件

• 浏览器已打开，且可正常访问 https://www.tiktok.com
• 公开主页无需登录即可访问
• 浏览器必须使用非香港（non-HK）代理（TikTok 已在香港地区关停服务）

执行前检查

1. 工具就绪性

若已在当前会话中确认 browser-act 可用 → 跳过此步骤。

通过 Skill 工具调用 browser-act 加载其功能。如遇安装或配置问题，请依据其提示完成修复后重试。

能力组件说明

本 Skill 的能力边界 = 用户在浏览器中可手动完成的操作。它仅读取页面上已向用户呈现的数据，绝不绕过任何身份验证或访问控制机制。所有 JavaScript 逻辑均封装于 scripts/ 目录下的 Python 文件中，并通过 eval "$(python scripts/xxx.py {params})" 方式调用。$(...) 为 Bash 语法，建议统一使用 bash 工具执行。

网络请求捕获：个人主页视频列表（参数由 URL 导航注入）

/api/post/item_list/ 接口需 TikTok 动态签名（dynamic signing），且依赖用户的 secUid（平台内部唯一标识）。通过导航至用户主页，TikTok 前端 JS 将自动解析出 secUid 并发起已签名的请求：

1. navigate https://www.tiktok.com/@{username}
2. wait stable
3. network requests --type xhr,fetch --filter "post/item_list"
4. network request

接口特征：URL 中包含 /api/post/item_list/，且含参数 secUid={secUid}&cursor=0

注意：secUid 是一个长格式内部 ID（例如：MS4wLjABAAAA-VASjiXTh7wDDyXvjk10VFhMWUAoxr8bgfO1kAL1-9s），可在捕获到的请求 URL 中直接观察到 —— 请记录该值，用于后续分页请求。

错误处理：若未捕获到匹配请求，请先通过 screenshot 确认主页是否成功加载。私密账号将返回空的 itemList；若页面显示地域限制提示，请切换至非香港代理环境的浏览器。

输出示例：

{
  "cursor": "1778468677570", // 基于时间戳的游标，用于下一页请求
  "hasMore": true,           // false 表示全部视频已加载完毕
  "itemList": [
    {
      "id": "7212410220977392938",
      "desc": "Daily Push Up Workout🚀#fitness",
      "createTime": 1679270124,
      "isAd": false,
      "isPinned": false,
      "isSponsored": false,
      "locationCreated": "US",
      "author": {
        "id": "6803405475100181510",
        "uniqueId": "marcusriosofficial",
        "nickname": "Marcus Rios",
        "verified": false,
        "signature": "Former NFL Athlete 🏈n📧marcusriosofficial@gmail.com",
        "bioLink": null,
        "avatarThumb": "https://...",
        "privateAccount": false
      },
      "authorStats": {
        "followerCount": 423500,
        "followingCount": 50,
        "heart": 10000000,
        "videoCount": 1277,
        "diggCount": 869
      },
      "authorStatsV2": {
        "followerCount": "423500",
        "followingCount": "50",
        "heart": "10000000",
        "videoCount": "1277"
      },
      "stats": {
        "diggCount": 367500,
        "shareCount": 6041,
        "playCount": 4500000,
        "commentCount": 942,
        "collectCount": 56691
      },
      "video": {
        "duration": 48,
        "height": 1280,
        "width": 720,
        "cover": "https://...",
        "definition": "720p",
        "format": "mp4"
      },
      "music": {
        "id": "7176546707423889410",
        "title": "Trap Money so Big (Remix)",
        "authorName": "Iqbal12",
        "original": false,
        "coverMedium": "https://..."
      },
      "textExtra": [{"hashtagId": "9261", "hashtagName": "fitness"}],
      "effectStickers": [],
      "imagePost": null
    }
  ]
}

每个视频项的 webVideoUrl 构建方式：https://www.tiktok.com/@{item.author.uniqueId}/video/{item.id}

用户主页信息可从首个视频项的 author 和 authorStats 字段中提取，包括：粉丝数（followerCount）、关注数（followingCount）、总获赞数（heart）、视频总数（videoCount）、简介（signature）、认证状态（verified）等。

网络请求捕获：个人主页视频列表分页（第 2 页起）

完成第 1 页数据读取后，向下滚动以加载更多视频：

1. scroll down
2. wait stable
3. network requests --type xhr,fetch --filter "post/item_list"
4. 定位新产生的请求（其 cursor 值应与上一页不同）
5. network request

终止条件：响应中 hasMore 为 false，或 itemList 为空数组。

分页机制

DOM 分页：滚动操作将触发新的 post/item_list 请求，游标（cursor）为时间戳格式。每页返回 16 条视频数据。终止条件为 hasMore === false 或 itemList 为空。

成功判定标准

itemList.length >= 1，且首条视频项的 id、stats.playCount、author.uniqueId、authorStats.followerCount 均不为 null 或未定义。

已知限制

• 必须使用非香港代理（TikTok 已在香港地区关停服务）
• post/item_list 接口依赖 TikTok 动态签名 + secUid 解析，二者均由 TikTok 前端 JS 完成 —— 必须采用“导航至主页 + 捕获网络请求”方式，不可直连
• 私密账号返回空 itemList
• 对于获赞数极高的账号，authorStats.heartCount 可能因整型溢出变为负数 —— 请优先使用 authorStats.heart 字段
• 粉丝列表（followers）与关注列表（following）无法通过本能力获取（需单独开发 scraper，且依赖登录态）

执行效率优化

• 批量编排：单次会话内可顺序处理多个用户名；每次切换用户主页时添加 2–3 秒间隔。
• 批量执行前测试：先用单个用户名完成全流程测试，确认无误后再运行完整列表。
• 失败续跑支持：按用户逐个保存结果；发生错误时，从失败用户名处恢复执行。

经验记录说明

路径：{working-directory}/browser-act-skill-forge-memories/tiktok-scraper-tiktok-profile-videos.memory.md

执行前：若该文件存在，请先阅读 —— 其中记录了历史执行中遇到的异常情况，可据此调整策略。

执行后：若发生未预期状况（如策略失效、页面改版、反爬升级等），请追加一行记录： {YYYY-MM-DD}: {发生了什么} → {结论}

正常执行过程不会向该文件写入内容。