Xiaohongshu
Enables content creators to manage, analyze, and publish Xiaohongshu (Little Red Book) content through browser automation, with built-in templates, data analytics, and scheduling capabilities accessible via CLI or AI assistants.
What is Xiaohongshu?
Xiaohongshu is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables content creators to manage, analyze, and publish xiaohongshu (little red book) content through browser automation, with built-in templates, data analytics, and scheduling capabilities accessib...
Enables content creators to manage, analyze, and publish Xiaohongshu (Little Red Book) content through browser automation, with built-in templates, data analytics, and scheduling capabilities accessible via CLI or AI assistants.
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables content creators to manage, analyze, and publish Xia
Use Cases
Maintainer
Works with
Installation
NPM
npx -y xhs-mcpManual Installation
npx -y xhs-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Xiaohongshu
xhs-mcp is a browser-automation MCP server that lets AI assistants publish, search, and manage content on Xiaohongshu (Little Red Book) — China's leading lifestyle and content-sharing platform. It drives a headless Chromium browser under the hood, so it can perform actions that require a real logged-in session, including posting image and video notes, searching feeds, reading note details, and commenting. Content creators and social media managers use it to automate Xiaohongshu workflows from Claude or any other MCP-compatible assistant.
Prerequisites
- Node.js installed (LTS recommended) so npx is available
- Chromium browser installed via 'npx xhs-mcp browser' before first use
- A valid Xiaohongshu (Little Red Book) account to log in through the browser
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
Install browser dependencies
Run the browser install command to download and configure the Chromium instance that xhs-mcp will use for automation. This only needs to be done once.
npx xhs-mcp browser --with-depsLog in to Xiaohongshu
Launch the MCP server in interactive mode and authenticate with your Xiaohongshu account. The server will open a browser window where you can complete the login flow, including any SMS verification.
npx xhs-mcp mcpVerify authentication status
After logging in, ask your AI assistant to call the xhs_auth_status tool, or run a quick test to confirm the session is active before configuring your client permanently.
Configure your MCP client
Add xhs-mcp to your client's MCP server configuration. The server defaults to stdio transport, which works with all major clients.
Publish your first note
Ask your AI assistant to publish a note by providing a title, content, and one or more image paths or URLs. The server's xhs_publish_content tool supports up to 18 images and common video formats.
Xiaohongshu Examples
Client configuration
Add this block to your MCP client configuration file (e.g. .cursor/mcp.json for Cursor or claude_desktop_config.json for Claude Desktop).
{
"mcpServers": {
"xhs-mcp": {
"command": "npx",
"args": ["xhs-mcp", "mcp"],
"env": {
"XHS_ENABLE_LOGGING": "true"
}
}
}
}Prompts to try
Example prompts that use the xhs-mcp tools once connected and authenticated.
- "Search Xiaohongshu for trending posts about matcha recipes and summarize the top 5"
- "Get the full details of this Xiaohongshu note: [note URL]"
- "Publish a new note titled 'Morning Routine' with the images at /tmp/photo1.jpg and /tmp/photo2.jpg"
- "List my last 10 published notes and their engagement metrics"
- "Post a comment 'Love this!' on note [note ID]"Troubleshooting Xiaohongshu
Chromium fails to launch or crashes on startup
Re-run 'npx xhs-mcp browser --with-deps' to ensure all system-level browser dependencies are installed. On Linux servers, you may also need to install additional shared libraries (libgbm, libnss3, etc.).
Session expires and tools return authentication errors
Xiaohongshu sessions can time out. Run 'npx xhs-mcp mcp' interactively and use xhs_auth_login to re-authenticate. The session cookie is stored locally and reused by subsequent runs.
Image publish fails with an upload error
Verify that local image paths are absolute and that the files exist. Remote URLs are downloaded and cached automatically; ensure the URLs are publicly accessible. Supported formats include JPEG, PNG, and WebP.
Frequently Asked Questions about Xiaohongshu
What is Xiaohongshu?
Xiaohongshu is a Model Context Protocol (MCP) server that enables content creators to manage, analyze, and publish xiaohongshu (little red book) content through browser automation, with built-in templates, data analytics, and scheduling capabilities accessible via cli or ai assistants. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Xiaohongshu?
Install via npm with the command: npx -y xhs-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
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 license. You can use it freely in both personal and commercial projects.
Xiaohongshu Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Xiaohongshu? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
TopRank
★ 2.6kGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo 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.