Xiaohongshu MCP Skill (with Python Client)
Automate content operations on Xiaohongshu (小红书) using a bundled Python script that interacts with the xpzouying/xiaohongshu-mcp server (8.4k+ stars).
Project: xpzouying/xiaohongshu-mcp
1. Local Server Setup
This skill requires the xiaohongshu-mcp server to be running on your local machine.
Step 1: Download Binaries
Download the appropriate binaries for your system from the GitHub Releases page.
| Platform | MCP Server | Login Tool |
|---|---|---|
| macOS (Apple Silicon) | xiaohongshu-mcp-darwin-arm64 | xiaohongshu-login-darwin-arm64 |
| macOS (Intel) | xiaohongshu-mcp-darwin-amd64 | xiaohongshu-login-darwin-amd64 |
| Windows | xiaohongshu-mcp-windows-amd64.exe | xiaohongshu-login-windows-amd64.exe |
| Linux | xiaohongshu-mcp-linux-amd64 | xiaohongshu-login-linux-amd64 |
Grant execute permission to the downloaded files:
chmod +x xiaohongshu-mcp-darwin-arm64 xiaohongshu-login-darwin-arm64
Step 2: Login (First Time Only)
Run the login tool. It will open a browser window with a QR code. Scan it with your Xiaohongshu mobile app.
./xiaohongshu-login-darwin-arm64
Important: Do not log into the same Xiaohongshu account on any other web browser, as this will invalidate the server's session.
Step 3: Start the MCP Server
Run the MCP server in a separate terminal window. It will run in the background.
# Run in headless mode (recommended)
./xiaohongshu-mcp-darwin-arm64
# Or, run with a visible browser for debugging
./xiaohongshu-mcp-darwin-arm64 -headless=false
The server will be available at http://localhost:18060.
2. Using the Skill
This skill includes a Python client (scripts/xhs_client.py) to interact with the local server. You can use it directly from the shell.
Available Commands
| Command | Description | Example |
|---|---|---|
status | Check login status | python scripts/xhs_client.py status |
search <keyword> | Search for notes | python scripts/xhs_client.py search "咖啡" |
detail <id> <token> | Get note details | python scripts/xhs_client.py detail "note_id" "xsec_token" |
feeds | Get recommended feed | python scripts/xhs_client.py feeds |
publish <title> <content> <images> | Publish a note | python scripts/xhs_client.py publish "Title" "Content" "url1,url2" |
Example Workflow: Market Research
-
Check Status: First, ensure the server is running and you are logged in.
python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py status -
Search for a Keyword: Find notes related to your research topic. The output will include the
feed_idandxsec_tokenneeded for the next step.python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py search "户外电源" -
Get Note Details: Use the
feed_idandxsec_tokenfrom the search results to get the full content and comments of a specific note.python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py detail "64f1a2b3c4d5e6f7a8b9c0d1" "security_token_here" -
Analyze: Review the note's content, comments, and engagement data to gather insights.