Skip to main content
Glama
Youhai020616

xiaohongshu-skill

by Youhai020616
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Local

Install

pip install redbook-cli

Or from source:

git clone https://github.com/Youhai020616/xiaohongshu.git
cd xiaohongshu && bash setup.sh

Optional: API Server

To use the REST API server (xhs api), install additional dependencies:

pip install redbook-cli[api]

Related MCP server: xiaohongshu-mcp-py

Quick Start

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

Features

  • 🔍 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)

Commands

Search & Read

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 + token

Publish

xhs 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                    # Preview

Interact

xhs 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 "回复"  # Reply

Analytics & Feed

xhs analytics                            # Creator dashboard
xhs analytics --csv data.csv             # Export CSV
xhs notifications                        # Messages
xhs feeds                                # Recommendation feed

Profile

xhs me                                   # My info
xhs profile USER_ID -t TOKEN             # User profile

Account & Config

xhs 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

Aliases

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

Architecture

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.

Platform Support

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.

License

MIT

🔗 Ecosystem

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

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • rednote-analyzer-mcp

    ShellyDeng08
    A
    license
    A
    quality
    D
    maintenance
    MCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.
    6
    9
    MIT

  • xhs-mcp

    xyj2570
    A
    license
    A
    quality
    D
    maintenance
    A lightweight MCP server that provides read-only access to Xiaohongshu (Little Red Book) data, enabling search, note details, user profiles, and trending feeds via direct HTTP APIs.
    5
    14
    1
    MIT

  • mcp-xhs-publisher

    noveldig
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for automatically publishing text, image, and video notes to Xiaohongshu (Little Red Book).
    1
    MIT