用途:在用户本地真实 Chrome 的 TikTok 登录态下做内容调研、博主搜索、视频采样、主页采集和截图留证。默认只读取公开或用户可见页面,不做点赞、关注、评论、私信、发布或账号设置修改。
前置条件(任选一种控制路径):WebBridge 本地 daemon 与浏览器扩展可用;或用户自启带 remote debugging 的 Chrome,脚本用 Playwright 连接;或 macOS Chrome 开启 View > Developer > Allow JavaScript from Apple Events 后使用 scripts/tk_real_chrome.py;或登录、验证码、地区弹窗、风控时由用户在真实 Chrome 手动处理后继续。
健康检查:WebBridge 用 curl -s "$WEBBRIDGE_URL/status"(默认 http://127.0.0.1:10086);CDP 用 python3 <skill-dir>/scripts/tk_research.py check-cdp。
工作流:先判断任务类型(关键词找视频 search、关键词找博主 authors、已有博主页 creator、用户已打开目标页 current),再操作 Chrome:navigate 打开搜索页或博主页,fill 输入搜索词,click 触发搜索,snapshot 读取页面并定位视频卡片,evaluate 提取 URL、作者、标题、互动数等结构化数据。滚动加载更多后重复提取。截图留证,避免把 base64 截图直接贴进上下文。
输出:结构化数据写入 collected_items.json,截图存到 screenshots/,并生成 research_notes.md。目录为 bggg-tiktok-search/projects/tiktok-research/YYYYMMDD_HHMMSS_<slug>/。后续可衔接 bggg-tiktok-downloader 下载视频或 bggg-tiktok-readvideo 分析视频。
限制:TikTok DOM 经常变化,evaluate 中 selector 需按实际页面结构调整,先用 snapshot 确认再写提取逻辑;不代解 CAPTCHA;不提交 Cookie、浏览器 profile、截图、CSV、JSON 采集结果或运行产物到公开仓库;任务结束后关闭 session。references/implementation-notes.md 记录相关设计模式。