推荐一个强大的小红书MCP开源项目 - xiaohongshu-mcp
项目简介
今天给大家介绍一个强大的开源项目 —— xiaohongshu-mcp,这是一个基于 Go 语言开发的 MCP (Model Context Protocol) 服务器,专门用于访问小红书平台。
⭐ GitHub Star: 9.1k+
🔗 GitHub 地址: https://github.com/xpzouying/xiaohongshu-mcp
---
核心功能
1. 登录和检查登录状态
第一步必须的操作,小红书需要进行登录,可以检查当前登录状态。
2. 发布图文内容
支持发布图文内容到小红书,包括标题、内容描述和图片。
图片支持两种方式:
- HTTP/HTTPS 图片链接
- 本地图片绝对路径(推荐)
推荐使用本地路径的原因:
- ✅ 稳定性更好,不依赖网络
- ✅ 上传速度更快
- ✅ 避免图片链接失效问题
- ✅ 支持更多图片格式
3. 发布视频内容
支持发布视频内容到小红书,包括标题、内容描述和本地视频文件。
功能特点:
- ✅ 支持本地视频文件上传
- ✅ 自动处理视频格式转换
- ✅ 支持标题、内容描述和标签
- ✅ 等待视频处理完成后自动发布
注意: 视频处理时间较长,请耐心等待;建议视频文件大小不超过 1GB
4. 搜索内容
根据关键词搜索小红书内容。
5. 获取推荐列表
获取小红书首页推荐内容列表。
6. 获取帖子详情
获取小红书帖子的完整详情,包括:
- 帖子内容(标题、描述、图片等)
- 用户信息
- 互动数据(点赞、收藏、分享、评论数)
- 评论列表及子评论
7. 发表评论
支持自动发表评论到小红书帖子。
8. 获取用户主页
获取小红书用户的个人主页信息,包括用户基本信息和笔记内容。
---
部署方式
方式一:下载预编译二进制文件(推荐)
直接从 GitHub 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
使用步骤:
1. 首先运行登录工具
chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64
2. 然后启动 MCP 服务
chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64
⚠️ 重要提示:首次运行时会自动下载无头浏览器(约 150MB),请确保网络连接正常。
方式二:使用 Docker 容器(最简单)
拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp
下载 docker-compose.yml
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml
启动服务
docker compose up -d
方式三:源码编译
依赖 Golang 环境,需要先配置 Go 国内源代理:
配置 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
---
AI 客户端接入
Claude Code CLI
添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
检查 MCP 是否添加成功
claude mcp list
Cursor
在项目根目录创建 .cursor/mcp.json:
{
"mcpServers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"description": "小红书内容发布服务 - MCP Streamable HTTP"
}
}
}
VSCode
在项目根目录创建 .vscode/mcp.json:
{
"servers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"type": "http"
}
}
}
---
小红书运营注意事项
- 标题: 小红书要求标题不超过 20 个字
- 正文: 正文不能超过 1000 个字
- 内容类型: 从推荐的角度看,图文的流量会比视频以及纯文字的更好
- Tags: 添加合适的 Tags 能带来更多的流量
- 发帖量: 根据实操,小红书每天的发帖量应该是 50 篇
- 账号安全: 小红书同一个账号不允许在多个网页端登录
---
风险说明
该项目是基于学习的目的,禁止一切违法行为。原项目稳定运行一年多,没有出现过封号的情况,只有出现过 Cookies 过期需要重新登录的情况。
---
总结
xiaohongshu-mcp 是一个非常强大的小红书自动化工具,通过 MCP 协议可以方便地与各种 AI 客户端集成,实现自动化运营小程序号的目的。
如果你对小红书自动化运营感兴趣,这个项目绝对值得一试!





