laohan-douyinsousuo

name	laohan-douyinsousuo
description	抖音关键词搜索，采集视频数据按点赞排行。Use when 用户说"抖音搜索""搜一下抖音""抖音上搜""抖音关于""抖音上有什么""douyin搜索"或提到"在抖音搜""抖音的xxx情况""抖音里xxx排行"。
version	1.2.0

抖音搜索

用 DrissionPage 监听抖音搜索 API 数据包，滚动采集视频列表，按点赞排行输出。

核心理念

抖音搜索 API 有 a_bogus 签名校验，无法直接调接口。唯一可行方案：浏览器自动化 → 监听数据包 → 后处理排序。不支持 API 级排序/筛选。

工作流

1. 确认搜索参数

从用户输入中提取：

• 关键词（必填）：要搜什么
• 最少条数（可选，默认 30）：--min
• 最大滚动（可选，默认 10）：--scroll

如果用户只给了关键词，用默认参数直接执行。

2. 执行搜索

cd /tmp/douyin-test && source .venv/bin/activate
python ~/.agents/skills/laohan-douyinsousuo/scripts/search.py "关键词" --min 30 --scroll 10

脚本会自动：

• 启动 Chrome（需本机安装 Chrome）
• 检测登录态（已登录直接过，未登录等扫码最多 120 秒）
• 滚动采集，采够 --min 条即停
• 按点赞降序排列，输出 TOP 20
• JSON 保存到 /tmp/douyin-test/{关键词}_results.json

3. 展示结果

脚本运行结束后，读 JSON 文件，用表格展示（含发布时间）：

# 抖音搜索结果：{关键词}
共 {N} 条 | TOP {M}（按点赞排行）：

| # | 作者 | ❤️点赞 | 💬评论 | 📅发布时间 | 标题 |
|---|------|--------|--------|------------|------|
| 1 | {作者} | {点赞} | {评论} | {create_time_str} | {标题} |

• 时间字段用 create_time_str（格式 YYYY-MM-DD）
• 超过 30 天前的发布时间加粗标记（**2026-01-05**），让用户快速识别旧内容
• 如果用户问"有没有 xxx 博主"，逐条检查 author 字段回答

4. 选题分析

展示结果后，自动附上选题分析，包含：

内容类型分布：统计各类型视频数量（安装教程/进阶技巧/方法论/对比评测/实战/资源推荐）

热门选题规律：从标题和互动数据中总结 2-4 条规律（如哪些角度流量高、哪些话题红海、哪些角度竞品少）

差异化机会：基于搜索结果，指出老韩（寒武纪AI）可切入的选题方向，重点看竞品未覆盖的领域（Skills/Hooks/多Agent协作/飞书控制等 OpenClaw 独家经验）

操作规则

• 首次运行需安装依赖：如果 .venv 不存在，cd /tmp/douyin-test && python3 -m venv .venv && source .venv/bin/activate && pip install DrissionPage
• Chrome 必须已安装：脚本硬编码了 /Applications/Google Chrome.app 路径
• 需要登录态：首次需扫码，后续自动复用 Chrome profile 登录态
• 脚本是阻塞的：运行时间 = 滚动次数 × ~5秒 + 登录等待。30 条约需 1-2 分钟
• 不同关键词结果完全不同：抖音搜索算法对用户画像和关键词匹配权重高

已知限制

• author_id 全部为空（搜索 API 不返回）
• plays 全部为 0（搜索 API 不返回播放量）
• 不支持排序/时间筛选（API 需签名，UI 点击触发验证码）
• 如需筛选，建议多采集后 Python 后处理

不适用场景

• 下载抖音视频 → 用 yt-dlp 移动端 UA 方法（→ /laohan-xiazai）
• 抓取抖音评论 → 用 douyin-session adapter
• 博主作品列表 → 用 opencli douyin user-videos