Xiaohongshu
MCP for xiaohongshu.com
What is Xiaohongshu?
Xiaohongshu is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp for xiaohongshu.com
MCP for xiaohongshu.com
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP for xiaohongshu.com
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx xiaohongshuConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Xiaohongshu
The Xiaohongshu MCP server (xiaohongshu-mcp) enables AI assistants to interact with Xiaohongshu (Little Red Book, 小红书) — China's lifestyle and social commerce platform — through a local browser-automation proxy that handles authentication and content operations. It exposes tools for searching posts, reading feed details and comments, publishing image and video content, liking and favoriting posts, and accessing user profiles, all through natural language commands. Content creators, marketers, and researchers who work with Xiaohongshu can use it to automate posting, monitor engagement, and extract content insights.
Prerequisites
- A Xiaohongshu account (xiaohongshu.com) with an active login
- Go 1.21 or higher (for building from source) or Docker for the container-based setup
- An MCP-compatible client such as Claude Desktop or Claude Code
- A stable internet connection for browser automation (the server uses headless Chromium by default)
- Optional: an HTTP/HTTPS/SOCKS5 proxy if operating from outside China (set via XHS_PROXY)
Download the pre-built binary
Download the appropriate binary for your platform from the GitHub Releases page. Both a login tool and the MCP server binary are needed.
# Download from: https://github.com/xpzouying/xiaohongshu-mcp/releases
# Example for macOS ARM:
chmod +x xiaohongshu-login-darwin-arm64
chmod +x xiaohongshu-mcp-darwin-arm64Authenticate with your Xiaohongshu account
Run the login tool first to scan a QR code with your Xiaohongshu mobile app. This saves session cookies that the MCP server will reuse.
./xiaohongshu-login-darwin-arm64Start the MCP server
Launch the MCP server after successful login. By default it runs in headless mode. Use -headless=false for a visible browser window for debugging.
./xiaohongshu-mcp-darwin-arm64
# Or with visible browser:
./xiaohongshu-mcp-darwin-arm64 -headless=falseAlternatively, use Docker
For a simpler setup, use the Docker image. The compose file handles the browser environment automatically.
docker pull xpzouying/xiaohongshu-mcp
cd docker && docker compose up -dConfigure your MCP client
Add the server to your MCP client configuration using the HTTP transport mode, since the server exposes an HTTP endpoint at localhost:18060.
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcpVerify login status
Ask your AI assistant to check the login status using the check_login_status tool to confirm the session is active before performing other operations.
Xiaohongshu Examples
Client configuration
Add this to your claude_desktop_config.json to connect via HTTP transport. Optionally set XHS_PROXY if you need to route through a proxy.
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:18060/mcp",
"env": {
"XHS_PROXY": ""
}
}
}
}Prompts to try
Use these prompts with Claude after the Xiaohongshu MCP server is running and authenticated.
- "Search Xiaohongshu for posts about 'matcha latte recipes' and show me the top 5 results"
- "Get the details and comments for post ID [id]"
- "Post an image to Xiaohongshu with title 'Spring Vibes' and the image at /Users/me/photos/spring.jpg"
- "Check my current Xiaohongshu login status"
- "Show me the homepage feed recommendations on Xiaohongshu right now"Troubleshooting Xiaohongshu
Login QR code scan succeeds but the server still reports 'not logged in'
Ensure the login tool and the MCP server binary are from the same release version. The login tool writes cookies to a local file; verify it exists and is readable. If cookies have expired, re-run the login tool to refresh them.
publish_content fails or posts appear without images
Xiaohongshu requires image paths to avoid Chinese characters. Use ASCII-only file paths. Titles must be 20 characters or fewer and post body must not exceed 1,000 characters. Video uploads require additional processing time.
MCP client cannot connect to localhost:18060
Confirm the MCP server process is running (`ps aux | grep xiaohongshu-mcp`). Check that no firewall is blocking port 18060. If using Docker, verify the port is exposed in the compose file and that the container is healthy.
Frequently Asked Questions about Xiaohongshu
What is Xiaohongshu?
Xiaohongshu is a Model Context Protocol (MCP) server that mcp for xiaohongshu.com It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Xiaohongshu?
Follow the installation instructions on the Xiaohongshu GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Xiaohongshu?
Xiaohongshu works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Xiaohongshu free to use?
Yes, Xiaohongshu is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Xiaohongshu Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Xiaohongshu? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
XHS Downloader
★ 11.2k小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Xiaohongshu in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Xiaohongshu?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.