MCP Server for Xiaohongshu (小红书) — let AI search notes, read content, and publish via browser automation
Project description
小红书 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 支持！
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
xhs_mcp_tool-0.1.0.tar.gz
(9.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xhs_mcp_tool-0.1.0.tar.gz.
File metadata
- Download URL: xhs_mcp_tool-0.1.0.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30341b2dec8f0517b0028488c3302cdf4a63eec693601a69d82380cc94853f88
|
|
| MD5 |
b25ca7721b9449e815dca6c9660abd08
|
|
| BLAKE2b-256 |
bdd6651d65c8717138230d938ea83f5d65d07839e3d208972d615b51ef1c8dbf
|
File details
Details for the file xhs_mcp_tool-0.1.0-py3-none-any.whl.
File metadata
- Download URL: xhs_mcp_tool-0.1.0-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7d12aab4049bb1b7fc84fb81ea1d4eb7580e8fc43f9248212fce8f0efcb6696
|
|
| MD5 |
1e058a9c1f6b9e43791896101673cd0b
|
|
| BLAKE2b-256 |
c5082fd643a5aa30a983e9d1b72c0ae82bcbdb52bdcda83b5a4ae4ee74656186
|
