xiaohongshu-performance-reviewSAFE

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

# Windows (PowerShell)
$env:GUAIKEI_API_TOKEN = "你的TOKEN"

# macOS / Linux
export GUAIKEI_API_TOKEN="你的TOKEN"

# 搜「露营装备」最近一周高赞图文,取 20 条
node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --so

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: xiaohongshu-performance-review
description: 获取实时小红书社媒数据表现,包括笔记、评论、互动数据等,根据数据进行分析和评估,输出复盘内容表现,统一指标口径,提出可检验的下一步内容策略。支持四大能力:(1) 关键词搜索笔记/视频,可按点赞数、评论数、收藏数、发布时间、内容类型筛选排序;(2) 博主作品抓取,按主页链接获取博主的互动数据(粉丝量、点赞量或收藏量等)或公开作品列表;(3) 笔记(视频)详情,获取详情数据及互动数据等,分析笔记的市场表现;(4) 笔记评论分析,按笔记链接获取评论内容与互动数据。
license: MIT
version: 1.1.4
display_name: GUAIKEI小红书社媒数据复盘
display_name_en: GUAIKEI XiaoHongShu Performance Review
description_zh: 获取实时小红书社媒数据表现,包括笔记、评论、互动数据等,根据数据进行分析和评估,输出复盘内容表现,统一指标口径,提出可检验的下一步内容策略。
description_en: Obtain real-time XiaoHongShu social media performance data, including posts, comments, engagement metrics and more. Conduct analysis and evaluation based on the data, generate content performance reviews, unify metric standards, and propose verifiable next-step content strategies.
platforms: [WorkBuddy, Openclaw, TraeWork, Qoder, Hermes, ima, Claude Code, Cursor]
homepage: https://github.com/um-why/xiaohongshu-openclaw-skill
metadata:
  type: command
  runtime: "[email protected]+"
  requires:
    bins: ["node"]
    env: ["GUAIKEI_API_TOKEN"]
  env_desc:
    GUAIKEI_API_TOKEN: "小红书数据 API 访问令牌。未配置时无法调用接口;可通过 www.guaikei.com 开通。"
  category:
    - "Integrations"
    - "Research"
    - "Creative"
    - "内容创作"
    - "数据分析"
    - "商业运营"
  tags:
    - "小红书"
    - "小红书搜索"
    - "小红书笔记"
    - "小红书评论"
    - "小红书博主"
    - "小红书运营"
    - "小红书数据分析"
    - "市场调研"
    - "爆款选题"
    - "竞品分析"
    - "舆情监控"
    - "舆情监测"
    - "KOL筛选"
    - "评论舆情分析"
    - "内容选题调研"
    - "趋势洞察"
    - "种草营销"
    - "新媒体运营"
    - "关键词搜索"
    - "评论分析"
    - "选题调研"
    - "爆款挖掘"
    - "行业舆情"
    - "舆情数据获取"
    - "小红书内容创作"
    - "小红书营销"
  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 200"
    - "看这个小红书博主最近 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 50"
---

# 🎯 GUAIKEI小红书社媒数据复盘

> ✨ **一句话**:给关键词或链接,拿回结构化的小红书公开数据——笔记、评论、博主作品,直接喂给后续的选题分析、竞品对比、舆情归纳。

> ✨ **解决什么问题**:获取实时小红书社媒数据表现,包括笔记、评论、互动数据等,根据数据进行分析和评估,输出复盘内容表现,统一指标口径,提出可检验的下一步内容策略。

| 你要做的事     | 这个技能给你什么                         | 省掉的动作             |
| -------------- | ---------------------------------------- | ---------------------- |
| 找选题方向     | 按点赞/收藏排序的笔记列表 + 完整互动数据 | 手动翻页、逐条记录数据 |
| 盯竞品账号     | 博主公开作品列表 + 发布时间 + 互动表现   | 每天手动刷对方主页     |
| 筛 KOL 真实性  | 点赞/评论/收藏三项原始数值               | 靠感觉判断数据是否注水 |
| 摸用户真实想法 | 单篇笔记的评论区全量数据                 | 手动往下翻评论         |
| 追热点         | 按「最新」+「一天内」筛出的实时内容      | 反复刷发现页           |

**🔥核心优势**

- **🔒 安全**:不登录你的小红书账号,零封号风险——这是爬虫方案给不了的
- **💪 强大**:单次最多拉取 **1 万条**数据,出参字段全面,可见即所得
- **🎛️ 精准**:内容类型 / 排序 / 时间范围 / 数量四维筛选,直出你要的那批数据
- **🔨 轻量**:零依赖、零部署,装好 Node.js 就能跑,Windows / macOS / Linux 通吃
- **🤖 为 AI 而生**:标准 JSON 出参 + 完整 SKILL.md,WorkBuddy / Openclaw / Claude Code / Cursor 等 Agent 开箱即用
- **📁 省心**:每次执行结果自动归档本地日志,写周报、做复盘直接翻记录

