xhs-mcp
📕 xhs-mcp — 小某书(小红书)をあなたの MCP ツールに
ローカル実行 · Chrome 駆動 · サブアカウント安全 — 小红书 ⇌ 任意の MCP ホスト(DSH 優先)
軽量 MCP Server で、DSH / Claude / Cursor などのホストからプライベートメッセージ/ツール呼び出しで小红书を操作できます: ログイン、ノート検索!(投稿機能は予約済み、オーナーの明示的な承認が必要)
✨ 機能
機能 | 説明 | ステータス |
🔐 独立ログイン状態 | 独立した Chrome profile、QR コードスキャンで一度ログインすれば永続的にログイン不要 | ✅ |
🔍 ノート検索 | キーワード検索、タイトル + リンクを返す | ✅ |
🛡️ 検出対策 | 本物の Chrome + 実際の UA + webdriver マーカー除去 | ✅ |
👤 サブアカウント分離 | profile 独立、オーナーの日常アカウントに触れない | ✅ |
📝 投稿 | インターフェース予約済み(オーナーの明示的な承認が必要) | 🚧 |
🖥️ マルチホスト | stdio MCP、DSH/Claude/Cursor 対応 | ✅ |
Related MCP server: Xiaohongshu (RedBook) MCP Server
🚀 クイックスタート(DSH 優先)
前提条件
Node.js ≥ 20
Google Chrome がインストール済み(またはパスを指定)
1️⃣ ダウンロード
git clone https://github.com/HUliangwei/xhs-mcp.git
cd xhs-mcp
npm install # 安装 playwright-core2️⃣ 設定
cp .env.example .env
# 按需改 XHS_PROFILE(多账号用不同名)3️⃣ DSH に登録
dsh-bundle/ をプロフィールの bundles にコピーし、プロフィールの package.json の dsh.profile.bundles に ./bundles/xhs-mcp を追加:
{ "dsh": { "profile": { "bundles": [ "./bundles/xhs-mcp" ] } } }DSH を再起動 → ツールグループ xhs_* が利用可能。
4️⃣ その他のホスト
{ "mcpServers": { "xhs": { "command": "node", "args": ["<路径>/xhs-mcp-server.mjs"] } } }🛠️ ツール
ツール | 説明 |
xhs_login | 実際の Chrome を開き、QR コードでログイン(180秒、永続化) |
xhs_search | ノート検索:{ keyword, count } → タイトル+リンク |
xhs_status | ログイン状態の確認 |
🛡️ セキュリティ設計
プライベートメッセージ/ツール呼び出しのみ:グループチャットのブロードキャストには接続しない
サブアカウント専用:独立した profile、ログイン状態の分離、オーナーのメインアカウントに触れない
読み取り専用優先:現在は読み取り専用+検索;投稿はオーナーの明示的な承認が必要、低頻度でコンプライアンス遵守
ローカル実行:リモートサーバーなし、データはローカルから出ない
git に含めない:profiles/(ログイン状態)、.env はすべて無視
📜 オープンソース
Apache-2.0 · GitHub
便利だと思ったら?⭐ Star!!
This server cannot be deployed
Related MCP Connectors
RedNote (Xiaohongshu, 小红书) note search, full notes, comment threads and creator profiles.
搜索笔记、浏览首页推荐、查看笔记内容与评论,并发表你的评论。直接在工作流中与小红书内容互动,高效跟进话题。
XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables automated interaction with Xiaohongshu (Little Red Book) social media platform through browser automation. Supports login management, status checking, and publishing text content with images to Xiaohongshu accounts.33-
- FlicenseNot gradedqualityDmaintenanceEnables automated interaction with Xiaohongshu (Little Red Book) platform including searching posts, retrieving content and comments, and posting AI-generated comments with persistent login support.459-
- FlicenseNot gradedqualityDmaintenanceEnables automated searching and commenting on Xiaohongshu with AI-generated comments via MCP clients like Claude, supporting login persistence, note analysis, and four comment types.-
- AlicenseAqualityFmaintenanceEnables AI assistants to search, browse, and publish notes on Xiaohongshu (Little Red Book) via MCP tools.8AGPL 3.0