xhs-mcp

简体中文 | English

xhs-mcp 提供统一的命令行入口 xhs-cli，并内置 MCP 服务器子命令。用于小红书（xiaohongshu.com）的 Model Context Protocol（MCP）服务器与 CLI 工具，支持登录、发布、搜索、推荐等自动化能力（基于 Puppeteer）。

npm version npm downloads License: MIT

📦 NPM 信息

包名: xhs-mcp
运行 CLI（推荐）: npx xhs-cli <subcommand>
启动 MCP：npx xhs-cli mcp [--mode stdio|http] [--port 3000]

✨ 功能

认证：登录、登出、状态检查
发布：图文发布（标题≤20、内容≤1000、最多18图）
发现：推荐、搜索、详情、评论
自动化：Puppeteer 驱动、无头模式、Cookie 管理

📋 可用工具

xhs_auth_login、xhs_auth_logout、xhs_auth_status
xhs_discover_feeds、xhs_search_note、xhs_get_note_detail
xhs_comment_on_note
xhs_publish_content（统一发布接口：type、title、content、media_paths、tags）
- 图片：1-18个图片文件
- 视频：恰好1个视频文件

🚀 快速开始（MCP）

Stdio 模式（默认）

npx xhs-cli mcp # 调试日志 XHS_ENABLE_LOGGING=true npx xhs-cli mcp

首次运行提示：如果未安装 Puppeteer 浏览器，先执行
npx xhs-cli browser # 自动检查并安装 Chromium，显示可执行路径 # 或 npx puppeteer browsers install chrome
输出示例：
{ "success": true, "message": "Chromium is ready", "data": { "installed": true, "executablePath": "/path/to/chromium" } }

验证 MCP 连接：

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx xhs-cli mcp

HTTP 模式

# 启动 HTTP 服务器（默认端口 3000） npx xhs-cli mcp --mode http # 指定端口 npx xhs-cli mcp --mode http --port 8080 # 调试模式 XHS_ENABLE_LOGGING=true npx xhs-cli mcp --mode http

HTTP 服务器支持：

Streamable HTTP (协议版本 2025-03-26) - 端点：/mcp
SSE (协议版本 2024-11-05) - 端点：/sse 和 /messages
健康检查 - 端点：/health

详细文档请参考：HTTP Transports

🧰 CLI 子命令

# 认证 npx xhs-cli login --timeout 120 npx xhs-cli logout npx xhs-cli status # 浏览器依赖 npx xhs-cli browser [--with-deps] # 检查并安装 Chromium，显示可执行路径 # 发现与检索 npx xhs-cli feeds [-b /path/to/chromium] npx xhs-cli search -k 关键字 [-b /path/to/chromium] npx xhs-cli note-detail --feed-id <id> --xsec-token <token> [-b /path/to/chromium] # 互动 npx xhs-cli comment --feed-id <id> --xsec-token <token> -n "Nice!" [-b /path/to/chromium] # 发布 npx xhs-cli publish --type image --title 标题 --content 内容 -m path1.jpg,path2.png --tags a,b [-b /path/to/chromium] npx xhs-cli publish --type video --title 视频标题 --content 视频描述 -m path/to/video.mp4 --tags a,b [-b /path/to/chromium] # 查看可用工具 npx xhs-cli tools [--detailed] [--json] # 启动 MCP npx xhs-cli mcp [--mode stdio|http] [--port 3000]

🔧 客户端接入（Cursor）

Stdio 模式

.cursor/mcp.json：

{ "mcpServers": { "xhs-mcp": { "command": "npx", "args": ["xhs-cli", "mcp"], "env": { "XHS_ENABLE_LOGGING": "true" } } } }

HTTP 模式

.cursor/mcp.json：

{ "mcpServers": { "xhs-mcp-http": { "command": "npx", "args": ["xhs-cli", "mcp", "--mode", "http", "--port", "3000"], "env": { "XHS_ENABLE_LOGGING": "true" } } } }

或者使用 HTTP 客户端直接连接：

{ "mcpServers": { "xhs-mcp-http": { "url": "http://localhost:3000/mcp" } } }

⚠️ 注意事项

标题≤20、内容≤1000、图片≤18
避免同账号多端同时网页登录
合理控制发帖频率

🙏 致谢

基于 xiaohongshu-mcp 重构与扩展（TypeScript、Puppeteer、MCP 优化、日志清理、NPM 发布）。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables interaction with Xiaohongshu (Little Red Book) platform through automated browser operations. Supports authentication, content publishing, search, discovery, and commenting using Puppeteer-based automation.

XHS MCP

xhs-mcp

📦 NPM 信息

✨ 功能

📋 可用工具

🚀 快速开始（MCP）

Stdio 模式（默认）

HTTP 模式

🧰 CLI 子命令

🔧 客户端接入（Cursor）

Stdio 模式

HTTP 模式

⚠️ 注意事项

🙏 致谢

New MCP Servers

MCP directory API