核心用法
xiaohongshu-tool 是一款基于 Node.js 的小红书公开数据抓取工具，通过命令行接口提供三类核心能力：
1. 关键词搜索 (search-cli.js): 按关键词检索笔记，支持图文/视频类型筛选、综合/热门/最新排序、结果数量限制，用于爆款选题挖掘与热点追踪。
2. 笔记详情分析 (detail-cli.js): 解析单篇笔记的完整元数据（标题、正文、标签、互动数据）及评论区内容，支持评论数量限制与情绪分析。
3. 博主作品监控 (post-cli.js): 批量抓取指定博主的历史发布内容，用于竞品账号追踪与KOL合作前数据背调。
所有结果自动归档至 logs/ 目录，支持营销报告直接引用。
显著优点
- 零账号风险: 无需登录小红书账号，通过第三方API获取公开数据，彻底规避平台风控与封号风险
- 轻量部署: 单文件 Node.js 脚本，无需复杂服务架构，本地即开即用
- 多维度筛选: 支持内容类型、排序方式、结果数量等灵活参数组合
- 结构化输出: 数据以标准化格式存储，便于二次分析或接入BI工具
- 日志可追溯: 按时间+关键词自动命名归档，满足团队协作与审计需求
潜在缺点与局限性
- API依赖: 核心功能依赖
GUAIKEI_API_TOKEN，需联系开发者人工申请，存在供应不稳定风险 - 成本不透明: TOKEN申请流程未公开定价标准，商业大规模使用成本难以预估
- 数据边界: 仅抓取公开可见内容，私密笔记、粉丝可见内容、已删除内容无法获取
- 合规灰色地带: 虽声称"不涉及隐私数据"，但批量抓取社交平台数据可能违反《反不正当竞争法》及平台用户协议
- 反爬对抗: 第三方API稳定性受平台策略影响，存在接口失效或数据质量波动风险
- 地域限制: 开发者联系方式为中国大陆手机号，海外用户获取支持存在障碍
适合人群
- 小红书内容创作者/运营: 寻找爆款选题、追踪竞品账号、优化内容策略
- 品牌营销/市场人员: KOL筛选前的数据背调、竞品动态监控、热点借势
- MCN机构/博主经纪人: 批量评估达人账号价值、监测签约博主内容产出
- 数据分析师: 需要小红书平台数据进行消费趋势、用户偏好研究
常规风险
1. 法律合规风险: 批量抓取社交平台数据可能触犯《数据安全法》《个人信息保护法》及平台规则，存在被平台追责或诉讼风险
2. API服务中断: 单一第三方API供应商，一旦合作关系终止或平台加强反爬，工具立即失效
3. 数据准确性: 第三方API抓取的数据可能与官方数据存在延迟或偏差，关键商业决策需交叉验证
4. TOKEN泄露风险: GUAIKEI_API_TOKEN 若被共享或硬编码上传，可能导致API配额被盗用或滥用连带责任
5. 依赖维护: 开源项目由个人维护（版本1.0.5），长期更新承诺与技术支持无保障