xiaohongshu-mcp

MCP for 小红书 / xiaohongshu.com。让你的 AI 助手直接访问小红书数据。

🚀 快速开始：选择最适合你的版本

[!IMPORTANT]

🔥 方案 A：Openclaw 深度集成 (推荐给开发者)

• Openclaw 太火啦 🔥🔥🔥 ，新增 Openclaw 支持，分为两种，请各位按需使用：
• xiaohongshu-mcp-skills（适用于已部署完本项目的用户）
• xiaohongshu-skills（开箱即用版）

[!TIP]

✨ 方案 B：x-mcp 浏览器插件版 (推荐给非技术同学 / 追求极简的用户)

• 不想折腾 Docker 或部署环境？试试：xpzouying/x-mcp
• 零配置：安装插件即用，无需任何代码、代理或复杂的环境配置。
• 安全稳定：直接在常用浏览器 (Chrome/Edge) 及本地网络运行，无服务器 IP 风险，且能解决 90% 的部署报错。

📖 相关资源

• 我的博客文章：haha.ai/xiaohongshu-mcp
• 贡献指南：Contributing Guide

🛠️ 疑难杂症

如果您在部署传统 Docker 版本时遇到问题，务必先查看：各种疑难杂症 (Issues #56)。

提示：如果环境排查太耗时，切换到 x-mcp 插件版 通常是更高效的选择。

Star History

赞赏支持

本项目所有的赞赏都会用于慈善捐赠。所有的慈善捐赠记录，请参考 DONATIONS.md。

捐赠时，请备注 MCP 以及名字。 如需更正/撤回署名，请开 Issue 或通过邮箱联系。

支付宝（不展示二维码）：

通过支付宝向 xpzouying@gmail.com 赞赏。

微信：

项目简介

主要功能

💡 提示： 点击下方功能标题可展开查看视频演示

"/Users/username/Videos/video.mp4"

小红书基础运营知识

• 标题：（非常重要）小红书要求标题不超过 20 个字
• 正文：（非常重要）：正文不能超过 1000 个字
• 当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。
• （低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。
• Tags：现已支持。添加合适的 Tags 能带来更多的流量。
• 根据本人实操，小红书每天的发帖量应该是 50 篇。
• （非常重要）小红书的同一个账号不允许在多个网页端登录，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。
• 曝光低的话，首先查看内容中是否有违禁词，搜一下有很多第三方免费工具。
• 一定不要出现引流、纯搬运的情况，属于官方重点打击对象。

风险说明

1. 该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。
2. 我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。
3. 如果账号没有实名认证，特别是新号，一般会触发 实名认证 的消息提醒（参见下图）。⚠️ 这个不是封号，不用 MCP 也会要求实名认证。实名认证后，账号就正常了。建议使用该项目前就先实名。

该项目是基于学习的目的，禁止一切违法行为。

实操结果

第一天点赞/收藏数达到了 999+，

一周左右的成果

1. 使用教程

1.1. 快速开始（推荐）

方式一：下载预编译二进制文件

直接从 GitHub Releases 下载对应平台的二进制文件：

主程序（MCP 服务）：

• macOS Apple Silicon: xiaohongshu-mcp-darwin-arm64
• Windows x64: xiaohongshu-mcp-windows-amd64.exe
• Linux x64: xiaohongshu-mcp-linux-amd64

登录工具：

• macOS Apple Silicon: xiaohongshu-login-darwin-arm64
• Windows x64: xiaohongshu-login-windows-amd64.exe
• Linux x64: xiaohongshu-login-linux-amd64

目前支持以上三个平台。macOS Intel 与 Linux ARM64 暂不支持。

使用步骤：

# 1. 首先运行登录工具
chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64

# 2. 然后启动 MCP 服务
chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64

⚠️ 重要提示：首次运行时会自动下载无头浏览器（约 150MB），请确保网络连接正常。后续运行无需重复下载。

方式二：源码编译

# 配置 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 pull xpzouying/xiaohongshu-mcp

# 下载 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

# 在项目根目录运行
docker build -t xpzouying/xiaohongshu-mcp .

Windows 遇到问题首先看这里：Windows 安装指南

1.2. 登录

第一次需要手动登录，需要保存小红书的登录状态。

使用二进制文件：

# 运行对应平台的登录工具
./xiaohongshu-login-darwin-arm64

使用源码：

go run cmd/login/main.go

1.3. 启动 MCP 服务

启动 xiaohongshu-mcp 服务。

使用二进制文件：

# 默认：无头模式，没有浏览器界面
./xiaohongshu-mcp-darwin-arm64

# 非无头模式，有浏览器界面
./xiaohongshu-mcp-darwin-arm64 -headless=false

使用源码：

# 默认：无头模式，没有浏览器界面
go run .

# 非无头模式，有浏览器界面
go run . -headless=false

配置代理（可选）：

如果需要通过代理访问，可以设置 XHS_PROXY 环境变量：

# 设置代理后启动
XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64

# 或使用源码
XHS_PROXY=http://proxy:port go run .

支持 HTTP/HTTPS/SOCKS5 代理，日志中会自动隐藏代理的认证信息。

访问鉴权（可选）：

默认关闭鉴权。生产环境建议使用 AUTH_TOKEN 环境变量配置；非空的启动参数优先于环境变量，留空则读取 AUTH_TOKEN。

# 环境变量
AUTH_TOKEN=your-secret-token ./xiaohongshu-mcp-darwin-arm64
AUTH_TOKEN=your-secret-token go run .

# 非空启动参数（优先于环境变量）
./xiaohongshu-mcp-darwin-arm64 -token=your-secret-token
go run . -token=your-secret-token

启用鉴权后，所有 MCP 客户端都必须配置自定义请求头 Authorization: Bearer <token>。命令行参数可能被进程列表看到，部署环境优先使用 AUTH_TOKEN。

例如，支持自定义请求头的 MCP 客户端可使用以下配置：

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "headers": { "Authorization": "Bearer your-secret-token" }
    }
  }
}

1.4. 验证 MCP

npx @modelcontextprotocol/inspector

运行后，打开红色标记的链接，配置 MCP inspector，输入 `http://localhos