\r \r

📕 小红书搜索雷达\r

\r

💡一句话价值：一键搜索小红书笔记、互动数据，帮你做爆款选题、竞品分析。\r \r 🔥核心优势\r \r

• 轻量: 无需部署服务，Node.js 一键运行\r
• 灵活: 支持多维度筛选、批量操作、多格式导出\r
• 实用: 日志自动归档，适配营销报告 / 内容策划场景\r
• 安全: 无需登录你的小红书账号，不担心风控风险 / 封号问题\r \r

1. ✅ 我能帮你解决什么（10 秒判断）\r

\r

• 🔍 按关键词搜小红书笔记（最新/最多点赞/最多评论/最多收藏排序）：找爆款选题、分析高赞笔记规律\r
• 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r
• 📡 热点追流：实时获取小红书热搜，抢占流量风口\r
• 📊 数据导出：自动生成JSON日志，方便二次使用\r \r

2. 🚀 最快上手（复制就能跑，30 秒出结果）\r

\r

Note: 请先通过微信 \x3C13395823479> 申请 API TOKEN，配置环境变量 GUAIKEI_API_TOKEN 后才能正常运行。\r \r

2.1 🔎 小红书关键词搜索（最简单）\r

\r

node src/xiaohongshu/search-cli.js 数据分析\r
```\r
\r
### 2.2 🔎 按点赞排序找爆款（最常用）\r
\r
```bash\r
node src/xiaohongshu/search-cli.js --keyword "AI" --sort 2\r
```\r
\r
### 2.3 🔎 按最新排序找风口（最常用）\r
\r
```bash\r
node src/xiaohongshu/search-cli.js --keyword "AI" --sort 1\r
```\r
\r
### 2.4 📕 小红书笔记详情查询（内容分析）\r
\r
```bash\r
node src/xiaohongshu/detail-cli.js "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"\r
```\r
\r
## 3. 📌 适用场景（我该不该用？）\r
\r
- 你需要做小红书笔记选题 → 关键词搜索 + 点赞排序\r
- 你需要模仿爆款文案 → 查看高赞笔记详情\r
- 你需要做营销报告 → 导出结构化数据\r
\r
## 4. 🔧 参数详解表\r
\r
### 🔎 小红书关键词搜索\r
\r
| 参数        | 缩写 | 作用       | 可选值                                                           | 必填 |\r
| :---------- | :--: | :--------- | :--------------------------------------------------------------- | :--: |\r
| `--keyword` | `-k` | 搜索关键词 | 2-50 个汉字                                                      |  是  |\r
| `--type`    | `-t` | 内容类型   | 0 = 全部 / 1 = 视频 / 2 = 图文                                   |  否  |\r
| `--sort`    | `-s` | 排序方式   | 0 = 综合 / 1 = 最新 / 2 = 最多点赞 / 3 = 最多评论 / 4 = 最多收藏 |  否  |\r
| `--limit`   | `-l` | 搜索数量   | 1-60 条                                                          |  否  |\r
| `--output`  | `-o` | 输出格式   | json / markdown                                                  |  否  |\r
\r
### 📕 小红书笔记详情获取\r
\r
| 参数      | 缩写 | 类型    | 说明                     |\r
| :-------- | :--- | :------ | :----------------------- |\r
| `--url`   | `-u` | 字符串  | 必填，笔记链接           |\r
| `--limit` | `-l` | 1-60000 | 获取笔记评论数量 (默认6) |\r
\r
> **💡"笔记链接"说明**\r
>\r
> - 完整链接：必须包含 xsec_token 参数（如 \x3Chttps://www.xiaohongshu.com/explore/xxx?xsec_token=yyy> ）\r
> - 短链接：\x3Chttps://xhslink.com/m/xxx> （自动兼容，无需手动解析）\r
> - ❌ 错误：链接含空格、无xsec_token的完整链接会直接报错\r
\r
## 5. ⚠️ 重要限制（不踩坑）\r
\r
- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r
- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r
- 数据仅限个人 / 团队内部使用，禁止违规分发\r
\r
## 6. ❓ 常见问题（秒解决）\r
\r
> **💡Q：运行报错，提示无权限？**\r
>\r
> A：先配置环境变量：`set GUAIKEI_API_TOKEN=你的TOKEN`\r
>\r
> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r
>\r
> **💡Q：输出文件在哪里？**\r
>\r
> A：自动保存在技能目录的 `logs` 文件夹下\r
>\r
> - 搜索任务日志: 默认保存为「时间戳*关键词*类型*排序*数量\_search.json」\r
> - 详情任务日志: 默认保存为「时间戳\_笔记ID_detail.json」\r
>\r
> **💡Q：支持 Windows/Mac/Linux 吗？**\r
>\r
> A：全平台支持，仅需安装 Node.js 环境\r