小红书 MCP Server
让 AI 助手搜索、浏览、发布小红书笔记
✨ 功能
| 功能 | MCP 工具 | 说明 |
|---|---|---|
| 🔍 搜索笔记 | xhs_search(keyword, limit) |
搜索小红书笔记，返回标题+链接 |
| 📖 获取笔记 | xhs_get_note(url) |
查看笔记详情、正文、评论 |
| 📤 发布笔记 | xhs_publish(title, content, images) |
发布图文笔记 |
| 🔑 扫码登录 | xhs_login_qrcode() |
获取二维码，手机扫码登录 |
| ✅ 检查登录 | xhs_check_login() |
检查当前登录状态 |
🚀 快速开始
# 1. 安装
pip install -e .
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 支持！
1 maintainer
Release files for xhs-mcp-tool 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| xhs_mcp_tool-0.1.0.tar.gz | 9.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xhs_mcp_tool-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.6 kB
Release files / xhs_mcp_tool-0.1.0.tar.gz
| Download URL | xhs_mcp_tool-0.1.0.tar.gz |
|---|---|
| Size | 9.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
30341b2dec8f0517b0028488c3302cdf4a63eec693601a69d82380cc94853f88
|
|
BLAKE2b-256 checksum How to use checksums |
bdd6651d65c8717138230d938ea83f5d65d07839e3d208972d615b51ef1c8dbf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / xhs_mcp_tool-0.1.0-py3-none-any.whl
| Download URL | xhs_mcp_tool-0.1.0-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d7d12aab4049bb1b7fc84fb81ea1d4eb7580e8fc43f9248212fce8f0efcb6696
|
|
BLAKE2b-256 checksum How to use checksums |
c5082fd643a5aa30a983e9d1b72c0ae82bcbdb52bdcda83b5a4ae4ee74656186
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
