back
loading skill details...
小红书自动化运营工具-支持:搜索笔记、查看笔记详情及评论。 当用户提及 xiaohongshu、小红书、RedNote,或需要在该平台进行内容调研时使用。
---
name: xhs-content-analytics
description: 小红书自动化运营工具-支持:搜索笔记、查看笔记详情及评论。 当用户提及 xiaohongshu、小红书、RedNote,或需要在该平台进行内容调研时使用。
license: MIT
metadata:
version: "1.0.1"
category:
- "Data&APIs"
- "数据分析"
tags:
- "小红书关键词搜索"
- "小红书笔记详情查询"
- "小红书评论抓取"
- "小红书内容排序筛选"
- "小红书爆款选题"
- "小红书竞品监控"
- "小红书营销报告制作"
- "小红书热点追踪"
- "无需登录"
capabilityBoundary:
- "支持小红书公开内容抓取,不支持私密笔记/付费内容"
- "评论获取上限60000条,搜索结果上限60条"
- "无需登录小红书账号,无封号/风控风险"
examples:
- scenario: "找露营装备类高赞爆款视频笔记(内容选题)"
command: "node src/xiaohongshu/search-cli.js -k 露营装备 -t 1 -s 2 -l 10"
paramExplain: "-k=露营装备(搜索关键词)、-t=1(仅视频)、-s=2(最多点赞)、-l=10(返回10条)"
outputExpect: "输出10条露营装备高赞视频笔记,含标题、链接、点赞/收藏数等核心数据"
- scenario: "分析单篇笔记评论区情绪(用户反馈分析)"
command: "node src/xiaohongshu/detail-cli.js -u 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy'"
paramExplain: "-u=笔记PC链接(必填),默认获取6条评论"
outputExpect: "返回笔记基础信息+6条评论内容,支持情绪分析"
- scenario: "导出AI图文笔记收藏排序数据(营销报告)"
command: "node src/xiaohongshu/search-cli.js --keyword AI --type 2 --sort 4 --limit 20 --output json"
paramExplain: "--keyword=AI、--type=2(图文)、--sort=4(最多收藏)、--limit=20、--output=json"
outputExpect: "生成JSON文件,含20条AI图文笔记全量数据,可用于报告可视化"
---
# 📊 小红书内容分析 - 获取小红书内容表现数据
> **💡一句话价值**:一键搜索小红书笔记、互动数据,帮你做爆款选题、竞品分析。
>
> **🔥核心优势**
>
> - 轻量: 无需部署服务,OpenClaw一键运行
> - 灵活: 支持多维度筛选、批量操作、多格式导出
> - 实用: 日志自动归档,适配营销报告 / 内容策划场景
> - 安全: 无需登录你的小红书账号,不担心风控风险 / 封号问题
## 1. ✅ 我能帮你解决什么(10 秒判断)
- 🔍 按关键词搜小红书笔记(最新/最多点赞/最多评论/最多收藏排序):找爆款选题、分析高赞笔记规律
- 🦸 竞品监控:批量抓取对标账号所有公开作品数据,分析内容策略
- 📡 热点追流:实时获取小红书热搜,抢占流量风口
- 📊 数据导出:自动生成JSON日志,方便二次使用
## 2. 🚀 最快上手(复制就能跑,30 秒出结果)
> Note: 请先通过微信 <13395823479> 申请 API TOKEN,配置环境变量 GUAIKEI_API_TOKEN 后才能正常运行。
### 2.1 🔎 小红书关键词搜索
```bash
node src/xiaohongshu/search-cli.js -k 数据分析
```
### 2.2 🔎 按点赞排序找爆款
```bash
node src/xiaohongshu/search-cli.js --keyword "AI" --sort 2
```
### 2.3 🔎 按最新排序找风口
```bash
node src/xiaohongshu/search-cli.js --keyword "AI" --sort 1
```
### 2.4 📕 小红书笔记详情查询
```bash
node src/xiaohongshu/detail-cli.js -u "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
```
## 3. 📌 适用场景(我该不该用?)
- 你需要做小红书笔记选题 → 关键词搜索 + 点赞排序
- 你需要模仿爆款文案 → 查看高赞笔记详情
- 你需要做营销报告 → 导出结构化数据
## 4. 🔧 参数详解表
### 🔎 小红书关键词搜索
| 参数 | 缩写 | 作用 | 可选值 | 必填 |
| :---------- | :--: | :--------- | :--------------------------------------------------------------- | :--: |
| `--keyword` | `-k` | 搜索关键词 | 2-50 个汉字 | 是 |
| `--type` | `-t` | 内容类型 | 0 = 全部 / 1 = 视频 / 2 = 图文 | 否 |
| `--sort` | `-s` | 排序方式 | 0 = 综合 / 1 = 最新 / 2 = 最多点赞 / 3 = 最多评论 / 4 = 最多收藏 | 否 |
| `--limit` | `-l` | 搜索数量 | 1-60 条 | 否 |
| `--output` | `-o` | 输出格式 | json / markdown | 否 |
### 📕 小红书笔记详情获取
| 参数 | 缩写 | 类型 | 说明 |
| :-------- | :--- | :------ | :----------------------- |
| `--url` | `-u` | 字符串 | 必填,笔记链接 |
| `--limit` | `-l` | 1-60000 | 获取笔记评论数量 (默认6) |
> **💡"笔记链接"说明**
>
> - PC链接: <https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy>
> - 短链接: <https://xhslink.com/m/xxx>
## 5. ⚠️ 重要限制(不踩坑)
- 仅抓取抖音公开数据,不支持私密 / 隐藏内容
- 需要配置 GUAIKEI_API_TOKEN 才能正常运行
- 数据仅限个人 / 团队内部使用,禁止违规分发
## 6. ❓ 常见问题(秒解决)
> **💡Q:运行报错,提示无权限?**
>
> A:先配置环境变量:`set GUAIKEI_API_TOKEN=你的TOKEN`
>
> - 私有TOKEN申请后请留意使用安全,避免泄露给他人
>
> **💡Q:输出文件在哪里?**
>
> A:自动保存在技能目录的 `logs` 文件夹下
>
> - 搜索任务日志: 默认保存为「时间戳*关键词*类型*排序*数量\_search.json」
> - 详情任务日志: 默认保存为「时间戳\_笔记ID_detail.json」
>
> **💡Q:支持 Windows/Mac/Linux 吗?**
>
> A:全平台支持,仅需安装 Node.js 环境
don't have the plugin yet? install it then click "run inline in claude" again.