Skip to main content
Glama

📕 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-core

2️⃣ 設定

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!!

Related MCP Connectors

Related MCP Servers