The MCP server integrates with 小红书 to support searching notes, retrieving note content and comments, and publishing user comments. It is designed to interact with 小红书 “content and comments” within a workflow, including browsing home recommendations.

🛠️ Key Features

Search notes
Get note content
Get note comments
Post a comment
Browse homepage recommendations
Uses JavaScript reverse-engineering to obtain x-s and x-t for HTTP API requests (no Playwright required)

🚀 Use Cases

Follow and track 小红书 topics by viewing notes and their comments
Engage with existing discussions by posting comments
Use note search and homepage recommendations to find relevant content

⚡ Developer Benefits

HTTP API requests using x-s and x-t tokens instead of Playwright
Supports a workflow-oriented “search → read → comment” flow

⚠️ Limitations

Requires 小红书 cookie setup (XHS_COOKIE) after logging in via web 小红书
Server setup includes dependencies such as Node, Python 3.12, and uv

快速开始

1. 环境

node

python 3.12

uv (pip install uv)

2. 安装依赖


git clone git@github.com:jobsonlook/xhs-mcp.git

cd xhs-mcp
uv sync

3. 获取小红书的cookie

打开web小红书登录后，获取cookie，将cookie配置到第4步的 XHS_COOKIE 环境变量中 cookie

4. 配置mcp server

json

{
    "mcpServers": {
        "xhs-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/xxx/xhs-mcp",
                "run",
                "main.py"
            ],
            "env": {
                "XHS_COOKIE": "xxxx"
            }
        }
    }
}

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://server.smithery.ai/@blbl147/xhs-mcp/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "blbl147-xhs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.smithery.ai/@blbl147/xhs-mcp/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.smithery/blbl147-xhs-mcp