小红书记录整理器

安装指南

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

什么是

此技能专为 Openclaw Skills 工作流设计，可帮助内容团队、营销人员、研究人员和分析师识别表现出色的话题、比较竞争对手、监测创作者、评估 KOL 信号并总结受众情绪，而无需登录小红书账号。结果以结构化 JSON 返回，可用于话题研究、竞争分析、报告和趋势监测。

应用场景

研究热门话题并识别潜在的爆款内容切入角度。
监测创作者的公开帖子、发布频率和互动表现。
在创作者接口支持的情况下，收集粉丝数、点赞数和收藏数等公开创作者指标。
检索笔记详情，包括标题、正文内容、图片、作者信息和互动数据。
分析公开评论区中的受众观点、反复出现的主题和情绪信号。
使用一致的互动数据比较竞争对手、创作者和内容形式。
通过最新优先搜索以及一天或一周的时间筛选，追踪近期活动。
将结构化的小红书结果输入下游 AI 摘要、报告、仪表板和 Openclaw Skills 自动化流程。

工作原理

将用户的目标识别为关键词、小红书笔记 URL 或创作者主页 URL。
确认用户的目标；如果缺少关键词、链接、链接类型、时间范围或结果数量，则提出后续问题。
将关键词请求路由至 search-cli.js，笔记 URL 路由至 detail-cli.js 或 comment-cli.js，创作者主页 URL 路由至 post-cli.js。
使用配置的 GUAIKEI_API_TOKEN 调用 GUAIKEI 小红书数据 API。
返回包含所需公开记录和相关元数据的结构化 JSON。
如需深入研究，可组合工作流：搜索表现出色的笔记，检查选定笔记的详情，然后检索评论以分析受众。
在支持的情况下，将执行结果保存在本地日志中，方便团队日后进行比较、生成报告和开展后续分析。
如实报告身份验证、速率限制、无效链接、超时、结果为空和服务错误，不得捏造缺失数据。

配置指南

Node.js 16.14.0 或更高版本。
通过 GUAIKEI 获取的有效 GUAIKEI_API_TOKEN。
受支持的智能体环境，例如 Openclaw、WorkBuddy、TraeWork、Qoder、Hermes、ima、Claude Code 或 Cursor。
公开的小红书关键词、笔记 URL 或创作者主页 URL。
安装与配置
将技能仓库克隆或放置到智能体工作区，然后配置所需令牌：
export GUAIKEI_API_TOKEN="your_api_token"
node --version
运行关键词搜索：
node src/xiaohongshu/search-cli.js --keyword "camping equipment" --type 2 --sort 2 --time 2 --limit 20
检索笔记详情或评论：
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?xsec_token=yyy" --limit 200
监测创作者的公开帖子或主页指标：
node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" --limit 30
node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" --limit 0
此技能不会登录小红书，也不支持发布、点赞、评论、关注、私信、私密笔记、草稿、创作者后台数据或其他非公开信息。

数据架构

核心记录类型
记录类型 主要输入 典型输出
关键词搜索 --keyword 匹配的笔记、作者、URL、内容类型和互动指标
笔记详情 --url 标题、正文、图片、作者信息、发布数据、点赞、评论、分享和收藏
笔记评论 --url 评论文本、评论者、互动数据和可选的时间筛选
创作者指标 主页 --url 配合 --limit 0 可获取的粉丝、点赞、收藏和其他创作者互动总数
搜索参数 --keyword 或 -k：必填，长度为 2–50 个字符的文本关键词；不得为 URL。 --type 或 -t：0 表示所有内容，1 表示视频，2 表示图文笔记；默认值为 0。 --sort 或 -s：0 综合排序，1 最新，2 点赞最多，3 评论最多，4 收藏最多；默认值为 0。 --time 或 -i：0 不限时间，1 一天内，2 一周内，3 六个月内；默认值为 0。 --limit 或 -l：搜索和评论检索数量，整数范围为 1 至 10,000；默认值为 10。 评论与监测元数据 --expire：评论时间筛选范围为 1 至 4,745 天；省略时默认值为 2,190 天。 创作者 --limit 0：请求创作者互动指标，而非帖子列表。
URL 应指向公开的小红书笔记（例如 /explore/... 或 xhslink.com 笔记链接），或公开的创作者主页（例如 /user/profile/...）。
结果以结构化 JSON 返回，适用于下游比较、摘要、报告和其他 Openclaw Skills 工作流。
操作结果应区分成功记录、结果为空、无效链接、身份验证失败、速率限制、服务错误和超时。

高级特性

四种专用工作流：关键词搜索、笔记详情检索、创作者帖子监测和评论分析。
在 API 和接口支持的情况下，可通过最高 10,000 条的数量限制检索大量记录。
可组合的研究流程，将内容发现、详情检查、评论挖掘和创作者监测结合起来。
使用评论数与点赞数、收藏数与点赞数等比较比率评估 KOL，并标记异常互动模式以供审查。
通过仅查看最近一天或一周、按最新优先排序的搜索监测趋势。 --expire 筛选评论时间范围，专注分析当前时段的情绪和舆情。
面向 Openclaw Skills、Claude Code、Cursor、WorkBuddy 和其他受支持环境的智能体友好型结构化 JSON 输出。
本地执行记录和日志，便于重复生成报告、进行每周回顾和历史比较。
无需登录小红书账号，减少处理账号凭据的需要，并将采集范围限制为公开数据。
明确的输入验证和路由规则，避免混淆笔记 URL 与创作者主页 URL，或使用错误的 CLI 接口。
如实处理 HTTP 401、403、429、500 系列故障、无效链接、结果为空和网络超时。

name: xiaohongshu-record-organizer description: 实时获取小红书平台的记录及数据整理为结构化的成果：作品描述、发布时间、点赞数、评论数、分享数、收藏数、评论内容等互动数据，可根据数据获取时间进行横向对比分析，帮助用户记录小红书社媒平台作品的表现，便于后续分析和决策。支持四大能力：(1) 关键词搜索笔记/视频，可按点赞数、评论数、收藏数、发布时间、内容类型筛选排序；(2) 博主作品抓取，按主页链接获取博主的互动数据（粉丝量、点赞量或收藏量等）或公开作品列表；(3) 笔记（视频）详情，获取详情数据及互动数据等，分析笔记的市场表现；(4) 笔记评论分析，按笔记链接获取评论内容与互动数据。 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