Xiaohongshu (Little Red Book) MCP Server

xiaohongshu-mcp-server

一个适用于 小红书（中国领先的生活方式社交媒体平台）的 Model Context Protocol（MCP） 服务。

通过 MCP 工具发布图片笔记、搜索内容、查看笔记详情并管理账号，AI 助手可以直接使用这些工具。

工作原理

使用 Playwright 运行无头 Chromium 浏览器，以便：

1. 加载你的 XHS 会话 Cookie
2. 通过 XHS Web 应用内置的签名函数生成真实的 API 签名
3. 通过浏览器的网络上下文调用 API（绕过反机器人检测）
4. 将图片直接上传到 XHS CDN

不自动化操作浏览器界面元素——所有交互都通过 XHS 的内部 API 完成。

工具

工具	说明
check_login_status	检查你是否已登录
get_login_qrcode	生成登录二维码
check_qrcode_status	轮询二维码扫描状态并保存会话
reload_cookies	从磁盘重新加载 Cookie
publish_content	发布包含标题、正文、图片和标签的图片笔记
search_feeds	按关键词搜索 XHS 笔记
get_feed_detail	获取笔记的完整详情
user_profile	获取用户个人资料信息

安装

pip install xiaohongshu-mcp-server
playwright install chromium

如需生成二维码图片（可选）：

pip install "xiaohongshu-mcp[qrcode]"

快速开始

1. 启动服务

HTTP 模式（用于 Claude Code、Cursor 等）：

xhs-mcp --transport http --port 18060

stdio 模式（用于 Claude Desktop）：

xhs-mcp --transport stdio

2. 登录

调用 get_login_qrcode 工具，使用小红书应用扫描二维码，然后使用返回的 qr_id 和 code 调用 check_qrcode_status。Cookie 会保存到 ~/.xhs-mcp/cookies.json，并在重启后保留。

3. 使用

让 AI 助手发布笔记、搜索内容等。

配置

Claude Desktop

添加到 ~/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

然后启动服务：xhs-mcp

作为 LaunchAgent（macOS 自动启动）

创建 ~/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

示例：发布笔记

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

要求

• Python 3.12+
• Chromium（通过 playwright install chromium 安装）
• 小红书账号

许可证

MIT