tiktok-browser-navigate-to-video

Files (1)

• SKILL.md

SKILL.md (first lines)

## URL 规则

接受：
- `https://www.tiktok.com/@<user>/video/<id>`
- `https://www.tiktok.com/<user>/video/<id>`（去掉 @ 也能命中）
- `https://vm.tiktok.com/<shortCode>`（依赖 TikTok 自身重定向到 canonical）

拒绝：
- 非 `*.tiktok.com` 域名的 URL
- 不含 `/video/` 路径段的 URL（如个人主页、tag 页、live 页）
- `mailto:` / `javascript:` / 相对路径

## 操作步骤

1. **URL 校验**：解析 `video_url`，确认 host 命中 `tiktok.com`，path 命中 `^/(@?[^/]+/)?video/\d+`
2. **登录态检查**：调用 `tiktok-ensure-login`，未登录则中止并提示用户先登录
3. **导航**：调用 `browser-navigate`，参数 `video_url`
4. **最终页校验**：等 `domcontentloaded` 后跑 `evaluate_script` 读 `location.href`：
   - 命中 `tiktok.com/.../video/\d+` → `valid = true`
   - 命中 `/login` 或 `/signup` → `valid = false`，提示用户登录后重试
   - 其它 → `valid = false`，返回 `reason: 'unexpected_redirect'`
5. **抽 video_id**：用正则从 final_url 抽 `\d+`

## 返回格式

成功：
```
已导航到 https://www.tiktok.com/@xxx/video/1234567890，video_id=1234567890
```

失败：
```
导航失败：{reason}
```

## 失败 reason 分类

- `invalid_url` — 输入 URL 不符合 tiktok.com 视频格式
- `login_required` — `tiktok-ensure-login` 返回未登录
- `unexpected_redirect` — 导航后跳转到非视频页（/login、/signup、404 等）
- `network_error` — 导航本身失败（daemon 异常）

## 注意事项

- **不点任何元素**：始终 URL 导航。点击视频缩略图容易触发 SPA 内导航而非 `Page.loadEventFired`，导致 `evaluate_script` 读到的是旧页面。
- **短链重定向**：vm.tiktok.com 由 TikTok 302 到 canonical，`browser-navigate` 等待 `Page.loadEventFired` 即可。
- **页面 DOM 校验**：成功不只靠 URL——还要确认页面里出现视频主体（`<video>` 或 `[data-e2e="video-player"]`），避免 TikTok 反爬给你返回一个看起来对但空内容的页面。

From 271642183/tiktok-web-skills, MIT.

More from 271642183/tiktok-web-skills