xiaohongshu-mcp
Provides tools for searching, browsing, and publishing notes on Xiaohongshu (Little Red Book), including login via QR code and checking login status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@xiaohongshu-mcp search for hiking trails in Sichuan"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
小红书 MCP Server
让 AI 助手搜索、浏览、发布小红书笔记
✨ 功能
功能 | MCP 工具 | 说明 |
🔍 搜索笔记 |
| 搜索小红书笔记,返回标题+链接 |
📖 获取笔记 |
| 查看笔记详情、正文、评论 |
📤 发布笔记 |
| 发布图文笔记 |
🔑 扫码登录 |
| 获取二维码,手机扫码登录 |
✅ 检查登录 |
| 检查当前登录状态 |
Related MCP server: rednote-analyzer-mcp
🚀 快速开始
# 1. 安装
pip install xhs-mcp-tool
playwright install chromium
# 2. 启动
python -m xiaohongshu_mcp.server
# 3. 配置到你的 MCP 客户端扫码登录
# 启动后运行:
xhs_login_qrcode() # 获取二维码 → 小红书 App 扫码
xhs_check_login() # 确认已登录🐳 Docker 部署
docker build -t xhs-mcp .
docker run -d -p 6789:6789 -v $HOME/.xiaohongshu_mcp:/data xhs-mcp💰 定价
版本 | 价格 | 适用 |
🌟 个人版 | 免费 (AGPL-3.0) | 个人开发者 |
💼 商业版 | ¥499 | 单项目商用 |
🏢 企业版 | ¥2999 | 无限项目 + 优先支持 |
📦 项目结构
xiaohongshu-mcp/
├── xiaohongshu_mcp/
│ ├── __init__.py
│ ├── server.py # FastMCP 入口 + 工具定义
│ └── core.py # Playwright 控制器
├── data/ # 存储目录(cookies、二维码)
├── pyproject.toml
└── README.md🔗 相关项目
Douyin-mcp — 抖音私信 MCP
WeChat-mcp — 微信消息 MCP
⭐ Star 支持
如果这个项目对你有帮助,欢迎 Star 支持!
Available Tools
8 toolsxhs_check_loginA
检查当前小红书登录状态
Inputs: no named parameters. Returns: result
xhs_commentB
评论小红书笔记
Args: url: 笔记链接 text: 评论内容
Inputs: url (required), text (required). Returns: result
xhs_get_noteB
获取小红书笔记详情及评论
Args: url: 笔记链接 (https://www.xiaohongshu.com/explore/{note_id})
Inputs: url (required). Returns: result
xhs_likeC
点赞/取消点赞小红书笔记
Args: url: 笔记链接
Inputs: url (required). Returns: result
xhs_login_qrcodeA
获取小红书登录二维码(扫码登录)
Inputs: no named parameters. Returns: result
xhs_publishA
发布小红书图文笔记(需登录创作者平台)
Args: title: 笔记标题(不超过20字) content: 笔记正文(不超过1000字) images: 图片本地路径列表
Inputs: title (required), content (required), images (required). Returns: result
xhs_searchC
搜索小红书笔记
Args: keyword: 搜索关键词 limit: 返回结果数量(默认10,最大30)
Inputs: keyword (required), limit. Returns: result
xhs_user_profileC
获取小红书用户主页信息
Args: user_id: 用户ID
Inputs: user_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
All tools have clearly distinct purposes: login checks, QR code login, note retrieval, commenting, liking, publishing, searching, and user profile. There is no functional overlap between any two tools.
While all tools share the 'xhs_' prefix, the naming patterns vary: some are verb-only (e.g., xhs_comment, xhs_like), some verb_noun (e.g., xhs_check_login, xhs_get_note), and some noun_noun (e.g., xhs_login_qrcode, xhs_user_profile). This inconsistency may confuse agents slightly.
With 8 tools, the server covers essential operations for interacting with Xiaohongshu without being overwhelming. Each tool serves a distinct purpose and contributes to a coherent workflow.
The tool set covers core actions like login, note retrieval, commenting, liking, publishing, searching, and profile access. Minor gaps exist, such as missing update/delete operations for notes and follow/unfollow actions, but the set is functional for common tasks.
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
Connect AI to your flomo notes. Search, create, edit notes and manage tags via MCP.
Related MCP Servers
- 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.-
- AlicenseAqualityDmaintenanceMCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.69MIT
- AlicenseNot gradedqualityDmaintenanceEnables automation of Xiaohongshu (Little Red Book) operations including content publishing, searching, and interacting, with MCP protocol support for AI agent integration.1MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search Xiaohongshu notes, analyze favorites, and extract text from images for social media research.742 npm20MIT