# Bggg Tiktok Search

使用本地真实 Chrome 登录态做 TikTok 调研，支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。 当用户要求在...

- Repository: https://github.com/binggandata/bggg-skills (612 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-08-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-search -g -a claude-code -y`
Codex: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-search -g -a codex -y`
Cursor: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-search -g -a cursor -y`
Gemini CLI: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-search -g -a gemini-cli -y`

## Description

使用本地真实 Chrome 登录态做 TikTok 调研，支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。 当用户要求在 TikTok 上搜索关键词、搜索博主、采样视频、打开博主主页、 采集最近作品、提取视频链接/标题/作者/互动指标、截图留证、 输出 CSV/Markdown/JSON 调研包，或做 TikTok 博主/内容/选题/带货方向研究时， 使用此 skill。它不依赖第三方 TikTok API，核心原则是只做可见页面读取、滚动、截图和结构化整理。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# BGGG TikTok Search

## 目标

用用户本地真实 Chrome 的 TikTok 登录态完成内容调研、博主搜索、视频采样、主页采集和截图留证。默认只读取公开或用户可见页面，不做点赞、关注、评论、私信、发布或账号设置修改。

## 前置条件

任选一种控制路径：

1. WebBridge：本地 WebBridge daemon 和浏览器扩展可用。
2. Chrome/CDP：用户自己启动带 remote debugging 的 Chrome，脚本通过 Playwright 连接。
3. Apple Events：macOS Chrome 开启 `View > Developer > Allow JavaScript from Apple Events` 后使用 `scripts/tk_real_chrome.py`。
4. 手动辅助：当登录、验证码、地区弹窗或风控出现时，让用户在真实 Chrome 里处理后继续。

WebBridge 健康检查：

```bash
WEBBRIDGE_URL="${WEBBRIDGE_URL:-http://127.0.0.1:10086}"
curl -s "$WEBBRIDGE_URL/status"
```

CDP 健康检查：

```bash
python3 <skill-dir>/scripts/tk_research.py check-cdp
```

## 工作流

1. **判断任务类型**：
   - 关键词找视频 → `search`
   - 关键词找博主 → `authors`
   - 已有博主主页 → `creator`
   - 用户已经把 Chrome 打到目标页 → `current`
2. **操作 Chrome**：
   - `navigate` 打开 TikTok 搜索页/博主页。
   - `fill` 输入搜索词，`click` 触发搜索。
   - `snapshot` 读取页面内容，定位视频卡片。
   - `evaluate` 提取结构化数据（URL、作者、标题、互动数）。
   - 截图留证，避免把 base64 截图直接贴进上下文。
   - 滚动加载更多，重复提取。
3. **结果保存**：
   - 结构化数据写入 `collected_items.json`。
   - 截图保存到 `screenshots/`。
   - 生成 `research_notes.md` 做业务蒸馏。
4. **后续衔接**：
   - 要下载视频 → 交给 `bggg-tiktok-downloader`
   - 要分析视频 → 交给 `bggg-tiktok-readvideo`

## WebBridge 操作示例

### 1. 打开 TikTok 并搜索关键词

```bash
# 打开 TikTok 首页（新标签页，session 隔离）
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -H 'Content-Type: application/json' \
  -d '{"action":"navigate","args":{"url":"https://www.tiktok.com","newTab":true,"group_title":"TikTok Research"},"session":"tiktok-search"}'

# 获取页面 snapshot，找到搜索框的 @e ref
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"snapshot","session":"tiktok-search"}'

# 在搜索框填入关键词（用 @e ref 或 CSS selector）
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"fill","args":{"selector":"input[type=search]","value":"skincare routine"},"session":"tiktok-search"}'

# 点击搜索按钮或按回车
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"click","args":{"selector":"button[type=submit]"},"session":"tiktok-search"}'
```

### 2. 提取视频卡片数据

The rest: https://github.com/binggandata/bggg-skills/blob/HEAD/bggg-tiktok-search/SKILL.md