Agent skill

Redbook

by ZJU-REAL in ZJU-REAL/Easel

小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作. An agent skill from ZJU-REAL/Easel.

Apache-2.0Auto-check passed

Install Redbook

skills CLI
$ npx skills add ZJU-REAL/Easel --skill redbook -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZJU-REAL/Easel redbook --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/skill-xhs-analyzer .claude/skills/redbook && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
redbook
GitHub stars
3.4k
Token cost
~827 tokens
SKILL.md length
185 words
Files
31 (incl. scripts, references)
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作. An agent skill from ZJU-REAL/Easel.

  • SKILL.md covers ⚠️ 环境依赖(当前环境不可用), 与 skill-xhs-publisher 的分工边界, Research discipline(先读这条) and Usage, plus 3 more sections
  • Runs JavaScript and TypeScript scripts from its folder; calls npm

What it does

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

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 35 other files, including scripts and reference files (for example `.github/workflows/npm-publish.yml`, `EASEL-META.md` and `package-lock.json`).

It works with Xiaohongshu and macOS. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

Example prompts

  • “小红书数据分析”
  • “小红书爆款分析”
  • “小红书限流检测”
  • “/redbook”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit ede33b8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (JavaScript and TypeScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Redbook loads about 827 tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 185 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~827
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ZJU-REAL/Easel at commit ede33b8, republished under its Apache-2.0 licence (© ZJU-REAL). 185 words, ~827 tokens.

Download SKILL.mdSave it as .claude/skills/redbook/SKILL.md (or your agent's skills folder). This skill also uses 30 other files; get the full folder from GitHub.
name
redbook
description
小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作。 当用户说"小红书数据分析""小红书爆款分析""笔记数据""小红书限流检测""小红书创作者画像""分析小红书账号"时使用。 发布与日常互动运营请用 skill-xhs-publisher。
layer
attribute

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,无需额外下载浏览器)

© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 30 other files (scripts, references) in skills/openclaw/skill-xhs-analyzer of ZJU-REAL/Easel.

  • SKILL.md
  • .github/workflows/npm-publish.yml
  • EASEL-META.md
  • package-lock.json
  • package.json
  • references/commands.md
  • references/modules.md
  • references/platform-signals.md
  • references/research-loop.md
  • references/technical-reference.md
  • scripts/postinstall.js
  • scripts/preuninstall.js
  • social-preview.html
  • social-preview.png
  • src/cli.ts
  • src/lib
  • … and 15 more

Open the folder on GitHubat commit ede33b8

Compare with similar skills

Redbook next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Redbook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Redbook this skillZJU-REAL/Easel3.4k—~827Automated safety check: PassApache-2.0
Xiaohongshu Coverredfox-data/redfox-community427—~1.4kAutomated safety check: PassNone
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80611 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter180k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Xiaohongshu Cover

    redfox-data/redfox-community

    专为小红书内容创作打造的AI封面设计工具,基于全网每日持续收录的2000+条爆款笔记数据,深度抓取同赛道爆款封面的视觉元素,通过AI智能分析总结高转化视觉规律,生成贴合笔记内容、符合平台流量审美的可落地封面设计方案,省去繁琐设计流程,提升笔记封面点击率。

    427 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    806 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    180k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated today
    Auto-check passed

Questions about Redbook

What does Redbook do?

小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作. An agent skill from ZJU-REAL/Easel. Redbook is an agent skill from ZJU-REAL/Easel.

How do I install Redbook in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill redbook -a claude-code`. Or copy the skill folder (skills/openclaw/skill-xhs-analyzer in ZJU-REAL/Easel) into .claude/skills/redbook in your project. Claude Code loads it when a task matches its description.

How do I install Redbook in Codex?

Run `npx skills add ZJU-REAL/Easel --skill redbook -a codex`. Or copy the skill folder (skills/openclaw/skill-xhs-analyzer in ZJU-REAL/Easel) into .agents/skills/redbook in your project. Codex loads it when a task matches its description.

Can I use Redbook in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJU-REAL/Easel --skill redbook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/redbook, .gemini/skills/redbook, .github/skills/redbook and .opencode/skills/redbook in your project.

What does Redbook need to run?

Going by SKILL.md and its folder, Redbook needs JavaScript and TypeScript for the scripts in its folder and the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Redbook access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Redbook safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Redbook use?

Redbook is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Redbook use?

About 827 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.2k tokens, read only when the agent opens those files.

What are the alternatives to Redbook?

Skills that share tags, products or a category with Redbook: Xiaohongshu Cover (redfox-data/redfox-community, 427 stars), Agent Reach (Panniantong/Agent-Reach, 95k stars), Site Architecture (AvdLee/RocketSimApp, 806 stars) and Engine Whats New (flutter/flutter, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Redbook?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,441 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 11, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.