Back to search
kuaishou-duration
SkillWorks with Claude CodeGitHub
"快手时间数据只读技能:关键词搜视频、博主作品与粉丝数据、视频评论,输出 JSON,不登录不发布。触发词:快手、Kuaishou、kwai、快手搜索、快手评论、快手博主。用户要查快手视频、评论、爆款选题、竞品监控、KOL 筛选或评论舆情时使用;抖音、小红书、B站、微博、公众号不要用本技能。"
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/guaikei--kuaishou-duration)HTML
<a href="/listings/guaikei--kuaishou-duration"><img src="/api/listings/guaikei--kuaishou-duration/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 242 lines
- ---
- summary: 快手时间数据所需的公开数据(只读):关键词搜索按 --keyword 返回视频列表,--time 按时间范围筛选(0 不限 / 1 近 1 日 / 7 近 7 日 / 30 近 1 月),--duration 按作品时长筛选(1 一分钟内 / 2 一至五分钟 / 3 五分钟以上),输出含 timestamp 时间戳字段。输出结构化 JSON,为时间维度整理提供数据源,按需取回、不自动更新。触发词:快手时间数据、快手时长筛选、快手时间筛选、kuaishou duration、kwai time filter。
- displayName: 快手时间数据|时间筛选·时长筛选·时间字段·按需取回
- slug: kuaishou-duration
- name: kuaishou-duration
- description: "快手时间数据只读技能:关键词搜视频、博主作品与粉丝数据、视频评论,输出 JSON,不登录不发布。触发词:快手、Kuaishou、kwai、快手搜索、快手评论、快手博主。用户要查快手视频、评论、爆款选题、竞品监控、KOL 筛选或评论舆情时使用;抖音、小红书、B站、微博、公众号不要用本技能。"
- license: MIT
- version: 1.1.3
- metadata:
- openclaw:
- emoji: "📷"
- primaryEnv: GUAIKEI_API_TOKEN
- requires:
- bins:
- - node
- env:
- - GUAIKEI_API_TOKEN
- enabled: true
- type: command
- runtime: "nodejs@16.14.0+"
- requires:
- bins: ["node"]
- env: ["GUAIKEI_API_TOKEN"]
- env_desc:
- GUAIKEI_API_TOKEN: "快手数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通。"
- keywords:
- - "快手"
- - "Kuaishou"
- - "快手搜索"
- - "快手评论"
- - "快手博主"
- - "爆款选题"
- - "竞品分析"
- - "评论舆情"
- category:
- - "Integrations"
- - "Research"
- - "数据分析"
- - "内容创作"
- - "商业运营"
- tags:
- - "快手"
- - "Kuaishou"
- - "短视频"
- - "关键词搜索"
- - "视频评论"
- - "博主作品"
- - "竞品分析"
- - "选题调研"
- - "舆情分析"
- - "爆款挖掘"
- - "趋势洞察"
- - "内容选题"
- - "快手运营"
- - "快手内容创作"
- - "快手营销"
- - "快手互动数据统计"
- schemas:
- - name: "输出信封"
- file: "assets/output_envelope.schema.json"
- - name: "搜索入参"
- file: "assets/search_cli_req.schema.json"
- - name: "搜索出参"
- file: "assets/search_cli_resp.schema.json"
- - name: "作品入参"
- file: "assets/post_cli_req.schema.json"
- - name: "作品出参"
- file: "assets/post_cli_resp.schema.json"
- - name: "评论入参"
- file: "assets/comment_cli_req.schema.json"
- - name: "评论出参"
- file: "assets/comment_cli_resp.schema.json"
- examples:
- - "帮我搜快手里「具身智能」的高赞视频 → node scripts/kuaishou/search-cli.js --keyword \"具身智能\" --sort 2 --limit 20"
- - "最近一周最新的快手 AI 教程,要 20 条 → node scripts/kuaishou/search-cli.js --keyword \"AI 教程\" --sort 1 --time 7 --limit 20"
- - "这条快手视频评论区在说什么 → node scripts/kuaishou/comment-cli.js --url \"https://www.kuaishou.com/short-video/3xabc\" --limit 40"
- - "这个快手博主最近 20 条作品 → node scripts/kuaishou/post-cli.js --url \"https://www.kuaishou.com/profile/3xabc\" --sort 0 --limit 20"
- - "这个快手博主多少粉丝 → node scripts/kuaishou/post-cli.js --url 123456 --limit 0"
- ---
- # 📷 快手时间数据|时间筛选 · 时长筛选 · 时间字段 · 按需取回 (Kuaishou Duration Data)
- 给一个关键词或一条主页链接,拿回快手时间数据:--time 按时间范围筛选(近 1 日 / 近 7 日 / 近 1 月),--duration 按作品时长筛选(一分钟内 / 一至五分钟 / 五分钟以上),输出含 timestamp 时间戳。按需取回、不自动更新。不登录,不发布。结果是一份 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`(或用绝对路径,见 [references/faq.md](references/faq.md))。
- 3. stderr 出现「处理中」表示任务还在跑。等进程自己退出,再读 stdout 的最后一份 JSON。不要把 stderr 或整份 JSON 念给用户。
- 4. 按「4. 读结果」的退出码表决定:改参数再试、告诉用户,或停止。
- 5. **Windows 拼参:cmd 只用双引号**包含空格/中文/URL 的参数;不要用 bash 单引号。引号仍拆坏 → 改用 `--json-args`([faq.md](references/faq.md))。Windows / 弱模型优先 `--json-args`。
- 查询最多 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. 要作品、主页、账号、博主、粉丝 → `post-cli.js`
- 3. 有关键词,且没有上面两类信号 → `search-cli.js`
- 4. 以上都不明确 → 先追问
- 链接和 id:
- - `kuaishou.com/profile/{id}` 只能给 `post-cli.js`
- - 纯数字 `user_id` 只能给 `post-cli.js`。搜索结果里用 `user.user_id`,或直接用 `user.url`
- - `kuaishou.com/short-video/{id}`、`v.kuaishou.com/*`、裸的 `3x...` 只能给 `comment-cli.js`。搜索结果里用视频 `id` 或 `url`
- - `user.id` 和作品结果里的 `kwaiId` 是快手号,不要交给作品命令
- - 只拿到一个裸 `3x`、又没说明是视频还是从主页路径里拆出来的,先问。不要两个命令都试
- - `http://` 会改成 `https://`。不带 `www` 的 `kuaishou.com` 会补成 `www`。协议和主机名不区分大小写,id 保持原样
- | 用户说 | 应该传 |
- | --- | --- |
- | 爆款、高赞、什么火 | `search-cli.js --sort 2` |
- | 最新、刚发的 | `search-cli.js --sort 1` |
- | 近一天 | `--time 1` |
- | 近一周、这周 | `--time 7` |
- | 近一月 | `--time 30` |
- | 1 分钟以内 | `--duration 1` |
- | 博主最近发了什么 | `post-cli.js --sort 0 --limit N`。没说条数就问 |
- | 这个博主什么最火 | `post-cli.js --sort 1` |
- | 多少粉丝 | `post-cli.js --limit 0` |
- | 评论区 | `comment-cli.js`。没说条数用默认 10 |
- 搜索的 `--sort 1` 是最新。作品的 `--sort 1` 是最热,`--sort 0` 才是最新。不传作品 `--sort` 时默认最热。
- `--time 2` 不是一周。一周是 `--time 7`。非法值会直接失败。
- ## 3. 参数
- 枚举和数量不在允许范围内时,命令直接失败(退出码 2,`INVALID_ARGS`),不会改成默认值再请求。三个命令都支持 `--help` / `-h`:帮助打在 stderr,退出码 0,stdout 为空,这是正常现象。短参数大小写都可以。含空格的关键词用双引号包成一个参数。关键词以 `-` 开头时写成 `--keyword=-AI`,或 `node scripts/kuaishou/search-cli.js -- -AI`。完整字段见 `assets/*_cli_req.schema.json` 与 [references/options.md](references/options.md)。**Windows**:cmd **只用双引号**;仍拆坏或弱模型 → `--json-args`。双壳例与绝对路径 → [references/faq.md](references/faq.md)。
- **Windows 双壳(同一条搜索,先 cd 到技能目录)**:
- ```bat
- REM cmd —— 不要用单引号
- node scripts\kuaishou\search-cli.js --keyword "AI 教程" --sort 2 --limit 20
- ```
- ```powershell
- # PowerShell
- node scripts/kuaishou/search-cli.js --keyword "AI 教程" --sort 2 --limit 20
- ```
- ### 3.1 关键词搜索
- | 参数 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- |
- | `--keyword` `-k` | 是 | 1–50 个字符,不能是链接,不含 `< > " '` | — |
- | `--sort` `-s` | 否 | `0` 综合 / `1` 最新 / `2` 最多点赞 | `0` |
- | `--time` `-t` | 否 | `0` 不限 / `1` 近 1 日 / `7` 近 7 日 / `30` 近 1 月 | `0` |
- | `--duration` `-d` | 否 | `0` 不限 / `1` 1 分钟内 / `2` 1–5 分钟 / `3` 超过 5 分钟 | `0` |
- | `--limit` `-l` | 否 | 整数 1–10000(**包月 Token 实际最多 30**) | `10` |
- ### 3.2 博主作品
- | 参数 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- |
- | `--url` `-u` | 是 | 主页链接或纯数字 `user_id`,最长 255 | — |
- | `--sort` `-s` | 否 | `0` 最新 / `1` 最热 | `1` |
- | `--limit` `-l` | 否 | 整数 0–10000(**包月最多 50**;`0` 只要博主信息) | `10` |
- ### 3.3 视频评论
- | 参数 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- |
- | `--url` `-u` | 是 | 视频链接、短链或 `3x` 视频 id,最长 255 | — |
- | `--limit` `-l` | 否 | 整数 1–10000(**包月最多 60**) | `10` |
- ## 4. 读结果
- 成功、空结果、失败都是同一份信封。只读 stdout 的最后一份 JSON。`--help` 时 stdout 为空,帮助在 stderr,不要把它当成命令崩溃。字段以 `assets/output_envelope.schema.json` 和 `assets/*_cli_resp.schema.json` 为准。取数成功/empty 时信封顶层可能有 `cost`(花费估算:包月为 `1`,按次为条数×单价);错误响应无此字段。
- ```json
- {
- "status": "success",
- "error_code": "OK",
- "message": "搜索任务完成",
- "timestamp": "2026/10/26 16:20:00",
- "request": { "command": "search", "keyword": "具身智能", "sort": 2, "time": 0, "duration": 0, "limit": 20 },
- "metadata": { "skill_version": "1.1.3", "runtime_version": "22.22.2", "execution_time": 8421 },
- "results": [{ "id": "3xabc", "caption": "..." }],
- "cost": 0.08
- }
- ```
- 空结果仍是退出码 0:`status` 为 `empty`,`error_code` 为 `NO_MATCH`,`results` 为 `null`。失败时 `status` 为 `error`,`results` 为 `null`,`message` 是给人读的原因。
- - 搜索、评论成功时 `results` 是数组
- - 作品成功时 `results` 是对象。`post` 是作品数组,`user` 是博主。`limit` 为 0 时看 `user`
- - 作品视频上的点赞、播放、评论是字符串。搜索和评论里的对应字段是数字
- - 搜索作者有三套标识:视频 `id` 给评论,`user.user_id` 或 `user.url` 给作品,`user.id` 是快手号
- | 退出码 | error_code | 怎么处理 |
- | --- | --- | --- |
- | 0 | `OK` / `NO_MATCH` | 没有结果就告诉用户没有匹配内容,不要当成失败重试 |
- | 2 | `INVALID_ARGS` / `INVALID_KEYWORD` | 按上一节改参数后再试一次。关键词缺失或是链接时先问用户 |
- | 1 | `INVALID_URL` | 按路由换命令,或向用户确认这是视频还是主页 |
- | 3 | `AUTH_REQUIRED` / `AUTH_ERROR` | 停止重试,让用户配置 `GUAIKEI_API_TOKEN` |
- | 1 | `PLAN_LIMIT` | 套餐单次条数超限(常见于包月 Token)。**禁止同参重试**。转述 `message`;可建议降低 `--limit`(搜索≤30,作品≤50,评论≤60)或到官网升级按量;**须用户同意后再跑**。禁止擅自加大 limit |
- | 1 | `INSUFFICIENT_BALANCE` | 余额不足(常为后端 15)。**禁止同参重试**。引导官网充值 |
- | 1 | `RATE_LIMITED` | 短时间提交过多(常为后端 2)。**禁止立即重试**。稍后经用户同意再跑 |
- | 1 | `DAILY_LIMIT` | 今日消费已达每日上限(后端 18)。**禁止同参重试**。明日再试或到官网调整限额 |
- | 1 | `TIMEOUT` | 任务仍在处理。大约 20 分钟内用同一组参数重跑会复用已有任务。宿主提前结束进程时不要立刻连打 |
- | 1 | `NETWORK_ERROR` / `HTTP_5xx` / `HTTP_429` | 命令内部已经重试过。退出后再失败就告诉用户稍后再试,不要立刻连打 |
- | 1 | 十进制数字,例如 `"12"` | 把 `message` 原样转告。不要把 `"1"` 当成业务失败,那是处理中,命令会自己等 |
- | 1 | `API_ERROR` / `UNKNOWN` | 转告 `message`,建议联系官网 |
- `error_code` 是字符串。查询还在处理、次数用尽时是 `TIMEOUT`,不是空结果。
- ## 5. 合规
- 只处理快手公开数据。调用时会把关键词或链接发到 `www.guaikei.com`。不上传本地文件,不登录,不发布。
- 成功结果默认不写文件。需要留底时加 `--save`,或设置 `GUAIKEI_ENABLE_LOG=1`,文件写到系统临时目录的 `kuaishou-guaikei/logs/`。POSIX 上权限是仅当前用户可读写;Windows 不使用这组权限位,靠临时目录本身的用户隔离。旧变量 `KS_GUAIKEI_ENABLE_LOG` 已废弃。
- 开通 token 或人工支持:[快手时间数据说明](https://www.guaikei.com)。
readme.md · README · 94 lines
- # 📊 快手时间数据|时间筛选 · 时长筛选 · 时间字段 · 按需取回
- > **一句话价值主张**:一款专业的快手数据分析工具,通过挖掘爆款视频、监控竞品动态、筛选高价值KOL,帮助你实现快手账号的快速增长与精准营销。
- ## 1. 技能概述
- 这是一款专注于**快手数据挖掘**的工具。它能够穿透快手的公开数据层,为你提供深度的**竞品监控**、**趋势预测**和**KOL 筛选**服务。无论你是内容创作者、品牌营销人员还是市场分析师,都能通过此工具获取决策支持。
- **🔥核心优势**
- > - 安全: 无需登录你的快手账号,不担心风控风险 / 封号问题
- > - 强大: 按量 Token 单次最多 10000 条;包月 Token 搜索最多 30、作品最多 50、评论最多 60
- > - 全面: 各功能出参数据全面,可见及有价值数据都会返回
- > - 灵活: 支持排序、时间和时长筛选,结果为 JSON
- > - 轻量: 无需部署服务,Node.js 一键运行
- > - 实用: 可选 `--save` / `GUAIKEI_ENABLE_LOG=1` 日志留底,适配营销报告 / 内容策划场景
- **🎯 核心能力**
- | 使用场景 | 具体价值 |
- | --------------- | ------------------------------------------------------------- |
- | 🔍 内容创作选题 | 输入关键词,筛选「最多点赞」视频,快速找到爆款选题方向 |
- | 🕵️ 品牌竞品监控 | 输入竞品账号链接,分析其互动数据、内容风格,制定差异化策略 |
- | 👥 KOL筛选 | 解析KOL视频的真实互动率(点赞/评论/收藏),避免数据造假的博主 |
- | 💬 评论分析 | 获取快手评论详情,分析舆情方向 |
- | 📈 市场趋势分析 | 定时监控关键词「最新发布」,捕捉快手热点风向,提前布局内容 |
- **✨ 适用人群**
- ✅ 快手内容创作者/运营 | ✅ 品牌营销/市场人员 | ✅ 数据分析师 | ✅ MCN机构/经纪人
- ## 2. 🚀 快速使用
- > **Note:** 请先访问[快手时间数据官网](https://www.guaikei.com)开通 TOKEN,配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。
- ### 2.1 快手关键词搜索
- ```bash
- node scripts/kuaishou/search-cli.js --keyword "AI"
- ```
- ### 2.2 快手博主作品监控
- ```bash
- node scripts/kuaishou/post-cli.js --url "https://www.kuaishou.com/profile/3xxx" --limit 20
- ```
- ### 2.3 快手视频评论分析
- ```bash
- node scripts/kuaishou/comment-cli.js --url "https://www.kuaishou.com/short-video/3xxx" --limit 40
- ```
- **💡 详细选项说明**, 可参阅 [完整选项说明](references/options.md)
- > **套餐双上限**:技能硬上限 10000(按量)。包月超限返回 `PLAN_LIMIT`(退出码 1),不要当网络错误同参重试;可降 `--limit` 或到官网升级,须用户同意后再跑。
- ## 3. 📌 使用场景
- - 需要做内容选题 → 关键词搜索 + 最多点赞排序
- - 需要看高赞内容 → 关键词搜索,排序选最多点赞
- - 需要监控竞品账号 → 抓取对方公开作品
- - 需要分析评论区情绪 → 查看视频的评论内容及互动数据
- - 需要快速追热点 → 按「最新发布」搜索关键词
- ## 4. ⚠️ 重要限制
- - 仅抓取快手公开数据,不支持私密 / 隐藏内容
- - 需要配置 GUAIKEI_API_TOKEN 才能正常运行
- - 按量 Token 单次最多 10000;**包月**搜索 ≤30、作品 ≤50、评论 ≤60,超限为 `PLAN_LIMIT`
- - 数据仅限个人 / 团队内部使用,禁止违规分发
- - 本工具无需登录快手账号,不涉及用户隐私数据的获取
- ## 5. ❓ 技术说明
- ### 5.1 运行环境兼容说明
- - 系统兼容:Windows/Linux/MacOS(无需额外依赖,仅需Node.js)
- - Node.js版本:推荐16.14.0+
- - 网络要求:需能正常访问网络,国内服务器无需代理
- - 权限要求:无需管理员权限,普通用户即可运行
- ### 5.2 日志说明
- - 启动时会打印工具Banner,方便确认是否正确执行;
- - 过程中会输出彩色日志,用于反馈技能执行情况,过程中无需用户交互;
- - 成功结果默认不写文件。需要留底时加 `--save` 或设置 `GUAIKEI_ENABLE_LOG=1`,文件保存到系统临时目录下的 `kuaishou-guaikei/logs/`(按时间加关键词或链接命名)。POSIX 上仅当前用户可读写;Windows 靠用户目录隔离。旧变量 `KS_GUAIKEI_ENABLE_LOG` 已废弃。
- - 字段说明见 `assets/*.schema.json`。
- > 版本更新日志,请参阅 [changelog.md](references/changelog.md)
- ## 6. 📞 帮助与支持
- - 通过 [快手时长筛选查询](https://www.guaikei.com) 自助开通 TOKEN 或查阅使用帮助。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.