Redbook logo

Redbook

OrganizationPopular
ZJU-REAL
redbook

小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作。 当用户说"小红书数据分析""小红书爆款分析""笔记数据""小红书限流检测""小红书创作者画像""分析小红书账号"时使用。 发布与日常互动运营请用 skill-xhs-publisher。

Overview

PublisherZJU-REAL
RepositoryEasel
Skill nameredbook
Stars
3.5K
Forks
535
Bundled files
28
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 28 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by ZJU-REAL on GitHub. Read the source before you install it.

Installation

Install the Redbook AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/skill-xhs-analyzer
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/ZJU-REAL/Easel.git /tmp/Easel
mkdir -p .claude/skills
cp -r /tmp/Easel/skills/openclaw/skill-xhs-analyzer .claude/skills/redbook
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Redbook in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Redbook on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Redbook is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Redbook — 小红书内容分析 CLI

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

⚠️ 环境依赖(当前环境不可用)

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

依赖说明
macOScookie 抽取用原生 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.md13 个分析模块 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,无需额外下载浏览器)

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Redbook AI skill do?

小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作。 当用户说"小红书数据分析""小红书爆款分析""笔记数据""小红书限流检测""小红书创作者画像""分析小红书账号"时使用。 发布与日常互动运营请用 skill-xhs-publisher。

Why use Redbook on TypingMind?

Because you install it once and use it with any model. Redbook is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Redbook in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/skill-xhs-analyzer. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Redbook?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Redbook?

As many as you like. As long as a model supports skills, you can use Redbook with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Redbook AI skill free?

Yes. It is published on GitHub by ZJU-REAL under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