技能介绍

解决什么问题

当团队需要判断抖音近期热点、验证选题方向或整理营销灵感时，单靠人工刷热榜和搜索结果容易遗漏样本，也难以形成可追溯的判断依据。这个技能把热榜与关键词搜索整理成结构化输出，帮助内容运营、品牌调研和创作者先拿到当前排名信号，再围绕关键词继续抽取相关标题、作者、链接或内容 ID，用于后续复盘。

如何工作

技能面向只读数据查询，通常输入两类内容：平台热榜或关键词/选题方向。查看当前热榜时使用无参数命令；围绕具体选题时使用 douyin search，并可加 --keyword、--sort-type、--publish-time-range、--duration-range 和 --content-type 做筛选。排序支持 general、time_descending、like_count_descending；发布时间支持 day、week、half_year；时长和内容类型也可限定，适合把“最近一周高点赞短视频”这类需求拆成可执行参数。

查询结果以 JSON 返回，通常包含榜单排名、热度信号、相关标题、作者或账号、链接或内容 ID。若只需先看样本，可先取一页；需要扩大范围时再使用 --pages 或 --max-items 合并结果。分页 token 是不透明字符串，继续沿用同一条搜索链路时必须原样传回，不能截断、改写或重新生成。输出时建议把可见证据与判断分开：先列热榜和搜索样本，再标注相关原因、可追问角度和下一步验证点。

适用边界

该技能是只读能力，不登录、不发帖、不点赞、不评论，也不修改账号状态。运行时依赖环境变量中的 API Key，遇到 insufficient_balance 或积分不足时应按错误中的充值信息处理，而不是反复重试。若没有结果，通常需要放宽关键词或减少限定条件；若结果过多，则补充人群、场景、品牌、时间范围或账号名。搜索结果没有稳定完整边界，不能仅凭某一页为空就判断无更多数据。