安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install xiaohongshu-insights
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 xiaohongshu-insights。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

小红书洞察是一款 AI 智能体技能，用于研究小红书（XHS/Rednote）公开内容。它提供四种工作流程：搜索关键词笔记和视频、获取创作者主页和帖子、查看单篇笔记详情，以及分析笔记评论。结果可用于发现主题、监测竞品、筛选 KOL、研究趋势和分析受众情绪。
该技能专为 Openclaw Skills 和其他受支持的编码智能体设计，无需登录小红书账号即可返回结构化数据。此技能使用 Guaikei 数据 API，需要 API 令牌，且仅限公开信息；它不会发布、点赞、评论、关注，也不会访问私人数据或创作者后台数据。

应用场景

搜索某个关键词的近期或高互动公开帖子，并按内容类型、时间范围、点赞数、评论数或收藏数筛选。
查看表现最佳的笔记并检查其标题、内容和互动情况，以研究选题灵感。
监测创作者的公开帖子和互动情况，了解发布频率并发现值得关注的内容。
根据可用的粉丝数和帖子互动指标筛选创作者或 KOL。
分析某篇笔记的公开评论，找出反复出现的观点、受众问题和情绪主题。
收集小红书公开数据，用于竞品研究、趋势追踪、内部报告或内容规划。

工作原理

明确研究目标并确认所需输入：关键词、笔记链接或创作者主页链接。如果目标或范围不明确，请先询问确认。
将请求分配给对应的 CLI：关键词使用 search-cli.js，笔记详情使用 detail-cli.js，评论使用 comment-cli.js，创作者主页和帖子使用 post-cli.js。
使用已配置的 GUAIKEI_API_TOKEN 调用 Guaikei API，并返回生成的结构化数据。
针对指定的研究任务总结或比较检索到的公开数据。如需综合分析，可串联多个工作流程，例如先搜索表现良好的笔记，再查看选定笔记的详情，最后获取评论。
如实报告错误和空结果。不要根据缺失数据推断操作成功，也不要编造关键词、链接或发现。

配置指南

要求：Node.js 16.14.0 或更高版本，以及有效的 Guaikei API 令牌。技能元数据将 Node.js 列为必需的可执行程序，并将 GUAIKEI_API_TOKEN 列为必需的环境变量。通过 guaikei.com 获取令牌，然后使用你的智能体所支持的方法安装此技能。

为当前 shell 会话设置令牌

export GUAIKEI_API_TOKEN="your_token_here"

示例：搜索近期热门的图文笔记

node src/xiaohongshu/search-cli.js --keyword "camping gear" --type 2 --sort 2 --time 2 --limit 20

示例：获取笔记的公开详情

node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/NOTE_ID"

示例：获取公开评论

node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/NOTE_ID" --limit 200

示例：获取创作者近期公开帖子

node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/PROFILE_ID" --limit 30
请按照适用于你所用智能体的仓库安装说明操作。此技能列出的兼容平台包括 Openclaw、Claude Code、Cursor、WorkBuddy、TraeWork、Qoder、Hermes 和 ima。请勿将 API 令牌提交到源代码管理中。

数据架构

此技能通过四个 CLI 入口获取数据，并输出结构化 JSON 结果。具体响应字段取决于 API 响应；文档说明的结果类型包括：

工作原理

关键词搜索 src/xiaohongshu/search-cli.js --keyword 及可选筛选条件 公开笔记列表、作者信息、互动指标和可点击链接
笔记详情 src/xiaohongshu/detail-cli.js --url 笔记详情、作者信息和可用的互动数据
评论分析 src/xiaohongshu/comment-cli.js --url；可选 --limit 和 --expire 公开评论内容、评论者信息和互动数据
创作者帖子 src/xiaohongshu/post-cli.js 主页 --url；可选 --limit 公开帖子列表；使用 --limit 0 时，返回粉丝数、点赞数和收藏数等创作者指标
搜索选项包括 --type（0 全部、1 视频、2 图文）、--sort（0 相关度/默认、1 最新、2 点赞最多、3 评论最多、4 收藏最多）、--time（0 不限、1 一天内、2 一周内、3 六个月内）以及 --limit（1–10,000；默认值为 10）。评论检索支持设置过期时间窗口和 1–10,000 的限制。此技能文档说明会在本地记录执行日志，但未指定固定的日志结构或有保证的输出文件命名约定。API 数据流说明为本地机器 → Guaikei API → 结果；发送的是查询参数，不会发送无关的本地文件。

高级特性

结合搜索、详情、创作者帖子和评论工作流程开展多步骤研究，例如找出热门笔记，再调查其内容和受众反馈。
post-cli.js --limit 0
获取创作者互动指标，而不请求帖子列表。
通过结果数量限制和可选的过期时间窗口聚焦评论分析；文档说明的默认时间窗口为 2,190 天。
将此技能用于受支持的编码智能体平台，包括 Openclaw、Claude Code 和 Cursor。
将分析限制在文档说明的范围内：仅限公开数据，不登录账号或执行平台写入操作，也不访问私人笔记、创作者后台数据或个人身份信息。

name: xiaohongshu-insights description: 小红书竞品洞察分析工具，实时监测竞品流量效果、快速拆解对标竞对作品、精准拆解透视竞品流量及策略、高效搭建关键词库，适用于小红书品牌方、创作者等进行竞品分析、流量优化和关键词研究。支持四大能力：(1) 关键词搜索笔记/视频，可按点赞数、评论数、收藏数、发布时间、内容类型筛选排序；(2) 博主作品抓取，按主页链接获取博主的互动数据（粉丝量、点赞量或收藏量等）或公开作品列表；(3) 笔记（视频）详情，获取详情数据及互动数据等，分析笔记的市场表现；(4) 笔记评论分析，按笔记链接获取评论内容与互动数据。用户提到小红书/xhs/rednote 且需要查数据、市场调研、舆情监测、做选题、竞品监控、KOL筛选、舆情分析时调用；无需登录账号 license: MIT
version: 1.1.4
platforms: [WorkBuddy, Openclaw, TraeWork, Qoder, Hermes, ima, Claude Code, Cursor]
homepage: https://github.com/um-why/xiaohongshu-openclaw-skill