Xpersona
Claim this agent
agentCLAWHUBUnverified

redbook

Search, read, analyze, and automate Xiaohongshu (小红书) content via CLI

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

3.1k

Updated

Oct 9, 2026

Version

0.8.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 3.1K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
3.1K downloadsadoption · observed Oct 9, 2026
Latest release
0.8.2release · observed Sep 12, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s178n5dtwwsjcmy1nhtkhtj4ph83m208:redbook
  1. Install using `clawhub skill install s178n5dtwwsjcmy1nhtkhtj4ph83m208:redbook` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/lucasygu/redbook before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lucasygu-redbook/snapshot"

Documentation

CLAWHUB

152,283 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
description: Search, read, analyze, and automate Xiaohongshu (小红书) content via CLI
allowed-tools: Bash, Read, Write, Glob, Grep
# OpenClaw / ClawHub metadata (clawhub install redbook)
name: redbook
version: 0.5.0
metadata:
  openclaw:
    requires:
      bins:
        - redbook
    install:
      - kind: node
        package: "@lucasygu/redbook"
        bins: [redbook]
    os: [macos]
    homepage: https://github.com/lucasygu/redbook
tags:
  - xiaohongshu
  - social-media
  - analytics
  - content-ops
---

# Redbook — Xiaohongshu CLI

Use the `redbook` CLI to search notes, read content, analyze creators, automate engagement, and research topics on Xiaohongshu (小红书/RED).

**OpenClaw users:** Install via `clawhub install redbook` or `npm install -g @lucasygu/redbook`.

