Redbook Agent Skill

Redbook — 小红书内容分析 CLI

用 redbook CLI 搜索笔记、读内容、分析创作者、提取爆款规律、研究选题。OpenClaw 用户： clawhub install redbook 或 npm install -g @lucasygu/redbook。

⚠️ 环境依赖（当前环境不可用）

本 SKILL 依赖以下运行时，在当前"macOS 专属 / Linux"环境下不可用，属于死代码保留，仅供部署到 macOS 桌面时启用：

| 依赖 | 说明 |

|------|------|

| macOS | cookie 抽取用原生 keychain（os: [macos]） |

| Node.js ≥ 22 | 运行 @lucasygu/redbook CLI |

| redbook binary | 经 clawhub install redbook / npm 安装 |

| Chrome 登录 cookie | 需在 Chrome 登录 xiaohongshu.com（或 Safari/Firefox + --cookie-source） |

| puppeteer-core + marked | 仅 render 卡片渲染需要（可选） |

与 skill-xhs-publisher 的分工边界

• xhs-analyzer（本 SKILL） = 分析：搜索/数据/爆款规律/关键词矩阵/创作者画像/限流检测。
• skill-xhs-publisher = 发布 + 互动运营：发图文/视频、日常评论/回复/点赞收藏、内容数据、通知抓取。
• 本 SKILL 只读。不得调用 comment/reply/like/collect/post 等写命令；发布交给 skill-xhs-publisher，评论与回复交给 skill-xhs-comment-reply，由对应 Skill 执行确认和出站安全检查。

Research discipline（先读这条）

XHS 风控节流的是读取，不只是写入。任何读超过几篇笔记的研究，都必须走 references/research-loop.md 的研究循环 —— 默认 human-paced（~20 s/篇，一次一篇）。在紧循环里猛敲 read/comments/analyze-viral 会在几十次内触发验证码/IP 封（300012），账号降级数小时。⚡ Fast 模式仅应急，需打印警告 + 用户明确 opt-in。绝不并行或零延迟发读。

Usage

redbook search "AI编程" --json       # 搜索笔记
redbook read <webUrl> --json         # 读笔记（用 search 返回的 webUrl，含 xsec_token）
redbook user <profileUrl> --json     # 创作者档案
redbook analyze-viral <webUrl> --json # 单篇爆款分析（0-100 分）
redbook account-report --file ids.txt --json  # 批量账号指标
redbook health --all --json          # 笔记限流检测

始终加 --json 供程序解析。全部命令、选项、JSON 结构见 references/commands.md。

能力概览

分析能力拆成 13 个可组合模块（A–M）+ 组合工作流，详见 references/modules.md：

| 模块 | 能力 |

|------|------|

| A 关键词参与度矩阵 · B 跨主题热力图 · C 参与度信号 | 需求版图 |

| D 创作者画像 · D2 已知账号报告 · E 内容形态分解 | 竞争/形态 |

| F 机会评分 · G 受众推断 · H 内容头脑风暴 | 策略产出 |

| I 评论洞察 · J 爆款结构拆解 · K 互动机会识别 | 只读分析 |

| L 卡片渲染（离线） · M 笔记限流检测 | 产出/健康 |

组合示例：快速主题扫描 A→C→F；完整细分分析 A→B→C→D→E→F→G→H；单篇深挖 analyze-viral。

关键领域知识（references/）

| 文件 | 内容 |

|------|------|

| platform-signals.md | 收藏/点赞、评论/点赞、分享/点赞比率基准；排序语义；图文 vs 视频 |

| modules.md | 13 个分析模块 A–M + 组合工作流 |

| commands.md | 所有 redbook 命令详解 + 选项 + JSON 结构 + 全局选项 |

| research-loop.md | 读操作节流：三模式/严格规则/状态契约/tick/驱动器/熔断器/写侧阈值 |

| technical-reference.md | 大陆 vs 全球后端、xsec_token、中文数字、错误处理、API vs 浏览器限制、输出格式 |

Requirements

• macOS（cookie 抽取用原生 keychain）· Node.js ≥ 22 · 已在 Chrome 登录 xiaohongshu.com
• 仅卡片渲染额外需 puppeteer-core + marked（用本机 Chrome，无需额外下载浏览器）