xpzouying/xiaohongshu-mcp

xiaohongshu‑mcp

是什麼 – 一個將小紅書（Xiaohongshu）社交平台作為 Model Context Protocol（MCP）伺服器公開的自架設服務。透過執行此伺服器，AI 助手（Claude Code、Cursor、VS Code、Open Code、Cline 等）可呼叫小紅書功能，如登入、發文、搜尋、按讚/收藏、留言，以及取得使用者或貼文的詳細資訊。

核心功能

登入管理 – 支援 QR 碼登入、Cookie 處理、狀態檢查、Cookie 重設。
內容發佈 – 發布圖文筆記（標題、內文、圖片）或影片筆記（標題、內文、本機影片）。支援標籤、排程、可見性選項與商品連結。
動態操作 – 取得首頁推薦清單、按關鍵字搜尋並加篩選條件、取得完整貼文詳情（含留言與互動資料）、按讚/取消按讚、收藏/取消收藏。
社交互動 – 發佈留言、回覆特定留言、取得使用者個人檔案及其發佈的筆記。
MCP 集成 – 所有功能均以標準 MCP 工具形式公開（如 check_login_status、publish_content、search_feeds 等），任何 MCP 相容客戶端皆可呼叫。

如何執行

預先建置的二進位檔 – 從 Releases 頁面下載適用於 macOS Apple Silicon、Windows x64 或 Linux x64 的可執行檔。先執行一次 xiaohongshu-login-* 二進位檔完成登入，再啟動 xiaohongshu-mcp-*。
Docker – 拉取鏡像 xpzouying/xiaohongshu-mcp，使用提供的 docker-compose.yml 啟動。容器會自動安裝無頭 Chromium 瀏覽器，掛載 ./data 用於儲存 Cookie，./images 用於上傳媒體，並公開 18060 端口。
從原始碼建構 – 需要 Go 1.20+。設定 GOPROXY（例如 https://goproxy.cn），然後執行 go build ./...。

典型使用流程

# 1. 登入（每個會話只需一次）
./xiaohongshu-login-darwin-arm64   # 或 Windows/Linux 二進位檔

# 2. 啟動 MCP 伺服器（預設無頭模式）
./xiaohongshu-mcp-darwin-arm64
#   → 監聽 http://localhost:18060/mcp

# 3. 使用 MCP 檢查器驗證
npx @modelcontextprotocol/inspector
#   → 連接到上述 URL 並列出可用工具

連接 AI 客戶端 – 將伺服器位址（http://localhost:18060/mcp）加入客戶端的 MCP 設定中。範例包括：

Claude Code CLI（claude mcp add …）
Open Code CLI（互動式 opencode mcp add）
Cursor（.cursor/mcp.json）
VS Code（.vscode/mcp.json）
Google Gemini CLI、Cline 以及任意通用 HTTP-MCP 客戶端。

安全與可選驗證

預設伺服器僅在本機開放。生產環境請設定 AUTH_TOKEN（或 -token 標誌），並讓客戶端傳送 Authorization: Bearer <token>。
透過 XHS_PROXY（HTTP/HTTPS/SOCKS5）支援代理，適用於需要出站路由的環境。

社群與支援

29 位貢獻者（All‑Contributors 標誌）。
Docker 拉取統計、星標歷史圖表，以及專用的贊助頁面（所有收益將捐贈給慈善機構）。
豐富的故障排除指南（Issue #56）與專為非技術使用者設計的瀏覽器擴充版本（xpzouying/x-mcp）。

誰可能使用它

需要讀取或發布小紅書內容的 AI 代理開發者。
希望透過提示詞自動化發文、留言或資料蒐集的內容創作者。
正在實驗社交平台驅動的 LLM 工作流程的研究人員。

以上所有細節均直接取自倉儲的 README；未推斷任何額外功能。

xpzouying/xiaohongshu-mcp

xiaohongshu‑mcp

相關