# xiaohongshu-mcp
**Repository Path**: boomer001/xiaohongshu-mcp
## Basic Information
- **Project Name**: xiaohongshu-mcp
- **Description**: https://github.com/xpzouying/xiaohongshu-mcp 原址, 方便大家使用
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-09-23
- **Last Updated**: 2025-10-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# xiaohongshu-mcp
[](#contributors-)
MCP for 小红书/xiaohongshu.com。
- 我的博客文章:[haha.ai/xiaohongshu-mcp](https://www.haha.ai/xiaohongshu-mcp)
**遇到任何问题,务必要先看 [各种疑难杂症](https://github.com/xpzouying/xiaohongshu-mcp/issues/56)**。
## Star History
[](https://www.star-history.com/#xpzouying/xiaohongshu-mcp&Timeline)
**主要功能**
> 💡 **提示:** 点击下方功能标题可展开查看视频演示
1. 登录和检查登录状态
第一步必须,小红书需要进行登录。可以检查当前登录状态。
**登录演示:**
https://github.com/user-attachments/assets/8b05eb42-d437-41b7-9235-e2143f19e8b7
**检查登录状态演示:**
https://github.com/user-attachments/assets/bd9a9a4a-58cb-4421-b8f3-015f703ce1f9
2. 发布图文内容
支持发布图文内容到小红书,包括标题、内容描述和图片。
**图片支持方式:**
支持两种图片输入方式:
1. **HTTP/HTTPS 图片链接**
```
["https://example.com/image1.jpg", "https://example.com/image2.png"]
```
2. **本地图片绝对路径**(推荐)
```
["/Users/username/Pictures/image1.jpg", "/home/user/images/image2.png"]
```
**为什么推荐使用本地路径:**
- ✅ 稳定性更好,不依赖网络
- ✅ 上传速度更快
- ✅ 避免图片链接失效问题
- ✅ 支持更多图片格式
**发布图文帖子演示:**
https://github.com/user-attachments/assets/8aee0814-eb96-40af-b871-e66e6bbb6b06
3. 发布视频内容
支持发布视频内容到小红书,包括标题、内容描述和本地视频文件。
**视频支持方式:**
仅支持本地视频文件绝对路径:
```
"/Users/username/Videos/video.mp4"
```
**功能特点:**
- ✅ 支持本地视频文件上传
- ✅ 自动处理视频格式转换
- ✅ 支持标题、内容描述和标签
- ✅ 等待视频处理完成后自动发布
**注意事项:**
- 仅支持本地视频文件,不支持 HTTP 链接
- 视频处理时间较长,请耐心等待
- 建议视频文件大小不超过 1GB
4. 搜索内容
根据关键词搜索小红书内容。
**搜索帖子演示:**
https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3
5. 获取推荐列表
获取小红书首页推荐内容列表。
**获取推荐列表演示:**
https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28
6. 获取帖子详情(包括互动数据和评论)
获取小红书帖子的完整详情,包括:
- 帖子内容(标题、描述、图片等)
- 用户信息
- 互动数据(点赞、收藏、分享、评论数)
- 评论列表及子评论
**⚠️ 重要提示:**
- 需要提供帖子 ID 和 xsec_token(两个参数缺一不可)
- 这两个参数可以从 Feed 列表或搜索结果中获取
- 必须先登录才能使用此功能
**获取帖子详情演示:**
https://github.com/user-attachments/assets/76a26130-a216-4371-a6b3-937b8fda092a
7. 发表评论到帖子
支持自动发表评论到小红书帖子。
**功能说明:**
- 自动定位评论输入框
- 输入评论内容并发布
- 支持 HTTP API 和 MCP 工具调用
**⚠️ 重要提示:**
- 需要先登录才能使用此功能
- 需要提供帖子 ID、xsec_token 和评论内容
- 这些参数可以从 Feed 列表或搜索结果中获取
**发表评论演示:**
https://github.com/user-attachments/assets/cc385b6c-422c-489b-a5fc-63e92c695b80
8. 获取用户个人主页
获取小红书用户的个人主页信息,包括用户基本信息和笔记内容。
**功能说明:**
- 获取用户基本信息(昵称、简介、头像等)
- 获取关注数、粉丝数、获赞量统计
- 获取用户发布的笔记内容列表
- 支持 HTTP API 和 MCP 工具调用
**⚠️ 重要提示:**
- 需要先登录才能使用此功能
- 需要提供用户 ID 和 xsec_token
- 这些参数可以从 Feed 列表或搜索结果中获取
**返回信息包括:**
- 用户基本信息:昵称、简介、头像、认证状态
- 统计数据:关注数、粉丝数、获赞量、笔记数
- 笔记列表:用户发布的所有公开笔记
一周左右的成果
## 1. 使用教程
### 1.1. 快速开始(推荐)
**方式一:下载预编译二进制文件**
直接从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载对应平台的二进制文件:
**主程序(MCP 服务):**
- **macOS Apple Silicon**: `xiaohongshu-mcp-darwin-arm64`
- **macOS Intel**: `xiaohongshu-mcp-darwin-amd64`
- **Windows x64**: `xiaohongshu-mcp-windows-amd64.exe`
- **Linux x64**: `xiaohongshu-mcp-linux-amd64`
**登录工具:**
- **macOS Apple Silicon**: `xiaohongshu-login-darwin-arm64`
- **macOS Intel**: `xiaohongshu-login-darwin-amd64`
- **Windows x64**: `xiaohongshu-login-windows-amd64.exe`
- **Linux x64**: `xiaohongshu-login-linux-amd64`
使用步骤:
```bash
# 1. 首先运行登录工具
chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64
# 2. 然后启动 MCP 服务
chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64
```
**⚠️ 重要提示**:首次运行时会自动下载无头浏览器(约 150MB),请确保网络连接正常。后续运行无需重复下载。
**方式二:源码编译**
源码编译安装详情
依赖 Golang 环境,安装方法请参考 [Golang 官方文档](https://go.dev/doc/install)。
设置 Go 国内源的代理,
```bash
# 配置 GOPROXY 环境变量,以下三选一
# 1. 七牛 CDN
go env -w GOPROXY=https://goproxy.cn,direct
# 2. 阿里云
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
# 3. 官方
go env -w GOPROXY=https://goproxy.io,direct
```
Docker 部署详情
使用 Docker 部署是最简单的方式,无需安装任何开发环境。
**1. 从 Docker Hub 拉取镜像(推荐)**
我们提供了预构建的 Docker 镜像,可以直接从 Docker Hub 拉取使用:
```bash
# 拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp
```
Docker Hub 地址:[https://hub.docker.com/r/xpzouying/xiaohongshu-mcp](https://hub.docker.com/r/xpzouying/xiaohongshu-mcp)
**2. 使用 Docker Compose 启动(推荐)**
我们提供了配置好的 `docker-compose.yml` 文件,可以直接使用:
```bash
# 下载 docker-compose.yml
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml
# 或者如果已经克隆了项目,进入 docker 目录
cd docker
# 启动服务
docker compose up -d
# 查看日志
docker compose logs -f
# 停止服务
docker compose stop
```
**3. 自己构建镜像(可选)**
```bash
# 在项目根目录运行
docker build -t xpzouying/xiaohongshu-mcp .
```
**4. 配置说明**
Docker 版本会自动:
- 配置 Chrome 浏览器和中文字体
- 挂载 `./data` 用于存储 cookies
- 挂载 `./images` 用于存储发布的图片
- 暴露 18060 端口供 MCP 连接
详细使用说明请参考:[Docker 部署指南](./docker/README.md)
Claude Code CLI
官方命令行工具,已在上面快速开始部分展示:
```bash
# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
# 检查 MCP 是否添加成功(确保 MCP 已经启动的前提下,运行下面命令)
claude mcp list
```
Cursor
#### 配置文件的方式
创建或编辑 MCP 配置文件:
**项目级配置**(推荐):
在项目根目录创建 `.cursor/mcp.json`:
```json
{
"mcpServers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"description": "小红书内容发布服务 - MCP Streamable HTTP"
}
}
}
```
**全局配置**:
在用户目录创建 `~/.cursor/mcp.json` (同样内容)。
#### 使用步骤
1. 确保小红书 MCP 服务正在运行
2. 保存配置文件后,重启 Cursor
3. 在 Cursor 聊天中,工具应该自动可用
4. 可以通过聊天界面的 "Available Tools" 查看已连接的 MCP 工具
**Demo**
插件 MCP 接入:

调用 MCP 工具:(以检查登录状态为例)

VSCode
#### 方法一:使用命令面板配置
1. 按 `Ctrl/Cmd + Shift + P` 打开命令面板
2. 运行 `MCP: Add Server` 命令
3. 选择 `HTTP` 方式。
4. 输入地址: `http://localhost:18060/mcp`,或者修改成对应的 Server 地址。
5. 输入 MCP 名字: `xiaohongshu-mcp`。
#### 方法二:直接编辑配置文件
**工作区配置**(推荐):
在项目根目录创建 `.vscode/mcp.json`:
```json
{
"servers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"type": "http"
}
},
"inputs": []
}
```
**查看配置**:

1. 确认运行状态。
2. 查看 `tools` 是否正确检测。
**Demo**
以搜索帖子内容为例:

Google Gemini CLI
在 `~/.gemini/settings.json` 或项目目录 `.gemini/settings.json` 中配置:
```json
{
"mcpServers": {
"xiaohongshu": {
"httpUrl": "http://localhost:18060/mcp",
"timeout": 30000
}
}
}
```
更多信息请参考 [Gemini CLI MCP 文档](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)
MCP Inspector
调试工具,用于测试 MCP 连接:
```bash
# 启动 MCP Inspector
npx @modelcontextprotocol/inspector
# 在浏览器中连接到:http://localhost:18060/mcp
```
使用步骤:
- 使用 MCP Inspector 测试连接
- 测试 Ping Server 功能验证连接
- 检查 List Tools 是否返回 6 个工具
Cline
Cline 是一个强大的 AI 编程助手,支持 MCP 协议集成。
#### 配置方法
在 Cline 的 MCP 设置中添加以下配置:
```json
{
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"type": "streamableHttp",
"autoApprove": [],
"disabled": false
}
}
```
#### 使用步骤
1. 确保小红书 MCP 服务正在运行(`http://localhost:18060/mcp`)
2. 在 Cline 中打开 MCP 设置
3. 添加上述配置到 MCP 服务器列表
4. 保存配置并重启 Cline
5. 在对话中可以直接使用小红书相关功能
#### 配置说明
- `url`: MCP 服务地址
- `type`: 使用 `streamableHttp` 类型以获得更好的性能
- `autoApprove`: 可配置自动批准的工具列表(留空表示手动批准)
- `disabled`: 设置为 `false` 启用此 MCP 服务
#### 使用示例
配置完成后,可以在 Cline 中直接使用自然语言操作小红书:
```
帮我检查小红书登录状态
```
```
帮我发布一篇关于春天的图文到小红书,使用这张图片:/path/to/spring.jpg
```
```
搜索小红书上关于"美食"的内容
```
其他支持 HTTP MCP 的客户端
任何支持 HTTP MCP 协议的客户端都可以连接到:`http://localhost:18060/mcp`
基本配置模板:
```json
{
"name": "xiaohongshu-mcp",
"url": "http://localhost:18060/mcp",
"type": "http"
}
```
## 3. 🌟 实战案例展示 (Community Showcases)
> 💡 **强烈推荐查看**:这些都是社区贡献者的真实使用案例,包含详细的配置步骤和实战经验!
### 📚 完整教程列表
1. **[n8n 完整集成教程](./examples/n8n/README.md)** - 工作流自动化平台集成
2. **[Cherry Studio 完整配置教程](./examples/cherrystudio/README.md)** - AI 客户端完美接入
3. **[Claude Code + Kimi K2 接入教程](./examples/claude-code/claude-code-kimi-k2.md)** - Claude Code 门槛太高,那么就接入 Kimi 国产大模型吧~
4. **[AnythingLLM 完整指南](./examples/anythingLLM/readme.md)** - AnythingLLM 是一款 all-in-one 多模态 AI 客户端,支持 workflow 定义,支持多种大模型和插件扩展。
> 🎯 **提示**: 点击上方链接查看详细的图文教程,快速上手各种集成方案!
>
> 📢 **欢迎贡献**: 如果你有新的集成案例,欢迎提交 PR 分享给社区!
## 4. 小红书 MCP 互助群
**重要:在群里问问题之前,请一定要先仔细看完 README 文档以及查看 Issues。**
| 【飞书二群】:扫码进入 | 【微信群 6 群】:扫码进入 |
| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
|
|
|
## 🙏 致谢贡献者 ✨
感谢以下所有为本项目做出贡献的朋友!(排名不分先后)
zy 💻 🤔 📖 🎨 🚧 🚇 👀 |
clearwater 💻 |
Zhongpeng 💻 |
Duong Tran 💻 |
Angiin 💻 |
Henan Mu 💻 |
Journey 💻 |
Eve Yu 💻 |
CooperGuo 💻 |
Banghao Chi 💻 |
varz1 💻 |
Melo Y Guan 💻 |
lmxdawn 💻 |