How do I install the Xiaohongshu MCP skill?

Run npx skillmds@latest add joneqian/xiaohongshu-mcp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Xiaohongshu MCP safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xiaohongshu MCP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Xiaohongshu MCP free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Xiaohongshu MCP?

joneqian (@joneqian) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xiaohongshu MCP by joneqian — Agent Skill

Name: Xiaohongshu MCP
Author: joneqian

Xiaohongshu MCP

Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server. Use for: (1) Publishing image, text, and video content, (2) Searching for notes and trends, (3) Analyzing post details and comments, (4) Managing user profiles and content feeds. Triggers: xiaohongshu automation, rednote content, publish to xiaohongshu, xiaohongshu search, social media management.

joneqian Updated Sep 17, 2026

File contents

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_id and xsec_token needed for the next step.
```
python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py search "户外电源"
```
Get Note Details: Use the feed_id and xsec_token from 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.

---name: xiaohongshu-mcpdescription: Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server. Use for: (1) Publishing image, text, and video content, (2) Searching for notes and trends, (3) Analyzing post details and comments, (4) Managing user profiles and content feeds. Triggers: xiaohongshu automation, rednote content, publish to xiaohongshu, xiaohongshu search, social media management.---# 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](https://github.com/xpzouying/xiaohongshu-mcp)## 1. Local Server SetupThis skill requires the `xiaohongshu-mcp` server to be running on your local machine.### Step 1: Download BinariesDownload the appropriate binaries for your system from the [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/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:```shellchmod +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.```shell./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 ServerRun the MCP server in a separate terminal window. It will run in the background.```shell# 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 SkillThis 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 Research1. **Check Status**: First, ensure the server is running and you are logged in. ```shell python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py status ```2. **Search for a Keyword**: Find notes related to your research topic. The output will include the `feed_id` and `xsec_token` needed for the next step. ```shell python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py search "户外电源" ```3. **Get Note Details**: Use the `feed_id` and `xsec_token` from the search results to get the full content and comments of a specific note. ```shell python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py detail "64f1a2b3c4d5e6f7a8b9c0d1" "security_token_here" ```4. **Analyze**: Review the note's content, comments, and engagement data to gather insights.

Frequently asked questions