/ Directory / Playground / xiaohongshu-mcp
← All servers ↗ GitHub
● Community xpzouying ⚡ Instant

xiaohongshu-mcp

by xpzouying · xpzouying/xiaohongshu-mcp

AI-powered Xiaohongshu (Little Red Book) integration — publish, search, engage, and manage content on China's top social commerce platform.

xiaohongshu-mcp is an MCP server enabling AI assistants to interact with Xiaohongshu (Little Red Book), China's popular social media and commerce platform. It provides 13 tools for content publishing (image-text and video), feed discovery, search, post interaction (like, comment, favorite), user profiles, and QR-code authentication. Available as pre-built binaries, from source (Go), or via Docker.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

xiaohongshu-mcp.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "xiaohongshu-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "xiaohongshu-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/xpzouying/xiaohongshu-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add xiaohongshu-mcp -- TODO 'See README: https://github.com/xpzouying/xiaohongshu-mcp'

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use xiaohongshu-mcp

How to publish content to Xiaohongshu with AI assistance

👤 Content creators and brands publishing on Xiaohongshu ⏱ ~10 min beginner

When to use: You want to publish posts to Xiaohongshu without using the mobile app.

Prerequisites
  • xiaohongshu-mcp running — Download binary from releases or docker run
  • Xiaohongshu account authenticated — Use get_login_qrcode to scan and authenticate
Flow
  1. Authenticate
    Log into Xiaohongshu. Generate a QR code for me to scan.✓ Copied
    → QR code displayed for mobile scanning
  2. Publish a post
    Publish a post about my coffee shop visit with these 3 photos. Title: '隐藏在街角的宝藏咖啡店'. Add hashtags #咖啡 #探店.✓ Copied
    → Post published confirmation with link

Outcome: Content published to Xiaohongshu with images and hashtags.

Pitfalls
  • Content moderation may reject posts — Xiaohongshu has strict content policies. Avoid promotional language and follow community guidelines.
Combine with: filesystem

Combinations

Pair with other MCPs for X10 leverage

xiaohongshu-mcp + filesystem

Batch prepare posts locally and publish them to Xiaohongshu

Read my prepared posts from ~/content/xhs/ and publish them one by one with appropriate hashtags.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
get_login_qrcode none Get QR code for authentication 0
check_login_status none Verify authentication status 0
publish_content title: str, description: str, images: str[], hashtags?: str[] Publish an image-text post 0
publish_with_video title: str, description: str, video: str Publish a video post 0
search_feeds keyword: str, filters? Search for content by keyword 0
get_feed_detail feed_id: str Get post details with comments 0
post_comment_to_feed feed_id: str, content: str Comment on a post 0
like_feed feed_id: str Like or unlike a post 0
user_profile user_id: str Get a user's profile information 0

Cost & Limits

What this costs to run

API quota
Subject to Xiaohongshu's internal rate limits
Tokens per call
200–1000 tokens per tool call
Monetary
Free
Tip
Search before publishing to understand what performs well in your niche.

Security

Permissions, secrets, blast radius

Credential storage: Session cookies stored locally after QR authentication
Data egress: Calls to Xiaohongshu's internal API endpoints

Troubleshooting

Common errors and fixes

QR code login fails

Ensure you scan the QR code with the Xiaohongshu mobile app within the timeout period. Try generating a new code.

Verify: check_login_status after scanning
Session expired

Re-authenticate by generating a new QR code and scanning again.

Verify: check_login_status
Post rejected by content moderation

Xiaohongshu has strict content policies. Review your content for promotional language, sensitive topics, or policy violations.

Verify: Check Xiaohongshu's content guidelines

Alternatives

xiaohongshu-mcp vs others

AlternativeWhen to use it insteadTradeoff
Manual posting via Xiaohongshu appYou want guaranteed ToS complianceManual but no risk of account restrictions

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills