How do I install Rednote?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Rednote need an API key?

No required environment variable is listed on this record.

What transport does Rednote use?

Rednote runs locally over stdio.

When was Rednote last checked?

Last checked 2026-10-27. Xiaohongshu (rednote / 小红书 overseas) MCP server — let Claude Desktop, Cursor and any MCP client search, read, comment, like and publish notes. Node.js + Playwright, install via npx.

เซิร์ฟเวอร์ MCP Rednote

Power your agent

เพิ่มเซิร์ฟเวอร์นี้

Install from the publisher. Not a PlugMCP endpoint.

รันบน PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

รันบน PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

เปิด

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

rednote-mcp — Xiaohongshu (小红书 / REDNOTE) MCP server (Node.js)

繁體中文 | English

小紅書 / rednote / REDNOTE MCP server，讓 Claude Desktop、Cursor、Codex 等 MCP/AI agent 透過自然語言搜尋、瀏覽、留言、按讚與發布筆記。

本專案為 xpzouying/xiaohongshu-mcp（Go 版，目標中國站 xiaohongshu.com）的 Node.js + TypeScript + Playwright 海外版（rednote.com）port，可直接 npx 安裝使用，無需自行編譯。

關鍵字：xiaohongshu mcp · rednote mcp · 小红书 mcp · xiaohongshu-mcp · Claude Desktop · Cursor · AI agent · MCP server

功能

提供 13 個 MCP 工具：

Tool	說明
`check_login_status`	檢查登入狀態
`get_login_qrcode`	取得登入二維碼
`delete_cookies`	刪除 cookies 重置登入
`list_feeds`	取得首頁 feeds
`search_feeds`	搜尋筆記（含篩選）
`get_feed_detail`	取得筆記詳情 + 評論
`user_profile`	取得用戶主頁
`post_comment_to_feed`	發表評論
`reply_comment_in_feed`	回覆評論
`like_feed` / `favorite_feed`	點讚 / 收藏
`publish_content`	發佈圖文
`publish_with_video`	發佈視頻

同時提供 HTTP API（/api/v1/*）與 MCP Streamable HTTP（/mcp）。

安裝

方式 1：直接用 npx（推薦）

# stdio 模式 (給 MCP client)
npx -y @sykuang/rednote-mcp --stdio

# HTTP 模式
npx -y @sykuang/rednote-mcp --port :18060

# 查所有選項
npx -y @sykuang/rednote-mcp --help

首次執行會自動下載 Chromium（~170MB，一次性）。

Claude Desktop / Cursor 設定範例

{
  "mcpServers": {
    "rednote": {
      "command": "npx",
      "args": ["-y", "@sykuang/rednote-mcp", "--stdio"]
    }
  }
}

方式 2：全域安裝

npm install -g @sykuang/rednote-mcp
rednote-mcp --stdio

方式 3：從原始碼

git clone https://github.com/sykuang/rednote-mcp.git
cd rednote-mcp
npm install
npm run build
node dist/main.js --stdio

Hermes plugin

此倉庫提供 Hermes plugin，並內建具命名空間的 rednote:operations skill。

hermes plugins install sykuang/rednote-mcp --enable
hermes rednote setup

請開啟新的 Hermes session，並請 Hermes 載入 rednote:operations。

此 plugin 直接重用本套件的 MCP server，不會另外安裝第二份工具實作。

啟動

HTTP 模式（預設 :18060）：

npx @sykuang/rednote-mcp --port :18060
# 或從原始碼: node dist/main.js --port :18060

stdio 模式（給 Claude Desktop / Cursor 等 MCP client）：

npx @sykuang/rednote-mcp --stdio
# 或
MCP_STDIO=1 node dist/main.js

CLI flags：

--headless true/false（預設 true）
--bin /path/to/chromium（也可用 ROD_BROWSER_BIN env）
--port :18060
--stdio

環境變數：

MCP_STDIO=1 啟用 stdio
ROD_BROWSER_BIN 指定 Chromium 路徑
COOKIES_PATH 指定 cookies 檔路徑（預設先看 /tmp/cookies.json，否則 ./cookies.json）
XHS_PROXY HTTP/HTTPS 代理

開發

npm run dev          # tsx 直接跑
npm run build        # 編譯到 dist/
npm run format       # prettier
npm run lint         # tsc --noEmit

Docker

使用預編譯 image (GHCR)

# 直接 docker run
docker run -d --name rednote-mcp \
  -p 18060:18060 \
  -v $(pwd)/cookies.json:/app/cookies.json \
  --shm-size=1g \
  ghcr.io/sykuang/rednote-mcp:latest

docker compose

# 取得 cookies.json 後 (參考下方登入流程), 直接啟動
docker compose up -d
docker compose logs -f

docker-compose.yml 已包含：

使用 GHCR 預編譯 image (ghcr.io/sykuang/rednote-mcp:latest)
cookies.json 持久化 mount
shm_size: 1gb（瀏覽器子程序需要）

從原始碼 build

docker build -t rednote-mcp-node .
docker run -p 18060:18060 -v $(pwd)/cookies.json:/app/cookies.json rednote-mcp-node

與 Go 版本差異

本專案為 xpzouying/xiaohongshu-mcp（小紅書中國站，Go 實作）的海外版（REDNOTE）port：

目標站點不同：原版針對 xiaohongshu.com（中國站），本專案針對 rednote.com（海外站）
實作語言：Go → Node.js / TypeScript（方便 npx 安裝、跨平台無需編譯）
用 Playwright 取代 go-rod；XHR 攔截改用 page.on('response')，比 CDP 更簡單
HTTP 框架用 Fastify 取代 Gin
MCP 用官方 @modelcontextprotocol/sdk
業務邏輯、API 端點、MCP 工具 schema 與原版完全對齊

เพิ่มเซิร์ฟเวอร์นี้

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Rednote?

Does Rednote need an API key?

What transport does Rednote use?

When was Rednote last checked?

Documentation

rednote-mcp — Xiaohongshu (小红书 / REDNOTE) MCP server (Node.js)

功能

安裝

方式 1：直接用 npx（推薦）

Claude Desktop / Cursor 設定範例

方式 2：全域安裝

方式 3：從原始碼

Hermes plugin

啟動

開發

Docker

使用預編譯 image (GHCR)

docker compose

從原始碼 build

與 Go 版本差異