> **⚠️ Research discipline (read this first).** XHS 风控 throttles *reading*, not just writing. Any research that reads more than a handful of notes MUST run through the **[Research Loop](#research-loop--rate-limit-safe-long-running-research)** — **human-paced by default** (~20 s/note, one at a time; a typical job finishes in tens of minutes, large ones spread across the day). Hammering `read` / `comments` / `analyze-viral` in a tight loop trips captcha / IP block (300012) within a few dozen hits and degrades the account for hours. ⚡ Fast mode is **emergency-only** and requires a printed warning + explicit user opt-in. Never fire reads in parallel or with zero delay.

## Usage

```
/redbook search "AI编程"              # Search notes
/redbook read <url>                   # Read a note
/redbook user <profileUrl>            # Creator profile
/redbook account-report --file ids.txt --json  # Batch account metrics
/redbook analyze <userId>             # Full creator analysis (profile + posts)
```

## Quick Reference

| Intent | Command |
|--------|---------|
| Search notes | `redbook search "keyword" --json` |
| Read a note | `redbook read <url> --json` |
| Get comments | `redbook comments <url> --json --all` |
| Creator profile | `redbook user <userId-or-profileUrl> --json` |
| Creator's posts | `redbook user-posts <userId-or-profileUrl> --json` |
| Batch account report | `redbook account-report --file accounts.txt --month YYYY-MM --json` |
| Browse feed | `redbook feed --json` |
| Search hashtags | `redbook topics "keyword" --json` |
| Analyze viral note | `redbook analyze-viral <url> --json` |
| Extract content template | `redbook viral-template <url1> <url2> --json` |
| Post a comment | `redbook comment <url> --content "text"` |
| Reply to comment | `redbook reply <url> --comment-id <id> --content "text"` |
| Batch reply (preview) | `redbook batch-reply <url> --strategy questions --dry-run` |
| Like a note | `redbook like <url>` |
| Unlike a note | `redbook like <url> --undo` |
| List favorites | `redbook favorites --json` or `redbook favorites <userId> --json` |
| Collect a note | `redbook collect <url>` |
| Remove from collection | `redbook uncollect <url>` |
| List followers | `red

README.md

# redbook — 小红书命令行工具

小红书 CLI 工具：搜索笔记、阅读内容、分析博主、发布图文。使用浏览器 Cookie 认证，无需 API Key。

[English](#english) | 中文

> ### 最快上手方式
>
> 把这段话发给你的 AI 助手（Claude Code、Cursor、Codex、Windsurf、OpenClaw 等）：
>
> **"帮我用 npm 安装 `@lucasygu/redbook` 这个小红书 CLI 工具，然后运行 `redbook whoami` 验证是否能正常连接。GitHub 地址：https://github.com/lucasygu/redbook"**
>
> OpenClaw 用户也可以直接：**`clawhub install redbook`**
>
> AI 会自动完成安装、验证连接、处理可能的 Cookie 问题。你只需要确保已在 Chrome 中登录 xiaohongshu.com。
>
> 安装完成后，试试：**"帮我分析'AI编程'这个话题在小红书上的竞争格局"** —— AI 会自动搜索关键词、分析互动数据、发现头部博主、给出内容建议。

## 安装

```bash
npm install -g @lucasygu/redbook
# 或通过 ClawHub（OpenClaw 生态）
clawhub install redbook
```

需要 Node.js >= 22。支持 **macOS、Windows、Linux**。使用 Chrome 浏览器的 Cookie —— 请先在 Chrome 中登录 xiaohongshu.com。

安装后运行 `redbook whoami` 验证连接。CLI 会自动检测所有 Chrome 配置文件，找到你的小红书登录状态。

- **macOS** —— 如果遇到钥匙串弹窗，请点击"始终允许"
- **Windows** —— Chrome 127+ 使用了 App-Bound Encryption，CLI 会自动启动 Chrome headless 模式读取 Cookie（需要先关闭 Chrome）。如果自动提取失败，可以用 `--cookie-string` 手动传入

## 能做什么

- **话题研究** —— 搜索关键词，分析哪些话题有流量、哪些是蓝海
- **竞品分析** —— 找到头部博主，对比粉丝量、互动数据、内容风格
- **爆款拆解** —— 分析爆款笔记的标题钩子、互动比例、评论主题
- **爆款模板** —— 从多篇爆款笔记提取内容模板（标题结构、正文结构、钩子模式）
- **限流检测** —— 检测笔记是否被隐形限流（通过创作者后台 API 的隐藏 level 字段）
- **收藏专辑** —— 查看收藏专辑内容，分析专辑内的笔记
- **收藏管理** —— 查看收藏列表、收藏/取消收藏笔记（支持自己和其他用户的公开收藏）
- **评论管理** —— 发评论、回复评论、按策略批量回复（问题优先 / 高赞优先 / 未回复优先）
- **图文卡片** —— Markdown 渲染为小红书风格的 PNG 图文卡片（7 种配色主题）
- **内容策划** —— 基于数据发现内容机会，生成有数据支撑的选题建议
- **受众洞察** —— 从互动信号推断目标用户画像

通过 AI 助手使用时，这些工作流可以自动串联完成。直接使用 CLI 时，每个命令也可以独立运行。

## 快速开始

```bash
# 检查连接
redbook whoami

# 搜索笔记
redbook search "AI编程" --sort popular

# 阅读笔记
redbook read https://www.xiaohongshu.com/explore/abc123

# 获取评论
redbook comments https://www.xiaohongshu.com/explore/abc123 --all

# 浏览推荐页
redbook feed

# 查看博主信息
redbook user "<profileUrl>"
redbook user-posts "<profileUrl>"
redbook account-report --file kos-accounts.txt --month 2026-07 --json

# 搜索话题标签
redbook topics "Claude Code"

# 查看收藏（默认当前用户）
redbook favorites --json
redbook favorites <userId> --json --all

# 收藏/取消收藏
redbook collect "<noteUrl>"
redbook uncollect "<noteUrl>"

# 分析爆款笔记
redbook analyze-viral https://www.xiaohongshu.com/explore/abc123

# 从多篇爆款提取内容模板
redbook viral-template "<url1>" "<url2>" "<url3>" --json

# 发评论
redbook comment "<noteUrl>" --content "写得好！"

# 回复评论
redbook reply "<noteUrl>" --comment-id "<id>" --content "感谢提问！"

# 按策略批量回复（先预览再执行）
redbook batch-reply "<noteUrl>" --strategy questions --dry-run
redbook batch-reply "<noteUrl>" --strategy questions --template "感谢！{content}" --max 10

# 查看收藏专辑
redbook boards                          # 列出自己的专辑
redbook boards <userId>                 # 列出他人的专辑
redbook board "https://www.xiaohongshu.com/board/abc123"
redbook board abc123 --json

# 检测笔记限流状态
redbook health
redbook health --all --json

# 将 Markdown 渲染为图文卡片（需要可选依赖）
redbook render content.md --style xiaohongshu
redbook render content.md --style dark --output-dir ./cards

# 发布图文笔记
redbook post --title "标题" --body "正文内容" --images cover.png
redbook post --title "测试" --body "..." -

_meta.json

{
  "ownerId": "kn7609awkk9yh67wv7fmgtvkxn7zzm6q",
  "slug": "redbook",
  "version": "0.8.2",
  "publishedAt": 1789236488283
}

CLAUDE.md

# CLAUDE.md — redbook CLI

## Publishing

**NEVER publish npm packages directly from local.** Always use the `npm-publish-cli` agent to bump version and publish via CI. The GitHub Actions workflow (`Publish to npm`) handles publishing on push to main. Publishing locally races CI and causes workflow failures.

**Dual publishing (automated):**
- **npm** — publishes when `package.json` version changes on push to main
- **ClawHub** — publishes when `SKILL.md` changes on push to main (uses `CLAWHUB_TOKEN` secret)

Both are conditional jobs in `.github/workflows/npm-publish.yml`. Manual trigger via `workflow_dispatch` is also available.

## Build & Test

- `npm run build` — TypeScript compile + chmod
- No test suite yet — verify manually with `redbook whoami`

## Project Structure

- `src/cli.ts` — CLI entry point, 21 commands, `getClient()` is the single cookie→client funnel
- `src/lib/client.ts` — XHS API client (`postComment`, `replyComment`, etc.)
- `src/lib/cookies.ts` — Cookie extraction with Chrome profile auto-discovery
- `src/lib/signing.ts` — Request signing
- `src/lib/analyze.ts` — Viral note analysis and question detection
- `src/lib/reply-strategy.ts` — Batch reply filtering, templating, rate-limited execution
- `src/lib/template.ts` — Viral content template extraction
- `src/lib/health.ts` — Note health check: level detection, sensitive words, tag count
- `src/lib/render.ts` — Card rendering (markdown → PNG via puppeteer-core, optional dep)
- `SKILL.md` — Skill documentation (serves both Claude Code and OpenClaw/ClawHub)
- `.github/workflows/npm-publish.yml` — CI: build, npm publish, ClawHub publish

## Render Command (Optional)

- `redbook render <file>` — markdown → styled PNG cards using user's existing Chrome
- Requires `puppeteer-core` and `marked` (optional peer deps, lazy imported)
- Uses Chrome at `/Applications/Google Chrome.app/...` or `CHROME_PATH` env var
- No cookies/XHS API needed — purely offline
- HTML/CSS templates embedded as TypeScript template literals (no external files)

## Cookie Architecture

- Uses `@steipete/sweet-cookie` to read browser cookies
- Auto-discovers Chrome profiles via `~/Library/Application Support/Google/Chrome/Local State`
- Keychain timeout patched to 30s in node_modules (upstream bug: hardcoded 3s)
- `--chrome-profile` flag available as escape hatch, but auto-discovery handles most cases

docs/content-language-strategy.md

# Content Language Strategy: English First

**Decided**: 2026-03-22
**Source**: [@Jiaxi_Cui tweet](https://x.com/Jiaxi_Cui/status/2035415033149264083)

---

## Decision

**Use English for X and LinkedIn. Do not build a Chinese X account.**

This resolves the long-running struggle over language choice.

---

## Reasoning (from @Jiaxi_Cui / Panda)

Chinese X is drifting toward an early Weibo atmosphere — flooded with marketing accounts. Too much noise, diminishing signal.

English X and LinkedIn have better conversion and are worth sustained effort.

XHS is different — high community quality, very vertical. But treat it separately:
- **Personal brand account** (high quality, curated): worth building
- **Customer acquisition / promotional accounts**: different strategy entirely

---

## Platform Strategy Summary

| Platform | Language | Strategy |
|----------|----------|---------|
| X / Twitter | **English** | Main personal brand channel |
| LinkedIn | **English** | Professional + longer-form |
| XHS (小红书) | Chinese | Separate vertical communities — high quality personal account |
| YouTube | TBD | Likely English-first |

---

## Implications for Redbook CLI

The `redbook` tool is still valuable for:
- XHS content creation and posting
- XHS community research and engagement
- Monitoring Chinese-language conversations about products/topics

XHS is a distinct channel with different rules — not "Chinese version of X" but its own high-quality vertical community platform.

---

## Previous Struggle (Resolved)

The prior back-and-forth about "中文还是英文" is now settled:
- Building a Chinese X account → **not worth it**
- Building English X + LinkedIn → **do this**
- XHS → **yes, but as its own track**

---

*Saved: 2026-03-22*

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/lucasygu/skills/redbook",
      "sourceUrl": "https://clawhub.ai/lucasygu/skills/redbook",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:37:07.683Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lucasygu-redbook/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lucasygu-redbook/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:37:07.683Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "3.1K downloads",
      "href": "https://clawhub.ai/lucasygu/redbook",
      "sourceUrl": "https://clawhub.ai/lucasygu/redbook",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:37:07.683Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.8.2",
      "href": "https://clawhub.ai/lucasygu/redbook",
      "sourceUrl": "https://clawhub.ai/lucasygu/redbook",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-12T18:08:08.283Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lucasygu-redbook/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lucasygu-redbook/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.8.2",
      "description": "redbook v0.8.2 - Added social-preview.png for improved sharing and visual identity. - Updated dependencies in package.json and package-lock.json. - Improved CLI and library logic in src/cli.ts, src/lib/client.ts, and src/lib/signing.ts. - Refined documentation in README.md and SKILL.md. - Removed obsolete skill-card.md.",
      "href": "https://clawhub.ai/lucasygu/redbook",
      "sourceUrl": "https://clawhub.ai/lucasygu/redbook",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-12T18:08:08.283Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to redbook and adjacent AI workflows.