核心用法
Redbook 是一款面向小红书（Xiaohongshu/RED）的命令行工具，提供从内容搜索、数据分析到自动化运营的完整工作流。
基础功能：
redbook search：关键词搜索笔记，支持按热度、最新、综合排序redbook read：读取单篇笔记完整内容redbook user/user-posts：创作者资料与历史作品抓取redbook analyze-viral：爆款笔记结构分析（0-100 病毒评分）redbook viral-template：从多篇爆款提取可复制的内容模板
进阶分析模块：
- 关键词矩阵分析：Top1/Top10 互动数据对比，评估赛道天花板
- 跨话题热力图：base topic + scene 组合搜索，发现内容空白
- 互动信号分类：收藏/点赞比判断内容类型（工具型/认知型/娱乐型）
- 创作者画像：粉丝数、中位数/平均互动量、发布频率、内容风格
- 机会评分：S/A/B/C 四级关键词分层，量化投入产出比
自动化运营：
redbook batch-reply：智能批量回复（支持问题/高赞/未回复策略），内置 5 分钟±30% 抖动延迟，单批次上限 30 条redbook render：Markdown 转小红书风格卡片图（1080×1440，7 种主题）
关键限制：
- 发布笔记（
post）频繁触发验证码，成功率低 - 点赞/关注/DM 不支持（反自动化封锁严格）
- 需 Chrome 登录态获取 Cookie，macOS 原生支持
xsec_token易过期，搜索获取的 URL 需及时使用
显著优点
- 结构化分析框架：12 个模块化分析体系（A-L），覆盖从市场扫描到内容生产全流程
- 平台原生指标：收藏/点赞比、评论/点赞比、分享/点赞比等小红书特有信号解读
- 安全设计：batch-reply 强制 dry-run 预览、抖动延迟、硬上限保护、验证码熔断
- 模板化输出：viral-template 自动生成内容骨架，降低爆款复制门槛
潜在缺点与局限
- API 脆弱性：XHS 风控严格，读取需实时
xsec_token，写操作易触发 captcha - 平台绑定：仅支持小红书，无法迁移至抖音、Instagram 等平台
- 发布功能受限：
post命令标注为 "Limited"，实际运营需配合浏览器自动化 - macOS 独占：Cookie 提取依赖原生钥匙串，Linux/Windows 无官方支持
- 中文数字解析：API 返回 "1.5万" 等格式，需额外处理
适合人群
- 内容运营者：批量监控竞品账号、追踪话题热度、生成数据周报
- 自媒体创作者：研究爆款结构、提取内容模板、规划选题矩阵
- 市场研究人员：消费者洞察、赛道竞争分析、KOL 筛选
- 自动化开发者：基于 CLI 搭建小红书数据管道（配合
--json输出）
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 账号风控 | 高频操作触发 124 型验证码或 IP 封禁 | 遵守 3-5 分钟操作间隔，单账号日回复≤30 条 |
| Token 过期 | `xsec_token` 缓存导致读取失败 | 始终先搜索获取新鲜 URL，不硬编码历史链接 |
| Cookie 泄露 | 提取浏览器 Cookie 写入临时文件 | 使用 `--chrome-profile` 隔离，避免共享环境 |
| 误操作批量回复 | `batch-reply` 无模板时默认 dry-run，但误执行可能 spam | 强制人工审核 dry-run 输出，vary 模板内容 |
| 依赖单点 | 工具停更或 XHS API 变更导致失效 | 核心数据定期导出 JSON 备份，避免 vendor lock-in |