English Français العربية

Xiaohongshu (Little Red Book) MCP Server

Registre officiel Recherche et web

Publish, search, and manage Xiaohongshu (Little Red Book) content via MCP tools.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package xiaohongshu-mcp-server
Claude Code 
claude mcp add xiaohongshu-little-red-book-mcp-server -- uvx xiaohongshu-mcp-server==0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xiaohongshu-little-red-book-mcp-server": {
            "command": "uvx",
            "args": [
                "xiaohongshu-mcp-server==0.1.1"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. xiaohongshu-mcp-server
  2. How It Works
  3. Tools
  4. Installation
  5. Quick Start
  6. Configuration
  7. Example: Publish a Note
  8. Requirements
  9. License

xiaohongshu-mcp-server

A Model Context Protocol (MCP) server for Xiaohongshu (Little Red Book) - China's leading lifestyle social media platform.

Publish image notes, search content, view note details, and manage your account - all through MCP tools that AI assistants can use directly.

How It Works

Uses Playwright to run a headless Chromium browser that:

  1. Loads your XHS session cookies
  2. Generates authentic API signatures via the XHS web app's built-in signing function
  3. Makes API calls through the browser's network context (bypasses anti-bot detection)
  4. Uploads images directly to XHS CDN

No browser automation of UI elements - all interactions go through XHS's internal API.

Tools

ToolDescription
check_login_statusCheck if you're logged in
get_login_qrcodeGenerate QR code for login
check_qrcode_statusPoll QR scan status & save session
reload_cookiesReload cookies from disk
publish_contentPublish an image note with title, text, images, and tags
search_feedsSearch XHS notes by keyword
get_feed_detailGet full details of a note
user_profileGet user profile information

Installation

pip install xiaohongshu-mcp-server
playwright install chromium

For QR code image generation (optional):

pip install "xiaohongshu-mcp[qrcode]"

Quick Start

1. Start the server

HTTP mode (for Claude Code, Cursor, etc.):

xhs-mcp --transport http --port 18060

stdio mode (for Claude Desktop):

xhs-mcp --transport stdio
2. Login

Call the get_login_qrcode tool, scan the QR code with the Xiaohongshu app, then call check_qrcode_status with the returned qr_id and code. Cookies are saved to ~/.xhs-mcp/cookies.json and persist across restarts.

3. Use

Ask your AI assistant to publish a note, search for content, etc.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "xhs-mcp": {
      "command": "xhs-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}
Claude Code
claude mcp add xhs-mcp --transport http http://localhost:18060/mcp

Then start the server: xhs-mcp

As a LaunchAgent (macOS auto-start)

Create ~/Library/LaunchAgents/com.xhs-mcp.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.xhs-mcp</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/your/venv/bin/xhs-mcp</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/xhs-mcp.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/xhs-mcp.err</string>
</dict>
</plist>
launchctl load ~/Library/LaunchAgents/com.xhs-mcp.plist

Example: Publish a Note

# Via MCP tool call
publish_content(
    title="Hello XHS!",
    content="My first post published via MCP.",
    images=["/path/to/photo.jpg"],
    tags=["MCP", "AI"]
)

Requirements

  • Python 3.12+
  • Chromium (installed via playwright install chromium)
  • A Xiaohongshu account

License

MIT

Questions fréquentes

Qu'est-ce que Xiaohongshu (Little Red Book) MCP Server ?

Publish, search, and manage Xiaohongshu (Little Red Book) content via MCP tools.

Comment installer Xiaohongshu (Little Red Book) MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add xiaohongshu-little-red-book-mcp-server -- uvx xiaohongshu-mcp-server==0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Xiaohongshu (Little Red Book) MCP Server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Xiaohongshu (Little Red Book) MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Xiaohongshu (Little Red Book) MCP Server ?

Il est publié par shanyang-me. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.