rednote-mcp — Xiaohongshu (小红书 / REDNOTE) MCP server (Node.js)
繁體中文 | English
小紅書 / rednote / REDNOTE MCP server,讓 Claude Desktop、Cursor、Codex 等 MCP/AI agent 透過自然語言搜尋、瀏覽、留言、按讚與發布筆記。
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
繁體中文 | English
小紅書 / rednote / REDNOTE MCP server,讓 Claude Desktop、Cursor、Codex 等 MCP/AI agent 透過自然語言搜尋、瀏覽、留言、按讚與發布筆記。
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.
本專案為 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 工具:
同時提供 HTTP API(/api/v1/*)與 MCP Streamable HTTP(/mcp)。
# 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,一次性)。
{
"mcpServers": {
"rednote": {
"command": "npx",
"args": ["-y", "@sykuang/rednote-mcp", "--stdio"]
}
}
}
npm install -g @sykuang/rednote-mcp
rednote-mcp --stdio
git clone https://github.com/sykuang/rednote-mcp.git
cd rednote-mcp
npm install
npm run build
node dist/main.js --stdio
此倉庫提供 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 啟用 stdioROD_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 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
# 取得 cookies.json 後 (參考下方登入流程), 直接啟動
docker compose up -d
docker compose logs -f
docker-compose.yml 已包含:
ghcr.io/sykuang/rednote-mcp:latest)cookies.json 持久化 mountshm_size: 1gb(瀏覽器子程序需要)docker build -t rednote-mcp-node .
docker run -p 18060:18060 -v $(pwd)/cookies.json:/app/cookies.json rednote-mcp-node
本專案為 xpzouying/xiaohongshu-mcp(小紅書中國站,Go 實作)的海外版(REDNOTE)port:
npx 安裝、跨平台無需編譯)page.on('response'),比 CDP 更簡單@modelcontextprotocol/sdkXiaohongshu (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.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Rednote 透過 stdio 在本機執行。
上次檢查時間: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.