\r \r

📊 小红书数据洞察大师 - 爆款挖掘与竞品分析专家\r

\r

一、工具概述\r

\r

1.1 核心价值\r

\r 小红书数据挖掘工具，无需登录小红书账号即可获取笔记数据，通过数据驱动实现爆款挖掘、竞品分析、趋势洞察、KOL 筛选等核心目标，覆盖内容创作、品牌营销、市场分析全场景。\r \r

1.2 核心能力矩阵\r

\r | 能力模块 | 核心功能 | 解决痛点 |\r | :-------------- | :--------------------------- | :------------------------------- |\r | 🔍 爆款挖掘 | 热门笔记发现、高互动内容检索 | 找不到选题灵感，不知道什么内容火 |\r | 🕵️ 竞品分析 | 对标账号监控、笔记表现追踪 | 竞品涨粉快的原因及策略不明确 |\r | 👥 KOL 筛选 | 博主粉丝画像、互动率分析 | 投放博主选择难，担心数据造假 |\r | 📈 趋势监控 | 关键词热度追踪、话题趋势分析 | 错过热点，无法预判市场风向 |\r \r

1.3 适用人群\r

\r 小红书内容创作者 / 运营、品牌营销 / 市场人员、数据分析师、MCN 机构 / 博主经纪人。\r \r

1.4 核心使用场景\r

\r | 场景 | 具体价值 |\r | ------------ | ---------------------------------------------------------- |\r | 内容创作选题 | 输入关键词筛选「最多点赞」笔记，快速定位爆款选题方向 |\r | 品牌竞品监控 | 分析竞品账号 / 笔记的互动数据、内容风格，制定差异化策略 |\r | KOL投放筛选 | 解析 KOL 笔记真实互动率，规避数据造假的博主 |\r | 市场趋势分析 | 定时监控关键词「最新排序」，捕捉热点风向并提前布局内容 |\r | 数据报表生成 | 输出 Markdown 格式结果，直接嵌入运营周报，减少手动整理成本 |\r \r

二、快速使用指南\r

\r

2.1 前置条件\r

\r

• 安装Node.js 16.14.0 及以上版本\r
• 配置环境变量 GUAIKEI_API_TOKEN（默认TOKEN仅用于体验，私有TOKEN需申请）\r \r

2.2 环境配置\r

\r

# 验证Node.js版本\r
node -v\r
\r
# Linux/Mac配置环境变量\r
export GUAIKEI_API_TOKEN="你的令牌"\r
\r
# Windows配置环境变量\r
set GUAIKEI_API_TOKEN="你的令牌"\r
```\r
\r
### 2.3 核心命令使用\r
\r
#### 2.3.1 小红书关键词搜索\r
\r
```bash\r
# 基础语法\r
node src/xiaohongshu/search-cli.js \x3C关键词> [选项]\r
\r
# 完整选项说明\r
--keyword -k \x3C关键词>: 搜索关键词（必填，2-50个汉字，避免特殊符号）\r
--type -t \x3C0/1/2>: 内容类型，0-全部（默认），1-视频，2-图文\r
--sort -s \x3C0-4>: 排序规则，0-综合（默认），1-最新，2-最多点赞，3-最多评论，4-最多收藏\r
--limit -l \x3C1-60>: 搜索数量，1-60（默认10）\r
--output -o \x3Cjson/markdown>: 输出格式（默认json）\r
--help -h: 显示帮助信息\r
\r
# 使用示例\r
\r
#搜索“数据挖掘”最多点赞的20条笔记\r
node src/xiaohongshu/search-cli.js "数据挖掘" --sort 2 --limit 20\r
#搜索“数据分析”的图文笔记，输出Markdown格式\r
node src/xiaohongshu/search-cli.js --keyword "数据分析" --type 2 --output markdown\r
#爆款挖掘：数据分析（图文+最多点赞）\r
node src/xiaohongshu/search-cli.js "数据分析" --type 2 --sort 2\r
#趋势监控：数据挖掘（最新排序）（定时执行）\r
node src/xiaohongshu/search-cli.js "数据挖掘" --sort 1\r
```\r
\r
#### 2.3.2 小红书笔记详情查询\r
\r
```bash\r
# 基础语法\r
node src/xiaohongshu/detail-cli.js \x3C笔记链接> [选项]\r
\r
# 选项说明\r
--url -u \x3C笔记链接>: 笔记链接（支持https://www.xiaohongshu.com/explore/xxx 或 http://xhslink.com/m/xxx）\r
--help -h: 显示帮助信息\r
\r
# 链接格式要求\r
1. 完整链接：必须包含 xsec_token 参数（如 https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy）\r
2. 短链接：https://xhslink.com/m/xxx（自动兼容，无需手动解析）\r
❌ 错误：链接含空格、无xsec_token的完整链接会直接报错\r
\r
# 使用示例\r
node src/xiaohongshu/detail-cli.js "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"\r
node src/xiaohongshu/detail-cli.js --url "http://xhslink.com/m/xxx"\r
```\r
\r
## 三、数据合规说明\r
\r
✅ 仅抓取小红书**公开可见**内容，无隐私数据泄露风险\r
✅ 本技能不登录小红书账号，仅依赖API获取公开数据\r
✅ 数据仅用于商业分析参考，需遵守小红书平台使用条款\r
✅ 所有输出数据均做脱敏处理，不涉及用户个人信息\r
✅ 本工具依赖第三方 API 进行数据获取。数据仅供参考，第三方服务可能存在不稳定或接口变更的情况。请勿用于高频爬虫或侵犯用户隐私的场景\r
⚠️ 高频调用（如1分钟>10次）可能触发API频率限制\r
\r
## 四、技术说明\r
\r
- 系统：Windows/Linux/MacOS（仅需 Node.js，无额外依赖）\r
- 运行环境：Node.js 16.14.0+，需提前配置 `GUAIKEI_API_TOKEN` 环境变量\r
- 网络：需正常访问网络，国内服务器无需代理\r
- 权限：普通用户权限即可运行，无需管理员权限\r
\r
### 4.1 日志说明\r
\r
- 运行时会输出彩色日志：INFO(蓝色)、SUCCESS(绿色)、WARN(黄色)、ERROR(红色)；\r
- 启动时会打印工具Banner，方便确认是否正确执行；\r
- 所有任务结果会自动保存到 `logs/` 目录（按时间+关键词/链接命名）。\r
\r
## 五、版本更新日志\r
\r
### v1.0.0\r
\r
- 首发上线：实现小红书关键词搜索、小红书笔记详情与评论获取自动化工具。\r
- 支持热门笔记挖掘、竞品分析、趋势监控等核心商业分析功能。\r
- 增加多选项参数（类型、排序、输出格式、搜索数量）灵活定制搜索。\r
- 提供开放式命令行用法与使用示例，适配 Node.js 16.14.0+ 环境。\r