Xiaohongshu (XHS) CLI

Prerequisites

1. Install dependencies:

   pip install -r requirements.txt && playwright install chromium

2. Log in for the first use:

   python xhs.py login

   (a browser will open, scan the QR code manually)

python skills/xhs-cli/xhs.py me

Trigger Conditions

• Users want to search Xiaohongshu content
• Users want to view details or comments of a note
• Users want to learn about a Xiaohongshu user's homepage
• Users want to check their own account data
• Users want to publish image-text notes

Search Notes

python skills/xhs-cli/xhs.py search "keywords"
python skills/xhs-cli/xhs.py search "keywords" --sort time     # Sort by time
python skills/xhs-cli/xhs.py search "keywords" --type video    # Search only videos

Note Details and Comments

python skills/xhs-cli/xhs.py detail <note_id> <xsec_token>    # Note details
python skills/xhs-cli/xhs.py comments <note_id> <xsec_token>  # Comment list
python skills/xhs-cli/xhs.py note <note_id> <xsec_token>      # Details + comments

User Information

python skills/xhs-cli/xhs.py me                     # Currently logged-in user
python skills/xhs-cli/xhs.py user <user_id>          # View user homepage
python skills/xhs-cli/xhs.py unread                  # Unread notifications

Account Data

python skills/xhs-cli/xhs.py stats                   # Overview of all post data
python skills/xhs-cli/xhs.py stats --detail           # Include details of each post

account_name

search_keyword

Publish Notes

python skills/xhs-cli/xhs_publish.py login                                      # Creator Center login
python skills/xhs-cli/xhs_publish.py publish --draft draft.md --images a.jpg b.jpg  # Publish
python skills/xhs-cli/xhs_publish.py publish --draft draft.md --images a.jpg --auto # Skip confirmation

## Title
Post title

## Body
Body content...

## Hashtags
#tag1 #tag2 #tag3

Typical Workflows

"Help me search for content about XX on Xiaohongshu"

1. search "XX"

   to search
2. Use

   note <id> <token>

   for interesting notes to view details + comments
3. Summarize and return

"How is my account data?"

1. stats --detail

   to get all post data
2. Analyze trends and give suggestions

"Help me analyze this competitor account"

1. user <user_id>

   to get homepage information
2. Search for the user's posts
3. Use

   comments

   on popular posts to check comment feedback

Notes

• Must

  login

  and scan the QR code for the first use, cookies are saved in

  data/xhs_cookie.txt

• Xiaohongshu has anti-crawling mechanisms, high-frequency requests may trigger verification codes, it is recommended to leave intervals between operations
• The

  xsec_token

  in search results has a validity period, re-search if it expires
• Newly posted notes may appear in search results after a few hours
• The publishing function requires additional login to the Creator Center:

  xhs_publish.py login