小红书 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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| xhs_mcp_tool-0.1.0.tar.gz | 9.3 kB | Without provenance | Details for xhs_mcp_tool-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| xhs_mcp_tool-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for xhs_mcp_tool-0.1.0-py3-none-any.whl |
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}
|
Security for xhs-mcp-tool 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
