kuaishou-data-researchlisted
Install: claude install-skill why20261/kuaishou-data-research
# 🎯 快手数据智能助手
> 💡 **一句话价值**:快手数据智能助手。自媒体从业者的数据获取工具,提供快手搜索、作品获取、实时评论数据等实时数据的批量获取,为后续的内容研究、选题分析、用户痛点、数据分析、市场调研、对标账号监控、舆情分析、快手增长等场景提供真实可靠的数据支撑。给一个关键词或一条链接,即可拿回快手公开视频、评论和博主数据;不登录,不发布,结果为 JSON。支持三大能力:(1) 关键词搜索视频,可按点赞数、发布时间、视频时长筛选排序;(2) 达人作品抓取,按主页链接获取公开作品列表;(3) 视频评论分析,按视频链接获取评论内容与互动数据。
| 你要做的事 | 用哪个命令 | 你拿到什么 |
| --- | --- | --- |
| 找选题、看高赞 | `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,并要求搜索、看评论、看博主作品或做选题、竞品、舆情。
不要调用:只让写文案;平台是抖音