xhs-mcp
📕 xhs-mcp — convierte 小某书 en tu herramienta MCP
Ejecución local · Impulsado por Chrome · Seguro para cuentas alternativas — 小红书 ⇌ cualquier host MCP (DSH primero)
Un ligero MCP Server que te permite, en hosts como DSH / Claude / Cursor, mediante mensajes privados/llamadas a herramientas operar 小红书: iniciar sesión, buscar notas (la capacidad de publicar está reservada, requiere autorización explícita del propietario)
✨ Funciones
Capacidad | Descripción | Estado |
🔐 Estado de sesión independiente | Perfil de Chrome independiente, escanea una vez y no necesitas volver a iniciar sesión | ✅ |
🔍 Buscar notas | Búsqueda por palabras clave, devuelve título + enlace | ✅ |
🛡️ Anti-detección | Chrome real + UA real + eliminación de la marca webdriver | ✅ |
👤 Aislamiento de cuenta alternativa | Perfil independiente, no toca la cuenta diaria del propietario | ✅ |
📝 Publicar | Interfaz reservada (requiere autorización explícita del propietario) | 🚧 |
🖥️ Multi-host | MCP stdio, compatible con DSH/Claude/Cursor | ✅ |
Related MCP server: Xiaohongshu (RedBook) MCP Server
🚀 Inicio rápido (DSH primero)
Requisitos previos
Node.js ≥ 20
Google Chrome instalado (o especificar ruta)
1️⃣ Descargar
git clone https://github.com/HUliangwei/xhs-mcp.git
cd xhs-mcp
npm install # 安装 playwright-core2️⃣ Configurar
cp .env.example .env
# 按需改 XHS_PROFILE(多账号用不同名)3️⃣ Registrar en DSH
Copia dsh-bundle/ en tus profile bundles y añade ./bundles/xhs-mcp a dsh.profile.bundles en el package.json del perfil:
{ "dsh": { "profile": { "bundles": [ "./bundles/xhs-mcp" ] } } }Reinicia DSH → el grupo de herramientas xhs_* estará disponible.
4️⃣ Otros hosts
{ "mcpServers": { "xhs": { "command": "node", "args": ["<路径>/xhs-mcp-server.mjs"] } } }🛠️ Herramientas
Herramienta | Descripción |
xhs_login | Abre Chrome real, inicia sesión escaneando (180s, persistente) |
xhs_search | Buscar notas: { keyword, count } → título + enlace |
xhs_status | Comprobación del estado de inicio de sesión |
🛡️ Diseño de seguridad
Solo mensajes privados/llamadas a herramientas: sin integración con difusiones de chats grupales
Solo para cuentas alternativas: perfil independiente, aislamiento del estado de sesión, no toca la cuenta principal del propietario
Solo lectura primero: actualmente solo lectura + búsqueda; publicar requiere autorización explícita del propietario y cumplimiento de baja frecuencia
Ejecución local: sin servidor remoto, los datos no salen de la máquina
Fuera de git: profiles/ (estado de sesión), .env todo ignorado
📜 Código abierto
Apache-2.0 · GitHub
¿Te gusta? ¡⭐ Star!
This server cannot be deployed
Maintenance
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.457-
- 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