xiaohongshu-mcp

The first step is required - RedNote needs to be logged in. You can check current login status.

Login Demo:

https://github.com/user-attachments/assets/8b05eb42-d437-41b7-9235-e2143f19e8b7

Check Login Status Demo:

https://github.com/user-attachments/assets/bd9a9a4a-58cb-4421-b8f3-015f703ce1f9

Supports publishing image and text content to RedNote, including title, content description, and images.

Image Support Methods:

Supports two image input methods:

1. HTTP/HTTPS Image Links

   ["https://example.com/image1.jpg", "https://example.com/image2.png"]
   

2. Local Image Absolute Paths (Recommended)

   ["/Users/username/Pictures/image1.jpg", "/home/user/images/image2.png"]
   

Why Local Paths are Recommended:

• ✅ Better stability, not dependent on network
• ✅ Faster upload speed
• ✅ Avoid image link expiration issues
• ✅ Support more image formats

Publish Image-Text Post Demo:

https://github.com/user-attachments/assets/8aee0814-eb96-40af-b871-e66e6bbb6b06

Supports publishing video content to RedNote, including title, content description, and local video files.

Video Support Methods:

Only supports local video file absolute paths:

"/Users/username/Videos/video.mp4"

Features:

• ✅ Supports local video file upload
• ✅ Automatic video format processing
• ✅ Supports title, content description, and tags
• ✅ Automatically publishes after video processing is complete

Important Notes:

• Only supports local video files, not HTTP links
• Video processing takes longer, please be patient
• Recommended video file size should not exceed 1GB

Search RedNote content by keywords.

Search Posts Demo:

https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3

Get RedNote homepage recommendation content list.

Get Recommendation List Demo:

https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28

Get complete details of RedNote posts, including:

• Post content (title, description, images, etc.)
• User information
• Interaction data (likes, favorites, shares, comment count)
• Comment list and sub-comments

⚠️ Important Note:

• Both post ID and xsec_token are required (both parameters are essential)
• These two parameters can be obtained from Feed list or search results
• Must login first to use this feature

Get Post Details Demo:

https://github.com/user-attachments/assets/76a26130-a216-4371-a6b3-937b8fda092a

Supports automatically posting comments to RedNote posts.

Feature Description:

• Automatically locate comment input box
• Input comment content and publish
• Supports HTTP API and MCP tool calls

⚠️ Important Note:

• Must login first to use this feature
• Need to provide post ID, xsec_token, and comment content
• These parameters can be obtained from Feed list or search results

Post Comment Demo:

https://github.com/user-attachments/assets/cc385b6c-422c-489b-a5fc-63e92c695b80

Get RedNote user's personal profile information, including basic user information and note content.

Feature Description:

• Get user basic information (nickname, bio, avatar, etc.)
• Get follower count, following count, likes count statistics
• Get user's published note content list
• Supports HTTP API and MCP tool calls

⚠️ Important Note:

• Must login first to use this feature
• Need to provide user ID and xsec_token
• These parameters can be obtained from Feed list or search results

Returned Information Includes:

• User basic info: nickname, bio, avatar, verification status
• Statistics: following count, follower count, likes count, note count
• Note list: all public notes published by the user

Requires Golang environment. For installation instructions, please refer to Golang Official Documentation.

Set Go domestic proxy source:

# Configure GOPROXY environment variable, choose one of the following three

# 1. Qiniu CDN
go env -w  GOPROXY=https://goproxy.cn,direct

# 2. Alibaba Cloud
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

# 3. Official
go env -w  GOPROXY=https://goproxy.io,direct

Using Docker deployment is the simplest method, requiring no development environment installation.

1. Pull Image from Docker Hub (Recommended)

We provide pre-built Docker images that can be directly pulled from Docker Hub:

# Pull the latest image
docker pull xpzouying/xiaohongshu-mcp

Docker Hub URL: https://hub.docker.com/r/xpzouying/xiaohongshu-mcp

2. Start with Docker Compose (Recommended)

We provide a pre-configured docker-compose.yml file that can be used directly:

# Download docker-compose.yml
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml

# Or if you've already cloned the project, enter the docker directory
cd docker

# Start service
docker compose up -d

# View logs
docker compose logs -f

# Stop service
docker compose stop

3. Build Image Yourself (Optional)

If you need to customize or modify the code, you can build the image yourself:

# Run in project root directory
docker build -t xpzouying/xiaohongshu-mcp .

4. Configuration Notes

The Docker version automatically:

• Configures Chrome browser and Chinese fonts
• Mounts ./data for storing cookies
• Mounts ./images for storing publish images
• Exposes port 18060 for MCP connection

For detailed instructions, please refer to: Docker Deployment Guide

Official command line tool, already shown in the quick start section above:

# Add HTTP MCP server
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

Create or edit MCP configuration file:

Project-level configuration (recommended): Create .cursor/mcp.json in project root directory:

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "RedNote content publishing service - MCP Streamable HTTP"
    }
  }
}

Global configuration: Create ~/.cursor/mcp.json in user directory (same content).

1. Ensure RedNote MCP service is running
2. Save configuration file and restart Cursor
3. In Cursor chat, tools should be automatically available
4. You can view connected MCP tools through "Available Tools" in the chat interface

Demo

Plugin MCP integration:

Call MCP tools: (using check login status as example)

1. Press Ctrl/Cmd + Shift + P to open command palette
2. Run MCP: Add Server command
3. Select HTTP method.
4. Enter address: http://localhost:18060/mcp, or modify to corresponding Server address.
5. Enter MCP name: xiaohongshu-mcp.

Workspace configuration (recommended): Create .vscode/mcp.json in project root directory:

{
  "servers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

View Configuration:

1. Confirm running status.
2. Check if tools are correctly detected.

Demo

Using search post content as example:

Configure in ~/.gemini/settings.json or project directory .gemini/settings.json:

{
  "mcpServers": {
    "xiaohongshu": {
      "httpUrl": "http://localhost:18060/mcp",
      "timeout": 30000
    }
  }
}

For more information, please refer to Gemini CLI MCP Documentation

Debug tool for testing MCP connections:

# Start MCP Inspector
npx @modelcontextprotocol/inspector

# Connect in browser to: http://localhost:18060/mcp

Usage steps:

• Use MCP Inspector to test connection
• Test Ping Server functionality to verify connection
• Check if List Tools returns 6 tools

Cline is a powerful AI programming assistant that supports MCP protocol integration.

Add the following configuration to Cline's MCP settings:

{
  "xiaohongshu-mcp": {
    "url": "http://localhost:18060/mcp",
    "type": "streamableHttp",
    "autoApprove": [],
    "disabled": false
  }
}

1. Ensure RedNote MCP service is running (http://localhost:18060/mcp)
2. Open MCP settings in Cline
3. Add the above configuration to the MCP server list
4. Save configuration and restart Cline
5. You can directly use RedNote-related features in conversations

• url: MCP service address
• type: Use streamableHttp type for better performance
• autoApprove: Configurable auto-approve tool list (empty means manual approval)
• disabled: Set to false to enable this MCP service

After configuration, you can use natural language to operate RedNote directly in Cline:

Help me check RedNote login status

Help me publish a spring-themed image-text post to RedNote, using this image: /path/to/spring.jpg

Search for content about "food" on RedNote

Any client supporting HTTP MCP protocol can connect to: http://localhost:18060/mcp

Basic configuration template:

{
  "name": "xiaohongshu-mcp",
  "url": "http://localhost:18060/mcp",
  "type": "http"
}