推荐一个强大的小红书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 客户端集成,实现自动化运营小程序号的目的。

如果你对小红书自动化运营感兴趣,这个项目绝对值得一试!

发表回复

后才能评论