redbook

` /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) `

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 — 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.

| 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 | redbook followers <userId> --json | | List following | redbook following <userId> --json | | Delete own note | redbook delete <url> | | Check note health | redbook health --json or redbook health --all --json | | List user boards | redbook boards or redbook boards <userId> --json | | List album notes | redbook board <board-url> or redbook board <boardId> --json | | Render markdown to cards | redbook render content.md --style xiaohongshu | | Publish image note | redbook post --title "..." --body "..." --images img.jpg | | Check connection | redbook whoami | | Save cookies for cloud/OpenClaw | redbook auth export or redbook auth save --cookie-string "a1=...; web_session=..." | Always add --json when parsing output programmatically. Without it, output is human-formatted text. ---

XHS is not Twitter or Instagram. These platform-specific engagement ratios reveal content type and audience behavior.