Xiaohongshu (小红书/RED) CLI — search, publish, engage, and analyze.
Install • Quick Start • Commands • Features • License
pip install redbook-cliOr from source:
git clone https://github.com/Youhai020616/xiaohongshu.git
cd xiaohongshu && bash setup.shTo use the REST API server (xhs api), install additional dependencies:
pip install redbook-cli[api]xhs init # Guided setup (first time)
xhs search "美食" # Search → results cached
xhs read 1 # Read 1st result (short index)
xhs like 1 # Like 1st result
xhs fav 2 # Favorite 2nd result
xhs comment 1 -c "好文!" # Comment on 1st result
xhs publish -t "标题" -c "内容" -i img.jpg # Publish image post- 🔍 Search — keyword search with sort/type/time filters, export to CSV/JSON
- 📝 Publish — image & video posts with tags, scheduling, visibility control
- 💬 Interact — like, favorite, comment, reply (short index support)
- 📊 Analytics — creator dashboard data export (CDP)
- 🔔 Notifications — mentions and interaction notifications
- 👤 Profile — user info and post listing
- 🔢 Short Index —
xhs search → xhs read 1 → xhs like 1 - 📦 Export —
xhs search "AI" -o results.csv - 🔐 Login — MCP QR scan + CDP browser login
- 👥 Multi-Account — isolated Chrome profiles per account
- 🏗️ Dual Engine — MCP server (fast) + CDP scripts (full features)
xhs search "关键词" # Basic search
xhs search "旅行" --sort 最多点赞 # Sort by likes
xhs search "穿搭" --type 图文 # Filter by type
xhs search "AI" -o results.csv # Export to CSV
xhs read 1 # Read by short index
xhs detail FEED_ID -t TOKEN # Read by ID + tokenxhs publish -t "标题" -c "正文" -i photo.jpg # Image post
xhs publish -t "标题" -c "正文" -v video.mp4 # Video post
xhs publish -t "标题" -c "正文" -i img.jpg --tags 旅行 --tags 美食 # With tags
xhs publish -t "测试" -c "内容" -i img.jpg --visibility 仅自己可见 # Private
xhs pub -t "标题" -c "正文" -i img.jpg --dry-run # Previewxhs like 1 # Like (short index)
xhs like FEED_ID -t TOKEN --unlike # Unlike
xhs fav 1 # Favorite
xhs comment 1 -c "写得好!" # Comment
xhs reply 1 --comment-id X --user-id Y -c "回复" # Replyxhs analytics # Creator dashboard
xhs analytics --csv data.csv # Export CSV
xhs notifications # Messages
xhs feeds # Recommendation feedxhs me # My info
xhs profile USER_ID -t TOKEN # User profilexhs login # MCP QR scan
xhs login --cdp # CDP browser login
xhs status # Login status
xhs server start # Start MCP server
xhs server stop # Stop MCP server
xhs account list # List accounts
xhs config show # Show config
xhs config set mcp.proxy http://... # Set proxy| Short | Command | Short | Command | |
|---|---|---|---|---|
xhs s |
search |
xhs r |
detail (read) |
|
xhs pub |
publish |
xhs fav |
favorite |
|
xhs cfg |
config |
xhs acc |
account |
|
xhs srv |
server |
xhs noti |
notifications |
| Engine | Used for | Technology |
|---|---|---|
| MCP Server | Publish, search, like, comment, profile | Go binary, JSON-RPC |
| CDP Scripts | Analytics, notifications, advanced search | Python, Chrome DevTools |
MCP is the primary engine (always-on daemon). CDP is used for features MCP doesn't support.
Unique features (vs competitors): video publish, scheduled publish, visibility control, analytics dashboard, multi-account isolation.
| Component | macOS ARM64 | macOS x86 | Linux | Windows |
|---|---|---|---|---|
| xhs CLI | ✅ | ✅ | ✅ | ✅ |
| MCP Server | ✅ | ❌ | ❌ | ❌ |
| CDP Scripts | ✅ | ✅ | ✅ | ✅ |
Non-ARM64 users: xhs init auto-detects missing MCP and switches to CDP-only mode.
| Project | Description |
|---|---|
| AgentMind | Self-learning memory system for AI agents |
| stealth-cli | Anti-detection browser CLI powered by Camoufox |
| stealth-x | Stealth X/Twitter automation |
| dy-cli | Douyin/TikTok CLI |
| freepost | AI social media management |