📊 图文捕手 - 社交平台内容抓取机器人

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

🔥核心优势

轻量: 无需部署服务，OpenClaw一键运行

灵活: 支持多维度筛选、批量操作、多格式导出

实用: 日志自动归档，适配营销报告 / 内容策划场景

安全: 无需登录你的小红书账号，不担心风控风险 / 封号问题

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

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

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

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

node src/xiaohongshu/search-cli.js 数据分析

2.2 🔎 按点赞排序找爆款（最常用）

node src/xiaohongshu/search-cli.js --keyword "AI" --sort 2

2.3 🔎 按最新排序找风口（最常用）

node src/xiaohongshu/search-cli.js --keyword "AI" --sort 1

2.4 📕 小红书笔记详情查询（内容分析）

node src/xiaohongshu/detail-cli.js "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 环境