bggg-tiktok-search

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 健康检查：

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

CDP 健康检查：

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 并搜索关键词

# 打开 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. 提取视频卡片数据

# 用 evaluate 提取视频列表的结构化数据
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"evaluate","args":{"code":"(() => { const cards = [...document.querySelectorAll(\"[data-e2e=search-card-video]\")].slice(0, 10); return cards.map((c, i) => { const link = c.querySelector(\"a\"); const author = c.querySelector(\"[data-e2e=search-card-user-avatar]\"); const metrics = [...c.querySelectorAll(\"[data-e2e=video-views]\")]; return { index: i, url: link ? link.href : null, title: c.innerText.slice(0, 200), author: author ? author.getAttribute(\"href\") : null, raw_text: c.innerText.slice(0, 500) }; }); })()"},"session":"tiktok-search"}'