---

## 1. ✅ 什么时候应该调用这个技能

### 1.1 🎯 满足以下**任一**条件即调用

- 用户提到「小红书」「小红薯」「xhs」「rednote」并要求查看、搜索、分析内容
- 用户要做 **关键词搜索**、**爆款选题调研**、**竞品监控**、**评论洞察**、**博主作品追踪**、 **KOL/博主筛选**、**评论区舆情分析**、**关键词趋势跟踪**。
- 用户提供了小红书关键词、笔记链接或博主主页链接,希望拿到结构化数据。
- 用户给出 `xiaohongshu.com` 或 `xhslink.com` 开头的链接
- 用户说「帮我看看 XX 在小红书上的情况」这类需要真实数据支撑的判断
- 用户后续还要基于结果继续做总结、对比、筛选、报告生成。

### 1.2 🚫 以下情况**不要调用**

- 用户只让写文案、起标题、改脚本,没要求查数据
- 用户查询的平台是抖音、B站、微博、公众号
- 用户要求获取私密内容、登录态数据、隐藏数据或非公开信息。
- 用户既没有提供关键词,也没有提供可识别的小红书链接,且任务目标不明确。

### 1.3 👀 意图模糊时的追问模板

用户说「帮我做小红书竞品分析」——信息不足,按此追问:

> 需要确认三件事:1)竞品是具体某个账号(给我主页链接),还是某个品类关键词?2)关注最新动态还是历史高赞?3)大概看多少条?

拿到答案再执行。**不要自行编造关键词或链接。**

---

## 2. 🔀 四个能力与路由

> **Note:** 请先通过 [GUAIKEI小红书社媒数据复盘官网](https://www.guaikei.com) 开通TOKEN,配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。

| 用户意图信号                          | 脚本                             | 必填        | 返回                                                 |
| ------------------------------------- | -------------------------------- | ----------- | ---------------------------------------------------- |
| 给的是**关键词**,无链接              | `src/xiaohongshu/search-cli.js`  | `--keyword` | 笔记列表 + 作者 + 互动数据 + 可点击 url              |
| 给的是**笔记链接**,要看正文/互动数据 | `src/xiaohongshu/detail-cli.js`  | `--url`     | 笔记详情 + 作者信息                                  |
| 给的是**笔记链接**,只要评论          | `src/xiaohongshu/comment-cli.js` | `--url`     | 评论内容 + 评论者 + 互动数据                         |
| 给的是**博主主页链接**                | `src/xiaohongshu/post-cli.js`    | `--url`     | 作品列表;`--limit 0` 时返回粉丝量、点赞量、收藏量等 |

### 2.1 🧭 路由细则

- 用户给的是 **关键词**,没有链接:走 **关键词搜索**。
- 用户给的是 `https://www.xiaohongshu.com/explore/...` 或可解析到笔记的短链:若只关心评论,走 **笔记评论查询**;若要笔记详情一起看,走 **笔记详情**。
- 用户给的是 `https://www.xiaohongshu.com/user/profile/...` 或可解析到主页的短链:走 **博主作品监控**。
- 如果用户同时给出多个目标,按用户目标拆分执行,不要把不同意图硬塞进一次命令。

### 2.2 ⚖️ detail 与 comment 的区别

- `detail-cli.js`:要笔记本身(标题、正文、图片、点赞收藏数)。
- `comment-cli.js`:只要评论区,不返回正文。

**同时需要正文和大量评论时**:调 `detail-cli.js` 拿正文,再调 `comment-cli.js --limit 500` 拿评论。

### 2.3 🧩 组合工作流

**选题调研**

```
search-cli --sort 2 --time 2 --limit 30    # 先拿一周高赞
→ 挑出前 5 条的 url
→ detail-cli 逐条看正文结构
→ 汇总标题公式 / 开头钩子 / 话题标签
```

**竞品监控**

```
post-cli --limit 30                        # 拿对方近 30 条
→ 按发布时间算更新频率
→ 按互动数据找出爆款
→ comment-cli 拉爆款的评论区看用户为什么买
```

**KOL 筛选**

```
post-cli --limit 20
→ 计算 评论数/点赞数、收藏数/点赞数 比值
→ 比值异常偏低 → 疑似刷量,标记风险
```

---

## 3. 🧺 输入规则

### 3.1 🔍 关键词搜索

| 参数             | 必填 | 取值                                                                       | 默认 |
| ---------------- | ---- | -------------------------------------------------------------------------- | ---- |
| `--keyword` `-k` | 是   | 2-50 字符,不能是链接                                                      | —    |
| `--type` `-t`    | 否   | 内容类型,`0` 全部 / `1` 视频 / `2` 图文             

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

declared (1 observation(s))

Network

declared (1 observation(s))

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (1)

const pkg = require("../../package.json");

Gates applied: no_behavioural_pass.