xiaohongshu-crawler

# Xiaohongshu Crawler 小红书（Xiaohongshu）内容爬取工具，支持搜索、笔记详情、用户信息等公开内容的获取。 ## 📋 描述 小红书内容爬取工具，支持搜索笔记（需要登录）、获取笔记详情、用户信息、热门笔记等公开内容爬取功能。 **使用场景：** - 搜索特定关键词的笔记 - 获取单条笔记的详细内容 - 获取用户公开信息 - 获取热门笔记列表 - 批量深度爬取并生成分析报告 **注意：** 本工具仅限学习和研究使用，必须遵守小红书用户协议和相关法律法规。 ## 🚀 安装 ```bash clawhub install xiaohongshu-crawler ``` ## ⚙️ 快速配置 ### 1. 获取 Cookie（搜索功能必需） ```bash node scripts/get-cookie.js ``` 按提示扫码登录后输入 `save` 即可。 ### 2. 测试 Cookie ```bash node scripts/test-cookie.js ``` 显示 "✅ Cookie 有效" 即可使用。 ## 📝 核心用法 ### 快速搜索 ```bash node scripts/quick-search.js "关键词" [数量] ``` ### 深度爬取 ```bash node scripts/deep-crawl.js "关键词" [数量] ``` 生成详细内容和 Markdown 分析报告。 ### 其他功能 ```bash node scripts/get-note.js "笔记 ID" # 获取笔记详情 node scripts/get-user.js "用户 ID" # 获取用户信息 node scripts/hot-notes.js # 获取热门笔记 ``` ## 📚 详细文档 - **完整使用指南** → `references/USAGE.md` - **使用示例** → `references/examples.md` - **故障排查** → `references/TROUBLESHOOTING.md` ## 🛠️ 脚本说明 | 脚本 | 功能 | 需要登录 | |------|------|---------| | `get-cookie.js` | 交互式获取 Cookie | - | | `test-cookie.js` | 测试 Cookie 有效性 | - | | `quick-search.js` | 快速搜索笔记 | ✅ | | `deep-crawl.js` | 深度爬取笔记详情 | ✅ | | `get-note.js` | 获取单条笔记详情 | ✅ | | `get-user.js` | 获取用户信息 | ✅ | | `hot-notes.js` | 获取热门笔记 | 可选 | ## ⚠️ 使用规范 ### 合规使用 - ✅ **允许：** 个人学习研究、公开内容爬取、小批量数据（<50 条/次） - ❌ **禁止：** 商业用途、大规模高频爬取、私人内容、绕过付费、分发数据 ### 反爬保护 - 默认随机延迟 2-8 秒 - 每分钟最多 10 个请求 - 模拟人类浏览行为 --- 详细配置和故障排查请查看 `references/` 目录下的文档。