公域数据抓取器

数据采集的痛点与合规风险

在做小红书竞品分析或内容选题时，手动复制粘贴笔记和评论不仅效率低下，还极易触发平台风控导致账号封禁。开发者急需一种无需登录、安全合规且能直接输出结构化数据的方案，以便将原始数据无缝接入后续的数据分析或报告生成流水线。

核心能力与调用路由

该技能基于 Node.js 运行，通过配置环境变量 GUAIKEI_API_TOKEN 调用第三方接口，将小红书的公开数据层封装为四个独立的 CLI 脚本：

• 关键词搜索：使用 search-cli.js 按关键词检索公开笔记，支持按点赞、评论、时间等维度筛选。
• 笔记详情：使用 detail-cli.js 解析 explore/ 笔记链接，获取正文与互动数据。
• 博主监控：使用 post-cli.js 抓取 user/profile/ 主页的公开作品列表。
• 评论获取：使用 comment-cli.js 单独拉取笔记评论区，用于观点聚类或舆情分析。

执行前需根据用户输入的链接类型（笔记或博主）进行路由分发，避免类型错配。

适用边界与避坑指南

此工具严格限定于公开数据的获取，不支持任何登录态、私密或隐藏内容，也不包含发布、点赞等逆向操作。使用时需注意：

• 链接校验：xhslink.com 等短链具有不透明性，建议优先使用完整的 https:// 长链接以防解析错误。
• 参数限制：limit 参数上限为 10000，超限会被静默降级为 10。
• 异常处理：输出结果包含 status 与 error_code 字段，下游程序必须先判断 status 再解析 results，切勿将空结果或接口报错伪造成成功数据。