Back to search
xiaohongshu-tool
SkillWorks with Claude CodeGitHub
"小红书公开数据只读技能:关键词搜笔记、爆款选题、笔记详情、评论舆情、博主作品、粉丝获赞与收藏,输出 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.
Checked today
Badge for your README
Markdown
[](/listings/um-why--xiaohongshu-openclaw-skill)HTML
<a href="/listings/um-why--xiaohongshu-openclaw-skill"><img src="/api/listings/um-why--xiaohongshu-openclaw-skill/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 · 232 lines
- ---
- name: xiaohongshu-tool
- description: "小红书公开数据只读技能:关键词搜笔记、爆款选题、笔记详情、评论舆情、博主作品、粉丝获赞与收藏,输出 JSON,不登录不发布。触发词:小红书、小红薯、xhs、rednote、笔记链接、博主主页、竞品监控、KOL筛选、评论分析。用户要查小红书笔记、评论、选题、竞品或舆情时使用;抖音、快手、B站、微博、公众号不要用本技能。"
- license: MIT
- version: 1.2.3
- category: 数据分析
- homepage: https://www.guaikei.com
- 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:
- - "小红书"
- - "小红薯"
- - "xhs"
- - "rednote"
- - "小红书搜索"
- - "小红书笔记"
- - "小红书评论"
- - "小红书博主"
- - "爆款选题"
- - "竞品分析"
- - "KOL筛选"
- - "评论舆情"
- - "xiaohongshu"
- category:
- - "Integrations"
- - "Research"
- - "Creative"
- - "内容创作"
- - "数据分析"
- - "商业运营"
- tags:
- - "小红书"
- - "小红书搜索"
- - "小红书笔记"
- - "小红书评论"
- - "小红书博主"
- - "小红书运营"
- - "小红书数据分析"
- - "爆款选题"
- - "竞品分析"
- - "KOL筛选"
- - "评论舆情分析"
- - "内容选题调研"
- - "趋势洞察"
- - "种草营销"
- - "新媒体运营"
- - "关键词搜索"
- - "评论分析"
- - "选题调研"
- - "爆款挖掘"
- - "小红书内容创作"
- - "小红书营销"
- 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/detail_cli_req.schema.json"
- - name: "详情出参"
- file: "assets/detail_cli_resp.schema.json"
- - name: "评论入参"
- file: "assets/comment_cli_req.schema.json"
- - name: "评论出参"
- file: "assets/comment_cli_resp.schema.json"
- - name: "作品入参"
- file: "assets/post_cli_req.schema.json"
- - name: "作品出参"
- file: "assets/post_cli_resp.schema.json"
- examples:
- - "帮我找最近一周小红书『露营装备』的高赞图文笔记 → node src/xiaohongshu/search-cli.js --keyword '露营装备' --type 2 --sort 2 --time 2 --limit 20"
- - "这条小红书笔记评论区在吐槽什么 → node src/xiaohongshu/comment-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy' --limit 20"
- - "看这个小红书博主最近 30 条作品发什么 → node src/xiaohongshu/post-cli.js --url 'https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy' --limit 30"
- - "分析这篇小红书爆款笔记为什么火 → node src/xiaohongshu/detail-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy'"
- - "监控『多巴胺穿搭』最新动态 → node src/xiaohongshu/search-cli.js --keyword '多巴胺穿搭' --sort 1 --time 1 --limit 40"
- - "这个小红书博主多少粉丝 → node src/xiaohongshu/post-cli.js --url 'https://www.xiaohongshu.com/user/profile/xxx' --limit 0"
- - "只要这篇笔记近 30 天的评论 → node src/xiaohongshu/comment-cli.js --url 'https://www.xiaohongshu.com/explore/xxx' --expired_at 30 --limit 20"
- ---
- # 📕 小红书洞察与竞品分析助手
- 小红书公开数据只读:关键词搜笔记、笔记详情、评论、博主作品与粉丝数据;输出结构化 JSON。适用于选题、竞品、KOL、舆情。
- ## 1. ⚠️ 执行前置(每次必过)
- 1. **先 `cd` 到本 SKILL.md 所在目录**,再执行 `node src/xiaohongshu/*.js`(或用绝对路径,见 [faq.md](references/faq.md))。
- 2. **确认 `GUAIKEI_API_TOKEN` 已配置**。未配置 → 不执行,走 `AUTH_REQUIRED`(见 §7 / [errors.md](references/errors.md)),禁止先跑「试试看」。
- 3. **一次只跑一条命令,等进程自己结束**。查询最多约 20 次退避,只算等待大约 15 分钟。stderr「处理中」不是失败。**未退出前不要判定失败,不要并发/重复同一命令。**
- 4. **必填参数不齐先追问**(话术见 [ask.md](references/ask.md)),禁止猜测关键词或链接。
- 5. **Windows 拼参:cmd 只用双引号**包含空格/中文/URL 的参数;不要用 bash 单引号。引号仍拆坏 → 改用 `--json-args`([faq.md](references/faq.md))。Windows / 弱模型优先 `--json-args`。
- > 开通[小红书洞察与竞品分析助手](https://www.guaikei.com) TOKEN。配 TOKEN / 落盘 / FAQ → [faq.md](references/faq.md)。
- ## 2. 💎 价值与典型场景(10 秒判断该不该用)
- | 你是谁 | 你要做的事 | 用哪个命令 |
- | --- | --- | --- |
- | 创作者 / 运营 | 找爆款选题、看高赞图文共同点 | `search-cli.js --sort 2` |
- | 品牌 / 投放 | 监控已知博主发文与互动 | `post-cli.js`(要作品须显式 `--limit`) |
- | 内容分析 | 看一篇笔记正文、图片、互动 | `detail-cli.js` |
- | 舆情 / 客服 | 评论区在吐槽还是在夸 | `comment-cli.js` |
- | MCN / 商务 | 看粉丝、获赞、收藏 | `post-cli.js --limit 0` |
- **何时用**:用户提小红书/小红薯/xhs/rednote,并要搜、看、分析公开数据;或给了笔记/主页/短链/id。
- **何时不用**:只写文案不查数;平台是抖音/快手/B 站/微博/公众号;要登录、私密、草稿、创作者/商业化后台。
- **为什么用它**:只读、不登录;零第三方依赖;按量单次最多 1 万条;stdout 纯 JSON、日志走 stderr。
- > **合规**:调用会把关键词/链接发到 `www.guaikei.com`。不上传本地文件。仅公开数据,限个人/团队内部分析。
- ## 3. 🎯 识别卡(选命令,命中即停)
- | 用户要什么 | 命令 | 最少要有 |
- | --- | --- | --- |
- | 搜笔记、爆款、选题 | `node src/xiaohongshu/search-cli.js` | `--keyword` |
- | 一篇笔记的正文 / 为什么火 | `node src/xiaohongshu/detail-cli.js` | 笔记链接或 24 位笔记 id |
- | 一篇笔记的评论 / 舆情 | `node src/xiaohongshu/comment-cli.js` | 笔记链接或 24 位笔记 id |
- | 博主作品、粉丝、获赞 | `node src/xiaohongshu/post-cli.js` | 主页链接或 24/29 位 `user_id` |
- - 正文和评论都要:先 `detail-cli`,再 `comment-cli`。
- - 24 位 id / 短链类型不明:先追问([ask.md](references/ask.md)),禁止两个命令都试。
- - App 分享文案可整段粘贴给 `--url`,命令会自动抽链(保留 `xsec_token`)。
- ## 4. 🛠️ 命令一行例(详参下沉)
- > **详参 / 枚举**:需要确认取值时再读 [options.md](references/options.md) 。**不要每次都读。**
- > 注意:`-t` = 内容类型,`-i` = 发布时间。`--time 2` = 一周内;`--sort 2` = 最多点赞。
- > **Windows**:cmd **只用双引号**;PowerShell 含空格也优先双引号。仍拆坏或弱模型 → `--json-args`。双壳例 → [faq.md](references/faq.md)。
- ```bash
- node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
- node src/xiaohongshu/search-cli.js --keyword "多巴胺穿搭" --sort 1 --time 1 --limit 40
- node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
- node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --limit 20
- node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --expired_at 30 --limit 20
- node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 30
- node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 0
- ```
- **Windows 双壳(同一条搜索,先 cd 到技能目录)**:
- ```bat
- REM cmd —— 参数必须用双引号,不要用单引号
- node src\xiaohongshu\search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
- ```
- ```powershell
- # PowerShell —— 含空格/中文同样用双引号
- node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
- ```
- **数量 / 套餐**:搜索默认 **20**;评论默认 **10**;博主不传 `--limit` 默认 **0**(只有博主信息)。不要擅自抓 10000。技能硬上限 10000(按量)。**包月**超限 → `PLAN_LIMIT`:搜索 ≤40,作品 ≤30,评论 ≤20;详情无此条数限制。
- 口语 → flag 对照 → [routing.md](references/routing.md)。
- ## 5. 🔀 意图路由(按序命中即停)
- ```
- 1. 评论/留言/舆情 + 对象是一篇笔记 → comment-cli
- 2. 作品/主页/账号/博主/粉丝/获赞 → post-cli
- 3. 一篇笔记的标题/正文/图片/互动 → detail-cli
- 4. 有关键词且无以上信号 → search-cli
- 5. 都不明确 → 先追问(ask.md)
- ```
- 消歧:`/user/profile/` → 只能 post;`/explore/` 或 `/discovery/item/` + 评论 → comment,+ 正文 → detail,都没说 → 追问。选题可先 `search --sort 2 --time 2 --limit 30`,再对挑出的笔记跑详情。竞品看作品必须显式 `--limit`。
- ## 6. 📜 输出(摘要)
- - stdout = 统一 JSON 信封;stderr = 日志。向用户**只摘关键字段**,勿整份粘贴。取数成功/empty 时信封顶层可能有 `cost`(花费估算,见 [contract.md](references/contract.md))。
- - `status=empty` + `NO_MATCH` 退出码 0,**不是失败**。
- - `results`:搜/评论 = 数组;详情 = 单对象;作品 = `{note,user}`。
- - 互动数是字符串;比较前先转数字。
- 完整信封与形态 → [contract.md](references/contract.md)。Schema 在 `assets/`。
- ## 7. 🚨 错误应对(摘要)
- | error_code | 退出码 | Agent |
- | --- | --- | --- |
- | `AUTH_*` | 3 | **禁止重试**;引导官网配 TOKEN |
- | `PLAN_LIMIT` | 1 | **禁止同参重试**;降 limit 须用户同意(搜≤40 / 作品≤30 / 评论≤20) |
- | `INSUFFICIENT_BALANCE` / `DAILY_LIMIT` | 1 | **禁止同参重试**;充值或明日/调限额 |
- | `RATE_LIMITED` | 1 | **禁止立即重试** |
- | `INVALID_*` | 1/2 | 换词/换链/按 help 改一次;禁止擅自改默认再跑 |
- | `NO_MATCH` | 0 | 如实无结果 |
- | `TIMEOUT` / `NETWORK_ERROR` | 1 | 同参续等最多 1 次(搜/作品/评论约 20 分钟、详情约 19 分钟复用);禁止改参「重做」 |
- 全表 → [errors.md](references/errors.md)。
- ## 8. 🛑 硬性禁止
- - 不得编造数据;不得把空结果说成有结果。
- - 不得未征得同意就自动改搜索条件重试;不得编造关键词或链接。
- - `AUTH_*` / `PLAN_LIMIT` / `INSUFFICIENT_BALANCE` / `RATE_LIMITED` / `DAILY_LIMIT` 后不得同参或立即重试。
- - 不得把 stderr 原文转述给用户;不得整份 JSON 贴回对话。
- - 不得做登录态/私密获取或任何写操作。
- - 不得在未 cd 到技能目录时执行 `node src/xiaohongshu/*.js`。
- - 24 位 id / 短链类型不明时,不得两个命令都试。
- ## 9. 📚 何时读 references(入口总表)
- | 时机 | 打开 |
- | --- | --- |
- | 确认枚举/参数取值 | [options.md](references/options.md) |
- | 口语指令 → flag / 链接消歧 | [routing.md](references/routing.md) |
- | 信封 / `results` 形态 | [contract.md](references/contract.md) |
- | 完整错误表 | [errors.md](references/errors.md) |
- | 缺参追问话术 | [ask.md](references/ask.md) |
- | 环境 / FAQ | [faq.md](references/faq.md) |
- | 逐步排障问答 | [troubleshooting.md](references/troubleshooting.md) |
- | 版本变更 | [changelog.md](references/changelog.md) |
- | 技术人员总览 | [readme.md](readme.md) |
- | 机器可校验 Schema | `assets/*.schema.json` |
readme.md · README · 277 lines
- # 📕 小红书洞察与竞品分析助手|关键词搜索 · 笔记详情 · 评论舆情 · 博主作品(无需登录 / 不封号)
- > **💡 一句话价值**:给一个关键词或一条链接,拿回小红书公开笔记、评论和博主数据——直接输出结构化 JSON。做爆款选题、盯竞品、筛 KOL、读评论区,不用再手工刷一小时再记点赞。
- **只读公开数据 · 不登录你的小红书账号 · 按量最多 1 万条;包月搜索 / 作品 / 评论分别最多 40 / 30 / 20 · 装进 Agent 就能用口语化指令获取数据**
- **维护状态**:持续更新中,当前版本 `1.2.3`,[更新日志](references/changelog.md)。Agent 执行卡见 [SKILL.md](SKILL.md)。
- 👉 开通 [小红书数据 TOKEN](https://www.guaikei.com)
- > **🔥 核心优势(适合放进 Agent)**
- >
- > - 🔒 **安全只读**:不登录小红书账号;无发布、点赞、评论、关注;无封号风险
- > - 💪 **双上限清晰**:按量 Token 单次最多 10000 条;包月搜索 ≤40、作品 ≤30、评论 ≤20
- > - 🎛️ **参数说了算**:类型、排序、时间、数量越界就失败,不会偷偷改成默认值
- > - 🤖 **一份 JSON**:成功 / 无结果 / 失败同一信封,AI 可直接解析;零第三方依赖
- > - 🇨🇳 **国内直连**:Windows / macOS / Linux 均可,不用代理
- ---
- ## ✅ 我能帮你解决什么(10 秒判断)
- | 你是谁 | 你要做的事 | 用这个技能 |
- | --- | --- | --- |
- | 🎯 创作者 / 运营 | 下周选题:翻几十条笔记自己记点赞 | 一条搜索拿回标题、摘要和互动数 |
- | 📊 品牌 / 投放 | 竞品这周发了什么:每天打开主页往下刷 | 博主作品列表,带发布时间与互动 |
- | 🤝 MCN / 商务 | 这个 KOL 值不值得合作:看粉丝拍脑袋 | 粉丝、获赞、收藏一起回来再算比值 |
- | 💬 舆情 / 客服 | 评论区在说什么:一条条往下翻 | 一次拉评论,交给 AI 归纳观点 |
- | 📰 内容分析 | 这篇为什么火:只有标题猜 | 笔记详情:正文、图片、互动、作者 |
- | 🔥 所有人 | 今天刚起来的话题:反复刷发现页 | 「最新 + 一天内」直接筛出来 |
- **典型产出**:结构化 JSON(标题、作者、点赞 / 收藏 / 评论 / 分享、链接、时间),可导入 Excel / BI,或交给 AI 继续做:**标题公式、爆款归因、评论聚类、发文节奏、能发出去的报告**。
- ---
- ## 🎁 四件事,各用一条命令
- | 你要做的事 | 命令 | 你拿到什么 |
- | --- | --- | --- |
- | 🔍 找选题、看高赞 | `search-cli.js` | 笔记数组。点赞、收藏、评论、分享 |
- | 📰 看一篇笔记正文 | `detail-cli.js` | 一个笔记对象。不含评论 |
- | 💬 看评论区 | `comment-cli.js` | 评论数组(可按近 N 天过滤) |
- | 📸 看博主作品 | `post-cli.js --limit > 0` | `results.note` + 可能有的 `results.user` |
- | 👥 看粉丝、获赞、收藏 | `post-cli.js --limit 0` | `results.user`:`fans` / `liked` / `collected` / `interaction` |
- 不登录、不发布、不点赞、不评论、不关注。私密笔记、草稿、创作者后台和投放后台都不在范围内。
- ---
- ## 🚀 3 步开始
- **1. 开通 TOKEN**
- 到[小红书竞品分析助手官网](https://www.guaikei.com)开通。TOKEN 是 16–256 位的字符串。
- **2. 配到环境变量**
- ```bash
- # Windows (PowerShell)
- $env:GUAIKEI_API_TOKEN = "你的TOKEN"
- # macOS / Linux
- export GUAIKEI_API_TOKEN="你的TOKEN"
- ```
- **3. 进技能目录,跑第一条——或直接对 AI 说要求**
- ```bash
- cd <本技能所在目录> # 即 readme.md / SKILL.md 所在的那一层
- node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
- ```
- 装进 WorkBuddy、Openclaw、Hermes、豆包办公、千问办公、Claude Code 或 Codex 之后,可以这样说:
- - 「帮我找最近一周小红书露营装备的高赞图文,先看 20 条」
- - 「这篇笔记评论区近 30 天在吐槽什么」
- - 「这个博主多少粉丝,最近发了哪 30 条」
- - 「分析这篇小红书爆款笔记为什么火」
- > ⚠️ 需要 Node.js 16.14.0+,没有别的依赖。一次只跑一条命令,等进程自己退出。stderr「处理中」不是失败。
- ---
- ## ⚡ 最快上手(复制就能跑)
- ```bash
- # 🔎 最近一周「露营装备」高赞图文
- node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20
- # 🔥 一天内「多巴胺穿搭」最新(包月勿超 40)
- node src/xiaohongshu/search-cli.js --keyword "多巴胺穿搭" --sort 1 --time 1 --limit 40
- # 📰 看一篇笔记正文与互动
- node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
- # 💬 近 30 天评论(包月勿超 20)
- node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx" --expired_at 30 --limit 20
- # 📸 博主近 30 条作品
- node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 30
- # 👥 只要粉丝、获赞、收藏
- node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx" --limit 0
- ```
- > 💡 搜索默认 20 条;评论默认 10 条;博主不写 `--limit` 时只有资料、没有作品列表。
- > 💡 `--time 2` = 一周内(不是 2 天);`--sort 2` = 最多点赞(不是最新)。`-t` 是类型,`-i` 才是时间。
- ---
- ## 🔧 命令与参数详表
- > 枚举越界会直接失败(退出码 2),不会改成默认值再请求。更细的链接规则与口语映射见 [references/options.md](references/options.md)、[references/routing.md](references/routing.md)。机器 Schema 见 `assets/`。
- **套餐双上限**:技能硬上限 10000(按量)。**包月**超限返回 `PLAN_LIMIT`:搜索 ≤40,作品 ≤30,评论 ≤20;详情无此条数限制。
- ### 🔍 关键词搜索 `search-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--keyword` | `-k` | ✅ | 1–50 个字符,不能是链接,不含 `< > " '` | — |
- | `--type` | `-t` | | `0` 全部 / `1` 视频 / `2` 图文 | `0` |
- | `--sort` | `-s` | | `0` 综合 / `1` 最新 / `2` 最多点赞 / `3` 最多评论 / `4` 最多收藏 | `0` |
- | `--time` | `-i` | | `0` 全部 / `1` 一天内 / `2` 一周内 / `3` 半年内 | `0` |
- | `--limit` | `-l` | | 1–10000(**包月 Token 实际最多 40**) | `20` |
- 这些数字不是天数:`--time 2` = 一周内;`--sort 2` = 最多点赞。关键词以 `-` 开头时写成 `--keyword=-AI`,或 `node src/xiaohongshu/search-cli.js -- -AI`。
- ### 📰 笔记详情 `detail-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | 笔记链接或 24 位笔记 id(最长按接口 255) | — |
- 支持 `explore/{id}`、`discovery/item/{id}`、`xhslink.com|cn` 的 `/m/*` `/o/*`、以及裸 24 位 id。主页链接不要传给本命令。成功时 `results` 是**一条笔记对象**,不含评论。可整段粘贴 App 分享文案,自动抽链并保留 `xsec_token`。
- ### 👥 博主作品 `post-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | 主页链接,或 24 / 29 位 `user_id`(最长按接口 255) | — |
- | `--limit` | `-l` | | 0–10000(**包月最多 30**;**`0` = 只要博主互动数据**) | `0` |
- 支持 `user/profile/{user_id}`、四类短链、24/29 位 id。不传 `--limit` 不会返回作品列表;要看最近发了什么必须写出条数。成功时 `results` 为 `{ note, user }`。可整段粘贴 App 分享文案,自动抽链。
- ### 💬 笔记评论 `comment-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | 笔记链接或 24 位笔记 id(含 `explore`、`discovery/item`、短链) | — |
- | `--expired_at` | `-e` | | `1-2190` 天(约 6 年),或 `YYYY-MM-DD HH:mm:ss`(不早于 2000、不能未来;`--expire` 同义)。勿传 Unix 时间戳 | 不传则按北京时间近 6 年换算 |
- | `--limit` | `-l` | | 1–10000(**包月最多 20**) | `10` |
- `expired_at` 是时间过滤,不是分页。`limit=10000` 且 `expired_at=1` 也只返回近 1 天的评论。同样支持整段粘贴 App 分享文案自动抽链。
- ### 🗂️ Schema 入口
- - 输出信封 [output_envelope.schema.json](assets/output_envelope.schema.json)
- - 关键词搜索 [入参](assets/search_cli_req.schema.json) / [出参](assets/search_cli_resp.schema.json)
- - 笔记详情 [入参](assets/detail_cli_req.schema.json) / [出参](assets/detail_cli_resp.schema.json)
- - 博主作品 [入参](assets/post_cli_req.schema.json) / [出参](assets/post_cli_resp.schema.json)
- - 笔记评论 [入参](assets/comment_cli_req.schema.json) / [出参](assets/comment_cli_resp.schema.json)
- ---
- ## 📦 你会得到什么(真实输出结构示例)
- 成功、没有结果、失败,都是同一份 JSON。程序和 AI 都能直接读。
- ```json
- {
- "status": "success",
- "error_code": "OK",
- "message": "搜索任务完成",
- "timestamp": "2026/10/22 15:16:11",
- "request": {
- "command": "search",
- "keyword": "露营装备",
- "type": 2,
- "sort": 2,
- "time": 2,
- "limit": 20
- },
- "metadata": {
- "skill_version": "1.2.3",
- "runtime_version": "22.x",
- "execution_time": 34210
- },
- "results": [
- {
- "id": "6a377d460000000000000000",
- "xsec_token": "yyy",
- "title": "深圳奇妙日花费大概多少",
- "desc": "奇妙日如果不买很多周边去互动……",
- "liked_count": "336",
- "collected_count": "128",
- "comment_count": "193",
- "shared_count": "45",
- "user": { "nickname": "xxx", "user_id": "66a8abcd0000000000000000" },
- "publish_time": "2026-09-08 20:06:00",
- "type": "normal"
- }
- ]
- }
- ```
- 打开某一条笔记时,用 `https://www.xiaohongshu.com/explore/{id}`。有 `xsec_token` 再接上 `?xsec_token=`。
- 互动数是字符串,空字符串和数字 0 有时不会出现。比较之前先转成数字。
- ---
- ## 👥 谁会用它
- 小红书创作者和运营、品牌市场、MCN 和博主经纪人、需要把公开内容喂给 Agent 的人。
- 它给的是公开数据,不替你做投放决策。判断还是你来。
- ---
- ## ❓ 购买前你可能想问
- **🔐 要登录我的小红书账号吗?**
- 不用。这个技能不碰你的账号,也不做发布、点赞、评论、关注。
- **📡 数据从哪来?**
- 经[小红书公开数据接口](https://www.guaikei.com)返回,只覆盖小红书公开可见的内容。除了关键词和链接这类查询参数,不上传你电脑上的其他数据。结果请在个人或团队内部分析时使用。
- **🔑 一定要 TOKEN 吗?**
- 要。接口按 TOKEN 调用。开通入口在[小红书洞察与竞品分析助手官网](https://www.guaikei.com)。
- **⏱️ 查一条要等多久?**
- 小批量通常一轮查询就能回来。条数大、或者任务还在处理时,命令会继续等,屏幕上的「处理中」不是失败。等命令结束再看结果。
- **🧭 AI 会不会查错平台?**
- 技能说明里写明了:只处理小红书。抖音、快手、B 站、微博、公众号不会走这里。
- **🌐 我在国内,要代理吗?**
- 不用。
- **📏 单次能拉多少条?**
- 技能侧硬上限 10000 条/次(按量 Token)。**包月 Token** 搜索最多 40、作品最多 30、评论最多 20,超限返回 `PLAN_LIMIT`(退出码 1),不要当网络错误重试。具体计费口径以官网说明为准。
- **⚠️ 报错 `PLAN_LIMIT` / 提示包月受限?**
- 降低 `--limit` 后须用户同意再跑,或到[官网](https://www.guaikei.com)升级按量;**禁止同参重试**。
- ---
- ## 🚧 边界
- - 公开笔记、评论、博主信息。私密、草稿、仅粉丝可见、创作者后台、商业化后台都不支持
- - 不做写操作
- - 按量最多 1 万条;包月更低(搜索 40 / 作品 30 / 评论 20)。用户没说要多少时,搜索默认 20,评论默认 10,博主默认只看资料
- 默认不落盘。需要留底时加 `--save` 或设 `GUAIKEI_ENABLE_LOG=1`,写入系统临时目录 `xiaohongshu-guaikei/logs/当天日期/`(不写进技能目录)。旧 `XHS_GUAIKEI_DISABLE_LOG` 已废弃。
- ---
- ## 📚 文档入口
- | 你想看什么 | 打开 |
- | --- | --- |
- | Agent 执行卡 | [SKILL.md](SKILL.md) |
- | 命令参数详表 | 本文「🔧 命令与参数详表」;更细见 [references/options.md](references/options.md) |
- | 口语 → 参数 | [references/routing.md](references/routing.md) |
- | 错误应对 | [references/errors.md](references/errors.md) |
- | 环境 / FAQ | [references/faq.md](references/faq.md) |
- | 逐步排障 | [references/troubleshooting.md](references/troubleshooting.md) |
- | 版本变更 | [references/changelog.md](references/changelog.md) |
- ---
- ## 🎉 现在就可以开通
- 去[小红书洞察分析助手官网](https://www.guaikei.com) 开通 TOKEN
- 问题反馈 [GitHub Issues](https://github.com/um-why/xiaohongshu-openclaw-skill/issues)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.