Skip to content
Back to search

xiaohongshu-duration

SkillWorks with Claude CodeGitHub

"小红shu时间数据只读技能:关键词搜笔记、爆款选题、笔记详情、评论舆情、博主作品、粉丝获赞与收藏,输出 JSON,不登录不发布。触发词:小红书、小红薯、xhs、rednote、笔记链接、博主主页、竞品监控、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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/guaikei--xiaohongshu-duration/badge.svg)](/listings/guaikei--xiaohongshu-duration)

HTML

<a href="/listings/guaikei--xiaohongshu-duration"><img src="/api/listings/guaikei--xiaohongshu-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 · 235 lines
  1. ---
  2. summary: 小红shu时间数据所需的公开数据(只读):关键词搜索按 --keyword 返回笔记列表,--time 按发布时间筛选(近 1 日 / 一周内等档位);笔记列表含 create_time 与 video_duration 时长字段,笔记详情返回 publish_time 发布时间字段。输出结构化 JSON,为时间维度整理提供数据源,按需取回、不自动更新。触发词:小红shu时间数据、小红shu发布时间、小红shu时间筛选、xhs duration、rednote publish time。
  3. displayName: 小红shu时间数据|发布时间·时间筛选·时长字段·按需取回
  4. slug: xiaohongshu-duration
  5. name: xiaohongshu-duration
  6. description: "小红shu时间数据只读技能:关键词搜笔记、爆款选题、笔记详情、评论舆情、博主作品、粉丝获赞与收藏,输出 JSON,不登录不发布。触发词:小红书、小红薯、xhs、rednote、笔记链接、博主主页、竞品监控、KOL筛选、评论分析。用户要查小红书笔记、评论、选题、竞品或舆情时使用;抖音、快手、B站、微博、公众号不要用本技能。"
  7. license: MIT
  8. version: 1.2.3
  9. category: 数据分析
  10. homepage: https://www.guaikei.com
  11. metadata:
  12. openclaw:
  13. emoji: "📕"
  14. primaryEnv: GUAIKEI_API_TOKEN
  15. requires:
  16. bins:
  17. - node
  18. env:
  19. - GUAIKEI_API_TOKEN
  20. enabled: true
  21. type: command
  22. runtime: "nodejs@16.14.0+"
  23. requires:
  24. bins: ["node"]
  25. env: ["GUAIKEI_API_TOKEN"]
  26. env_desc:
  27. GUAIKEI_API_TOKEN: "小红书数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通。"
  28. keywords:
  29. - "小红书"
  30. - "小红薯"
  31. - "xhs"
  32. - "rednote"
  33. - "小红书搜索"
  34. - "小红书笔记"
  35. - "小红书评论"
  36. - "小红书博主"
  37. - "爆款选题"
  38. - "竞品分析"
  39. - "KOL筛选"
  40. - "评论舆情"
  41. - "xiaohongshu"
  42. category:
  43. - "Integrations"
  44. - "Research"
  45. - "Creative"
  46. - "内容创作"
  47. - "数据分析"
  48. - "商业运营"
  49. tags:
  50. - "小红书"
  51. - "小红书搜索"
  52. - "小红书笔记"
  53. - "小红书评论"
  54. - "小红书博主"
  55. - "小红书运营"
  56. - "小红书数据分析"
  57. - "爆款选题"
  58. - "竞品分析"
  59. - "KOL筛选"
  60. - "评论舆情分析"
  61. - "内容选题调研"
  62. - "趋势洞察"
  63. - "种草营销"
  64. - "新媒体运营"
  65. - "关键词搜索"
  66. - "评论分析"
  67. - "选题调研"
  68. - "爆款挖掘"
  69. - "小红书内容创作"
  70. - "小红书营销"
  71. schemas:
  72. - name: "输出信封"
  73. file: "assets/output_envelope.schema.json"
  74. - name: "搜索入参"
  75. file: "assets/search_cli_req.schema.json"
  76. - name: "搜索出参"
  77. file: "assets/search_cli_resp.schema.json"
  78. - name: "详情入参"
  79. file: "assets/detail_cli_req.schema.json"
  80. - name: "详情出参"
  81. file: "assets/detail_cli_resp.schema.json"
  82. - name: "评论入参"
  83. file: "assets/comment_cli_req.schema.json"
  84. - name: "评论出参"
  85. file: "assets/comment_cli_resp.schema.json"
  86. - name: "作品入参"
  87. file: "assets/post_cli_req.schema.json"
  88. - name: "作品出参"
  89. file: "assets/post_cli_resp.schema.json"
  90. examples:
  91. - "帮我找最近一周小红书『露营装备』的高赞图文笔记 → node src/xiaohongshu/search-cli.js --keyword '露营装备' --type 2 --sort 2 --time 2 --limit 20"
  92. - "这条小红书笔记评论区在吐槽什么 → node src/xiaohongshu/comment-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy' --limit 20"
  93. - "看这个小红书博主最近 30 条作品发什么 → node src/xiaohongshu/post-cli.js --url 'https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy' --limit 30"
  94. - "分析这篇小红书爆款笔记为什么火 → node src/xiaohongshu/detail-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy'"
  95. - "监控『多巴胺穿搭』最新动态 → node src/xiaohongshu/search-cli.js --keyword '多巴胺穿搭' --sort 1 --time 1 --limit 40"
  96. - "这个小红书博主多少粉丝 → node src/xiaohongshu/post-cli.js --url 'https://www.xiaohongshu.com/user/profile/xxx' --limit 0"
  97. - "只要这篇笔记近 30 天的评论 → node src/xiaohongshu/comment-cli.js --url 'https://www.xiaohongshu.com/explore/xxx' --expired_at 30 --limit 20"
  98. ---
  99. # 📕 小红shu时间数据|发布时间 · 时间筛选 · 时长字段 · 按需取回(无需登录 / 不封号) (XHS Duration Data)
  100. 小红shu时间数据只读:关键词搜索按 --keyword 返回笔记列表,--time 按发布时间筛选(近 1 日 / 一周内等档位);笔记列表含 create_time 与 video_duration 时长字段,笔记详情返回 publish_time 发布时间字段。输出结构化 JSON,为时间维度整理提供数据源,按需取回、不自动更新。适用于整理发布时间与时长字段。
  101. ## 1. ⚠️ 执行前置(每次必过)
  102. 1. **先 `cd` 到本 SKILL.md 所在目录**,再执行 `node src/xiaohongshu/*.js`(或用绝对路径,见 [faq.md](references/faq.md))。
  103. 2. **确认 `GUAIKEI_API_TOKEN` 已配置**。未配置 → 不执行,走 `AUTH_REQUIRED`(见 §7 / [errors.md](references/errors.md)),禁止先跑「试试看」。
  104. 3. **一次只跑一条命令,等进程自己结束**。查询最多约 20 次退避,只算等待大约 15 分钟。stderr「处理中」不是失败。**未退出前不要判定失败,不要并发/重复同一命令。**
  105. 4. **必填参数不齐先追问**(话术见 [ask.md](references/ask.md)),禁止猜测关键词或链接。
  106. 5. **Windows 拼参:cmd 只用双引号**包含空格/中文/URL 的参数;不要用 bash 单引号。引号仍拆坏 → 改用 `--json-args`([faq.md](references/faq.md))。Windows / 弱模型优先 `--json-args`。
  107. > 开通[小红shu时间数据服务](https://www.guaikei.com) TOKEN。配 TOKEN / 落盘 / FAQ → [faq.md](references/faq.md)。
  108. ## 2. 💎 价值与典型场景(10 秒判断该不该用)
  109. | 你是谁 | 你要做的事 | 用哪个命令 |
  110. | --- | --- | --- |
  111. | 创作者 / 运营 | 找爆款选题、看高赞图文共同点 | `search-cli.js --sort 2` |
  112. | 品牌 / 投放 | 监控已知博主发文与互动 | `post-cli.js`(要作品须显式 `--limit`) |
  113. | 内容分析 | 看一篇笔记正文、图片、互动 | `detail-cli.js` |
  114. | 舆情 / 客服 | 评论区在吐槽还是在夸 | `comment-cli.js` |
  115. | MCN / 商务 | 看粉丝、获赞、收藏 | `post-cli.js --limit 0` |
  116. **何时用**:用户提小红书/小红薯/xhs/rednote,并要搜、看、分析公开数据;或给了笔记/主页/短链/id。
  117. **何时不用**:只写文案不查数;平台是抖音/快手/B 站/微博/公众号;要登录、私密、草稿、创作者/商业化后台。
  118. **为什么用它**:只读、不登录;零第三方依赖;按量单次最多 1 万条;stdout 纯 JSON、日志走 stderr。
  119. > **合规**:调用会把关键词/链接发到 `www.guaikei.com`。不上传本地文件。仅公开数据,限个人/团队内部分析。
  120. ## 3. 🎯 识别卡(选命令,命中即停)
  121. | 用户要什么 | 命令 | 最少要有 |
  122. | --- | --- | --- |
  123. | 搜笔记、爆款、选题 | `node src/xiaohongshu/search-cli.js` | `--keyword` |
  124. | 一篇笔记的正文 / 为什么火 | `node src/xiaohongshu/detail-cli.js` | 笔记链接或 24 位笔记 id |
  125. | 一篇笔记的评论 / 舆情 | `node src/xiaohongshu/comment-cli.js` | 笔记链接或 24 位笔记 id |
  126. | 博主作品、粉丝、获赞 | `node src/xiaohongshu/post-cli.js` | 主页链接或 24/29 位 `user_id` |
  127. - 正文和评论都要:先 `detail-cli`,再 `comment-cli`。
  128. - 24 位 id / 短链类型不明:先追问([ask.md](references/ask.md)),禁止两个命令都试。
  129. - App 分享文案可整段粘贴给 `--url`,命令会自动抽链(保留 `xsec_token`)。
  130. ## 4. 🛠️ 命令一行例(详参下沉)
  131. > **详参 / 枚举**:需要确认取值时再读 [options.md](references/options.md) 。**不要每次都读。**
  132. > 注意:`-t` = 内容类型,`-i` = 发布时间。`--time 2` = 一周内;`--sort 2` = 最多点赞。
  133. > **Windows**:cmd **只用双引号**;PowerShell 含空格也优先双引号。仍拆坏或弱模型 → `--json-args`。双壳例 → [faq.md](references/faq.md)。
  134. ```bash
  135. node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
  136. node src/xiaohongshu/search-cli.js --keyword "多巴胺穿搭" --sort 1 --time 1 --limit 40
  137. node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
  138. node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --limit 20
  139. node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --expired_at 30 --limit 20
  140. node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 30
  141. node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 0
  142. ```
  143. **Windows 双壳(同一条搜索,先 cd 到技能目录)**:
  144. ```bat
  145. REM cmd —— 参数必须用双引号,不要用单引号
  146. node src\xiaohongshu\search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
  147. ```
  148. ```powershell
  149. # PowerShell —— 含空格/中文同样用双引号
  150. node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
  151. ```
  152. **数量 / 套餐**:搜索默认 **20**;评论默认 **10**;博主不传 `--limit` 默认 **0**(只有博主信息)。不要擅自抓 10000。技能硬上限 10000(按量)。**包月**超限 → `PLAN_LIMIT`:搜索 ≤40,作品 ≤30,评论 ≤20;详情无此条数限制。
  153. 口语 → flag 对照 → [routing.md](references/routing.md)。
  154. ## 5. 🔀 意图路由(按序命中即停)
  155. ```
  156. 1. 评论/留言/舆情 + 对象是一篇笔记 → comment-cli
  157. 2. 作品/主页/账号/博主/粉丝/获赞 → post-cli
  158. 3. 一篇笔记的标题/正文/图片/互动 → detail-cli
  159. 4. 有关键词且无以上信号 → search-cli
  160. 5. 都不明确 → 先追问(ask.md)
  161. ```
  162. 消歧:`/user/profile/` → 只能 post;`/explore/` 或 `/discovery/item/` + 评论 → comment,+ 正文 → detail,都没说 → 追问。选题可先 `search --sort 2 --time 2 --limit 30`,再对挑出的笔记跑详情。竞品看作品必须显式 `--limit`。
  163. ## 6. 📜 输出(摘要)
  164. - stdout = 统一 JSON 信封;stderr = 日志。向用户**只摘关键字段**,勿整份粘贴。取数成功/empty 时信封顶层可能有 `cost`(花费估算,见 [contract.md](references/contract.md))。
  165. - `status=empty` + `NO_MATCH` 退出码 0,**不是失败**。
  166. - `results`:搜/评论 = 数组;详情 = 单对象;作品 = `{note,user}`。
  167. - 互动数是字符串;比较前先转数字。
  168. 完整信封与形态 → [contract.md](references/contract.md)。Schema 在 `assets/`。
  169. ## 7. 🚨 错误应对(摘要)
  170. | error_code | 退出码 | Agent |
  171. | --- | --- | --- |
  172. | `AUTH_*` | 3 | **禁止重试**;引导官网配 TOKEN |
  173. | `PLAN_LIMIT` | 1 | **禁止同参重试**;降 limit 须用户同意(搜≤40 / 作品≤30 / 评论≤20) |
  174. | `INSUFFICIENT_BALANCE` / `DAILY_LIMIT` | 1 | **禁止同参重试**;充值或明日/调限额 |
  175. | `RATE_LIMITED` | 1 | **禁止立即重试** |
  176. | `INVALID_*` | 1/2 | 换词/换链/按 help 改一次;禁止擅自改默认再跑 |
  177. | `NO_MATCH` | 0 | 如实无结果 |
  178. | `TIMEOUT` / `NETWORK_ERROR` | 1 | 同参续等最多 1 次(搜/作品/评论约 20 分钟、详情约 19 分钟复用);禁止改参「重做」 |
  179. 全表 → [errors.md](references/errors.md)。
  180. ## 8. 🛑 硬性禁止
  181. - 不得编造数据;不得把空结果说成有结果。
  182. - 不得未征得同意就自动改搜索条件重试;不得编造关键词或链接。
  183. - `AUTH_*` / `PLAN_LIMIT` / `INSUFFICIENT_BALANCE` / `RATE_LIMITED` / `DAILY_LIMIT` 后不得同参或立即重试。
  184. - 不得把 stderr 原文转述给用户;不得整份 JSON 贴回对话。
  185. - 不得做登录态/私密获取或任何写操作。
  186. - 不得在未 cd 到技能目录时执行 `node src/xiaohongshu/*.js`。
  187. - 24 位 id / 短链类型不明时,不得两个命令都试。
  188. ## 9. 📚 何时读 references(入口总表)
  189. | 时机 | 打开 |
  190. | --- | --- |
  191. | 确认枚举/参数取值 | [options.md](references/options.md) |
  192. | 口语指令 → flag / 链接消歧 | [routing.md](references/routing.md) |
  193. | 信封 / `results` 形态 | [contract.md](references/contract.md) |
  194. | 完整错误表 | [errors.md](references/errors.md) |
  195. | 缺参追问话术 | [ask.md](references/ask.md) |
  196. | 环境 / FAQ | [faq.md](references/faq.md) |
  197. | 逐步排障问答 | [troubleshooting.md](references/troubleshooting.md) |
  198. | 版本变更 | [changelog.md](references/changelog.md) |
  199. | 技术人员总览 | [readme.md](readme.md) |
  200. | 机器可校验 Schema | `assets/*.schema.json` |
readme.md · README · 277 lines
  1. # 📕 小红shu时间数据|发布时间 · 时间筛选 · 时长字段 · 按需取回(无需登录 / 不封号)
  2. > **💡 一句话价值**:给一个关键词或一条链接,拿回小红书公开笔记、评论和博主数据——直接输出结构化 JSON。做爆款选题、盯竞品、筛 KOL、读评论区,不用再手工刷一小时再记点赞。
  3. **只读公开数据 · 不登录你的小红书账号 · 按量最多 1 万条;包月搜索 / 作品 / 评论分别最多 40 / 30 / 20 · 装进 Agent 就能用口语化指令获取数据**
  4. **维护状态**:持续更新中,当前版本 `1.2.3`,[更新日志](references/changelog.md)。Agent 执行卡见 [SKILL.md](SKILL.md)。
  5. 👉 开通 [小红shu时间数据 TOKEN](https://www.guaikei.com)
  6. > **🔥 核心优势(适合放进 Agent)**
  7. >
  8. > - 🔒 **安全只读**:不登录小红书账号;无发布、点赞、评论、关注;无封号风险
  9. > - 💪 **双上限清晰**:按量 Token 单次最多 10000 条;包月搜索 ≤40、作品 ≤30、评论 ≤20
  10. > - 🎛️ **参数说了算**:类型、排序、时间、数量越界就失败,不会偷偷改成默认值
  11. > - 🤖 **一份 JSON**:成功 / 无结果 / 失败同一信封,AI 可直接解析;零第三方依赖
  12. > - 🇨🇳 **国内直连**:Windows / macOS / Linux 均可,不用代理
  13. ---
  14. ## ✅ 我能帮你解决什么(10 秒判断)
  15. | 你是谁 | 你要做的事 | 用这个技能 |
  16. | --- | --- | --- |
  17. | 🎯 创作者 / 运营 | 下周选题:翻几十条笔记自己记点赞 | 一条搜索拿回标题、摘要和互动数 |
  18. | 📊 品牌 / 投放 | 竞品这周发了什么:每天打开主页往下刷 | 博主作品列表,带发布时间与互动 |
  19. | 🤝 MCN / 商务 | 这个 KOL 值不值得合作:看粉丝拍脑袋 | 粉丝、获赞、收藏一起回来再算比值 |
  20. | 💬 舆情 / 客服 | 评论区在说什么:一条条往下翻 | 一次拉评论,交给 AI 归纳观点 |
  21. | 📰 内容分析 | 这篇为什么火:只有标题猜 | 笔记详情:正文、图片、互动、作者 |
  22. | 🔥 所有人 | 今天刚起来的话题:反复刷发现页 | 「最新 + 一天内」直接筛出来 |
  23. **典型产出**:结构化 JSON(标题、作者、点赞 / 收藏 / 评论 / 分享、链接、时间),可导入 Excel / BI,或交给 AI 继续做:**标题公式、爆款归因、评论聚类、发文节奏、能发出去的报告**。
  24. ---
  25. ## 🎁 四件事,各用一条命令
  26. | 你要做的事 | 命令 | 你拿到什么 |
  27. | --- | --- | --- |
  28. | 🔍 找选题、看高赞 | `search-cli.js` | 笔记数组。点赞、收藏、评论、分享 |
  29. | 📰 看一篇笔记正文 | `detail-cli.js` | 一个笔记对象。不含评论 |
  30. | 💬 看评论区 | `comment-cli.js` | 评论数组(可按近 N 天过滤) |
  31. | 📸 看博主作品 | `post-cli.js --limit > 0` | `results.note` + 可能有的 `results.user` |
  32. | 👥 看粉丝、获赞、收藏 | `post-cli.js --limit 0` | `results.user`:`fans` / `liked` / `collected` / `interaction` |
  33. 不登录、不发布、不点赞、不评论、不关注。私密笔记、草稿、创作者后台和投放后台都不在范围内。
  34. ---
  35. ## 🚀 3 步开始
  36. **1. 开通 TOKEN**
  37. 到[小红shu发布时间查询](https://www.guaikei.com)开通。TOKEN 是 16–256 位的字符串。
  38. **2. 配到环境变量**
  39. ```bash
  40. # Windows (PowerShell)
  41. $env:GUAIKEI_API_TOKEN = "你的TOKEN"
  42. # macOS / Linux
  43. export GUAIKEI_API_TOKEN="你的TOKEN"
  44. ```
  45. **3. 进技能目录,跑第一条——或直接对 AI 说要求**
  46. ```bash
  47. cd <本技能所在目录> # 即 readme.md / SKILL.md 所在的那一层
  48. node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
  49. ```
  50. 装进 WorkBuddy、Openclaw、Hermes、豆包办公、千问办公、Claude Code 或 Codex 之后,可以这样说:
  51. - 「帮我找最近一周小红书露营装备的高赞图文,先看 20 条」
  52. - 「这篇笔记评论区近 30 天在吐槽什么」
  53. - 「这个博主多少粉丝,最近发了哪 30 条」
  54. - 「分析这篇小红书爆款笔记为什么火」
  55. > ⚠️ 需要 Node.js 16.14.0+,没有别的依赖。一次只跑一条命令,等进程自己退出。stderr「处理中」不是失败。
  56. ---
  57. ## ⚡ 最快上手(复制就能跑)
  58. ```bash
  59. # 🔎 最近一周「露营装备」高赞图文
  60. node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
  61. # 🔥 一天内「多巴胺穿搭」最新(包月勿超 40)
  62. node src/xiaohongshu/search-cli.js --keyword "多巴胺穿搭" --sort 1 --time 1 --limit 40
  63. # 📰 看一篇笔记正文与互动
  64. node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
  65. # 💬 近 30 天评论(包月勿超 20)
  66. node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --expired_at 30 --limit 20
  67. # 📸 博主近 30 条作品
  68. node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 30
  69. # 👥 只要粉丝、获赞、收藏
  70. node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 0
  71. ```
  72. > 💡 搜索默认 20 条;评论默认 10 条;博主不写 `--limit` 时只有资料、没有作品列表。
  73. > 💡 `--time 2` = 一周内(不是 2 天);`--sort 2` = 最多点赞(不是最新)。`-t` 是类型,`-i` 才是时间。
  74. ---
  75. ## 🔧 命令与参数详表
  76. > 枚举越界会直接失败(退出码 2),不会改成默认值再请求。更细的链接规则与口语映射见 [references/options.md](references/options.md)、[references/routing.md](references/routing.md)。机器 Schema 见 `assets/`。
  77. **套餐双上限**:技能硬上限 10000(按量)。**包月**超限返回 `PLAN_LIMIT`:搜索 ≤40,作品 ≤30,评论 ≤20;详情无此条数限制。
  78. ### 🔍 关键词搜索 `search-cli.js`
  79. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  80. | --- | --- | --- | --- | --- |
  81. | `--keyword` | `-k` | ✅ | 1–50 个字符,不能是链接,不含 `< > " '` | — |
  82. | `--type` | `-t` | | `0` 全部 / `1` 视频 / `2` 图文 | `0` |
  83. | `--sort` | `-s` | | `0` 综合 / `1` 最新 / `2` 最多点赞 / `3` 最多评论 / `4` 最多收藏 | `0` |
  84. | `--time` | `-i` | | `0` 全部 / `1` 一天内 / `2` 一周内 / `3` 半年内 | `0` |
  85. | `--limit` | `-l` | | 1–10000(**包月 Token 实际最多 40**) | `20` |
  86. 这些数字不是天数:`--time 2` = 一周内;`--sort 2` = 最多点赞。关键词以 `-` 开头时写成 `--keyword=-AI`,或 `node src/xiaohongshu/search-cli.js -- -AI`。
  87. ### 📰 笔记详情 `detail-cli.js`
  88. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  89. | --- | --- | --- | --- | --- |
  90. | `--url` | `-u` | ✅ | 笔记链接或 24 位笔记 id(最长按接口 255) | — |
  91. 支持 `explore/{id}`、`discovery/item/{id}`、`xhslink.com|cn` 的 `/m/*` `/o/*`、以及裸 24 位 id。主页链接不要传给本命令。成功时 `results` 是**一条笔记对象**,不含评论。可整段粘贴 App 分享文案,自动抽链并保留 `xsec_token`。
  92. ### 👥 博主作品 `post-cli.js`
  93. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  94. | --- | --- | --- | --- | --- |
  95. | `--url` | `-u` | ✅ | 主页链接,或 24 / 29 位 `user_id`(最长按接口 255) | — |
  96. | `--limit` | `-l` | | 0–10000(**包月最多 30**;**`0` = 只要博主互动数据**) | `0` |
  97. 支持 `user/profile/{user_id}`、四类短链、24/29 位 id。不传 `--limit` 不会返回作品列表;要看最近发了什么必须写出条数。成功时 `results` 为 `{ note, user }`。可整段粘贴 App 分享文案,自动抽链。
  98. ### 💬 笔记评论 `comment-cli.js`
  99. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  100. | --- | --- | --- | --- | --- |
  101. | `--url` | `-u` | ✅ | 笔记链接或 24 位笔记 id(含 `explore`、`discovery/item`、短链) | — |
  102. | `--expired_at` | `-e` | | `1-2190` 天(约 6 年),或 `YYYY-MM-DD HH:mm:ss`(不早于 2000、不能未来;`--expire` 同义)。勿传 Unix 时间戳 | 不传则按北京时间近 6 年换算 |
  103. | `--limit` | `-l` | | 1–10000(**包月最多 20**) | `10` |
  104. `expired_at` 是时间过滤,不是分页。`limit=10000` 且 `expired_at=1` 也只返回近 1 天的评论。同样支持整段粘贴 App 分享文案自动抽链。
  105. ### 🗂️ Schema 入口
  106. - 输出信封 [output_envelope.schema.json](assets/output_envelope.schema.json)
  107. - 关键词搜索 [入参](assets/search_cli_req.schema.json) / [出参](assets/search_cli_resp.schema.json)
  108. - 笔记详情 [入参](assets/detail_cli_req.schema.json) / [出参](assets/detail_cli_resp.schema.json)
  109. - 博主作品 [入参](assets/post_cli_req.schema.json) / [出参](assets/post_cli_resp.schema.json)
  110. - 笔记评论 [入参](assets/comment_cli_req.schema.json) / [出参](assets/comment_cli_resp.schema.json)
  111. ---
  112. ## 📦 你会得到什么(真实输出结构示例)
  113. 成功、没有结果、失败,都是同一份 JSON。程序和 AI 都能直接读。
  114. ```json
  115. {
  116. "status": "success",
  117. "error_code": "OK",
  118. "message": "搜索任务完成",
  119. "timestamp": "2026/10/22 15:16:11",
  120. "request": {
  121. "command": "search",
  122. "keyword": "露营装备",
  123. "type": 2,
  124. "sort": 2,
  125. "time": 2,
  126. "limit": 20
  127. },
  128. "metadata": {
  129. "skill_version": "1.2.3",
  130. "runtime_version": "22.x",
  131. "execution_time": 34210
  132. },
  133. "results": [
  134. {
  135. "id": "6a377d460000000000000000",
  136. "xsec_token": "yyy",
  137. "title": "深圳奇妙日花费大概多少",
  138. "desc": "奇妙日如果不买很多周边去互动……",
  139. "liked_count": "336",
  140. "collected_count": "128",
  141. "comment_count": "193",
  142. "shared_count": "45",
  143. "user": { "nickname": "xxx", "user_id": "66a8abcd0000000000000000" },
  144. "publish_time": "2026-09-08 20:06:00",
  145. "type": "normal"
  146. }
  147. ]
  148. }
  149. ```
  150. 打开某一条笔记时,用 `https://www.xiaohongshu.com/explore/{id}`。有 `xsec_token` 再接上 `?xsec_token=`。
  151. 互动数是字符串,空字符串和数字 0 有时不会出现。比较之前先转成数字。
  152. ---
  153. ## 👥 谁会用它
  154. 小红书创作者和运营、品牌市场、MCN 和博主经纪人、需要把公开内容喂给 Agent 的人。
  155. 它给的是公开数据,不替你做投放决策。判断还是你来。
  156. ---
  157. ## ❓ 购买前你可能想问
  158. **🔐 要登录我的小红书账号吗?**
  159. 不用。这个技能不碰你的账号,也不做发布、点赞、评论、关注。
  160. **📡 数据从哪来?**
  161. 经[小红shu时间数据接口](https://www.guaikei.com)返回,只覆盖小红书公开可见的内容。除了关键词和链接这类查询参数,不上传你电脑上的其他数据。结果请在个人或团队内部分析时使用。
  162. **🔑 一定要 TOKEN 吗?**
  163. 要。接口按 TOKEN 调用。开通入口在[小红shu时间数据官网](https://www.guaikei.com)。
  164. **⏱️ 查一条要等多久?**
  165. 小批量通常一轮查询就能回来。条数大、或者任务还在处理时,命令会继续等,屏幕上的「处理中」不是失败。等命令结束再看结果。
  166. **🧭 AI 会不会查错平台?**
  167. 技能说明里写明了:只处理小红书。抖音、快手、B 站、微博、公众号不会走这里。
  168. **🌐 我在国内,要代理吗?**
  169. 不用。
  170. **📏 单次能拉多少条?**
  171. 技能侧硬上限 10000 条/次(按量 Token)。**包月 Token** 搜索最多 40、作品最多 30、评论最多 20,超限返回 `PLAN_LIMIT`(退出码 1),不要当网络错误重试。具体计费口径以官网说明为准。
  172. **⚠️ 报错 `PLAN_LIMIT` / 提示包月受限?**
  173. 降低 `--limit` 后须用户同意再跑,或到[小红shu时间数据套餐页](https://www.guaikei.com)升级按量;**禁止同参重试**。
  174. ---
  175. ## 🚧 边界
  176. - 公开笔记、评论、博主信息。私密、草稿、仅粉丝可见、创作者后台、商业化后台都不支持
  177. - 不做写操作
  178. - 按量最多 1 万条;包月更低(搜索 40 / 作品 30 / 评论 20)。用户没说要多少时,搜索默认 20,评论默认 10,博主默认只看资料
  179. 默认不落盘。需要留底时加 `--save` 或设 `GUAIKEI_ENABLE_LOG=1`,写入系统临时目录 `xiaohongshu-guaikei/logs/当天日期/`(不写进技能目录)。旧 `XHS_GUAIKEI_DISABLE_LOG` 已废弃。
  180. ---
  181. ## 📚 文档入口
  182. | 你想看什么 | 打开 |
  183. | --- | --- |
  184. | Agent 执行卡 | [SKILL.md](SKILL.md) |
  185. | 命令参数详表 | 本文「🔧 命令与参数详表」;更细见 [references/options.md](references/options.md) |
  186. | 口语 → 参数 | [references/routing.md](references/routing.md) |
  187. | 错误应对 | [references/errors.md](references/errors.md) |
  188. | 环境 / FAQ | [references/faq.md](references/faq.md) |
  189. | 逐步排障 | [references/troubleshooting.md](references/troubleshooting.md) |
  190. | 版本变更 | [references/changelog.md](references/changelog.md) |
  191. ---
  192. ## 🎉 现在就可以开通
  193. 去[小红shu时间筛选查询文档](https://www.guaikei.com) 开通 TOKEN
  194. 问题反馈 [GitHub Issues](https://github.com/um-why/xiaohongshu-openclaw-skill/issues)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.