- name
- douyin_topic_hotspot_collector
- description
- Search Douyin for a user-specified topic and time range, then return the top hotspot videos ranked by visible engagement signals with strict no-fabrication rules.
- version
- 1.0.0
- author
- 依凡
- metadata
- openclaw
- requires
- bins
- []
抖音主题热点整理器
一句话定位
根据用户输入的主题与时间范围，搜索抖音相关热点视频，并按互动数据整理输出前10条热点结果。
适用场景
- 自媒体创作者在选题前寻找热点参考
- 内容运营人员做主题趋势判断
- 学习某个主题时快速查看近期高热内容
- 做内容分析时获取某主题热门视频清单
何时使用本 Skill
当用户出现以下需求时，优先使用本 Skill：
- 想搜索抖音某个主题最近的热点视频
- 想查看某个主题在最近24小时 / 7天 / 30天内的高热内容
- 想输出该主题的前10条热点内容清单
- 想对某个主题的热点内容做快速整理和选题参考
- 想把结果导出为本地文件
本 Skill 只做什么
- 只搜索抖音平台内容
- 只做热点内容整理与整理
- 只输出结构化结果
- 可选导出结果文件
- 不编造任何互动数据或缺失字段
本 Skill 不做什么
- 不生成脚本
- 不改写文案
- 不自动发布
- 不做跨平台整理
- 不做视频真实性背书
- 不做账号登录、私信、评论、点赞、关注等动作
输入说明
必填项
1. 主题
用于指定搜索方向。
示例：
- OpenClaw学习
- AI学习
- 私域运营
- 抖音起号
2. 时间范围
用于限定热点内容的时间窗口。
支持示例：
- 最近24小时
- 最近7天
- 最近30天
可选项
1. 输出数量
默认输出前 10 条结果。
2. 最低互动门槛
默认按 点赞数 ≥ 1000 作为基础筛选门槛。
3. 是否导出文件
默认 否。
4. 导出路径
未填写时，默认保存到桌面。
输出要求
输出形式
优先输出为 Markdown 表格。
主字段
- 排名
- 标题 / 核心文案
- 作者
- 点赞数
- 评论数
- 收藏数
增强字段
- 推荐理由
- 作者粉丝数（若可获取）
- 抓取时间
质量要求
- 推荐理由必须基于可见内容与互动数据判断
- 推荐理由控制在 1-2 句
- 优先说明：
- 主题相关性 - 互动亮点 - 内容参考价值
- 不允许编造互动数据
- 不允许混入与主题无关的内容
完整度要求
- 主字段缺失时，该条结果不纳入前10
- 增强字段缺失时允许降级输出，并标注“缺失”
- 若结果不足10条，则输出已有结果并明确提示
执行流程
第一步：输入检查
在开始前先检查用户是否提供：
- 主题
- 时间范围
若缺失任一必填项，立即停止并输出固定报错结构。
第二步：环境检查
检查以下条件是否满足：
- 能访问抖音页面
- 浏览器能力可用
- 网络环境正常
- 若用户要求导出，则导出目录可写
若不满足，立即停止并输出固定报错结构。
第三步：执行搜索
- 打开抖音
- 搜索用户给定主题
- 切换到相关视频结果页
- 在用户指定时间范围内优先筛选相关内容
第四步：整理可见字段
仅整理页面公开可见字段：
- 标题 / 核心文案
- 作者
- 点赞数
- 评论数
- 收藏数
- 作者粉丝数（若可见）
- 抓取时间
第五步：相关性过滤
只保留与用户主题明显相关的内容：
- 标题、文案、标签、摘要中与主题强相关
- 明显无关内容直接剔除
- 不得为了凑足10条而保留无关内容
第六步：基础门槛过滤
- 默认仅保留点赞数 ≥ 1000 的内容
- 若用户显式指定最低互动门槛，则以用户输入为准
- 若不足10条，可降级输出已有结果，但必须明确说明“结果不足10条”
第七步：热点排序
按综合互动数据排序：
- 优先使用点赞数
- 若评论数、收藏数可得，可作为辅助判断
- 推荐理由需体现为什么该内容值得参考
- 不允许伪造“官方热度排名”
第八步：结果输出
- 以表格形式输出前10条结果
- 若用户要求导出，则在结果输出后执行导出
- 若导出失败，保留结果区输出并说明导出失败原因
排序规则
默认排序优先级：
- 点赞数
- 评论数
- 收藏数
说明：
- 若评论数 / 收藏数不可稳定获取，可降级为按点赞数排序
- 排序依据必须在输出中写明
- 不允许声称结果等同于平台官方完整热度排序
固定输出模板
成功输出
| 排名 | 标题/核心文案 | 作者 | 点赞数 | 评论数 | 收藏数 | 推荐理由 | 粉丝数 | 抓取时间 |
|---|---|---|---|---|---|---|---|---|
| 1 | [标题] | [作者] | [点赞] | [评论/缺失] | [收藏/缺失] | [1-2句推荐理由] | [粉丝数/缺失] | [抓取时间] |
输出后补充说明：
- 搜索主题
- 时间范围
- 排序依据
- 结果总数
- 若不足10条，明确提示“结果不足10条”
失败输出
抖音主题热点整理失败
- 失败步骤：[输入检查 / 环境检查 / 搜索执行 / 字段提取 / 结果导出]
- 失败原因：[具体原因]
- 所在层级：[输入层 / 环境层 / 浏览器层 / 解析层 / 输出层]
- 是否可重试：[是 / 否]
- 建议动作：[具体动作]
- 原始错误信息：[如有则输出]
异常处理
- 若主题或时间范围缺失，则停止执行并提示补充
- 若搜索结果不足10条，则输出已有结果并明确提示“结果不足10条”
- 若主字段缺失，则该条不进入最终榜单
- 若增强字段缺失，则保留该条结果并标注“缺失”
- 若导出失败，则保留结果区输出并提示导出失败原因
- 若网络或平台访问异常，则返回失败原因并停止执行
安全说明
- 本 Skill 仅访问抖音公开可见页面
- 不自动登录抖音账号
- 不执行发布、评论、私信、点赞、关注等动作
- 若启用导出，仅允许写入用户指定目录或默认桌面
- 不修改与本任务无关的文件
- 不伪造任何字段或结果
依赖说明
- 需要具备抖音搜索访问能力
- 需要可读取页面公开可见数据
- 若启用导出，需要本地写文件权限
- 若依赖浏览器控制，需要浏览器工具可用
- 需要可正常访问抖音页面的网络环境
已知限制
- 部分视频可能无法获取完整字段
- 粉丝数等增强字段不一定稳定可得
- 热点结果会随平台实时数据变化
- 若平台访问受限，可能无法返回完整结果
- 排序结果依赖当时可获取的公开数据，不代表平台官方完整热度排序
推荐触发示例
- 请搜索主题为“OpenClaw学习”的抖音热点视频，时间范围为最近7天，输出前10条结果。
- 请搜索主题为“AI学习”的抖音热点视频，时间范围为最近24小时，最低点赞门槛1000。
- 请搜索主题为“私域运营”的抖音热点视频，时间范围为最近30天，输出前10条并导出到桌面。
使用原则
- 宁可少输出，也不混入无关内容
- 宁可报错，也不编造数据
- 宁可降级，也不输出不可信字段