kuaishou-videos-searchlisted
Install: claude install-skill why20261/kuaishou-videos-search
# 🎯 快手热门视频检索
「快手热门视频检索」面向热门趋势与创作灵感:按关键词实时搜索快手公开热门视频,返回内容信息、互动量与趋势/评论数据,助力创作者、品牌方和 MCN 发现爆款方向;覆盖**关键词搜索排序**、**达人作品抓取**、**视频评论分析**,不登录、不发布,结果为结构化 JSON。
| 你要做的事 | 用哪个命令 | 你拿到什么 |
| --- | --- | --- |
| 找选题、看高赞 | `search-cli.js` | 视频数组。点赞、播放、评论是数字 |
| 看评论区 | `comment-cli.js` | 评论数组 |
| 看博主作品 | `post-cli.js --limit 大于 0` | `results.post` 作品数组,以及可能有的 `results.user` |
| 看粉丝、获赞 | `post-cli.js --limit 0` | `results.user`。`fan` 粉丝,`like` 点赞,`follow` 关注 |
作品里的互动数是字符串,搜索和评论里的互动数是数字。比较之前先看 schema。空字符串和数字 0 可能不返回。
## 0. 每次按这个顺序执行
1. 确认环境变量 `GUAIKEI_API_TOKEN` 已配置。没有配置时直接告诉用户去 [快手热门视频检索](https://www.guaikei.com) 开通,不要先跑一遍试探。
2. 在本技能根目录执行 `node scripts/kuaishou/<命令>.js`。
3. stderr 出现「处理中」表示任务还在跑。等进程自己退出,再读 stdout 的最后一份 JSON。不要把 stderr 或整份 JSON 念给用户。
4. 按「4. 读结果」的退出码表决定:改参数再试、告诉用户,或停止。
查询最多 20 次。间隔从 2 秒起按 2、4、8、16、32 秒增加,之后每次 60 秒,只算等待大约 15 分钟。每次请求本身还有最多 20 秒超时。宿主如果更早结束进程,按超时处理,不要立刻用同一组参数连打。
同一组参数再次执行时,搜索、作品和评论大约 20 分钟内会复用已有任务。等到 `TIMEOUT` 后再立刻重跑,通常仍落在这个窗口里。
- 没有关键词或链接就先问,不要编造
- 搜索不传 `--limit` 是 10 条。用户说「全部」再加大,不要自行抓 10000 条。用户未说明套餐时优先默认 10;需要更多时先说明可能受套餐限制
- `status=empty` 且退出码 0 是「没有结果」,不是命令失败
- 这个技能没有视频详情命令。视频链接只能拉评论
**套餐双上限(重要)**:技能侧硬上限为 10000(按量 Token)。**包月 Token** 超限会返回 `PLAN_LIMIT`(后端 errcode 14),不要当网络错误重试:搜索最多 **30**,作品最多 **50**,评论最多 **60**。具体以官网与本次 `message` 为准。
## 1. 什么时候调用
满足任一条件即调用:用户提到快手或 Kuaishou,并要求搜索、看评论、看博主作品或做选题、竞品、舆情。
不要调用:只让写文案;平台是抖音、小红书、B 站、微博、公众号;要求登录、发布、点赞或私密数据;没有关键词也没有可识别链接。
## 2. 路由
按这个顺序判断,命中即停:
1. 要评论、留言、舆情,且对象是一条视频 → `comment-cli.js`
2. 要作品、主页、账号、博主、粉