xiaohongshu-mcp

MCP for 小红书/xiaohongshu.com。

我的博客文章：haha.ai/xiaohongshu-mcp

遇到任何问题，务必要先看各种疑难杂症。

上面的 疑难杂症 列表后，还是解决不了你的部署问题，那么强烈推荐使用我写的另外一个工具：xpzouying/x-mcp，这个工具不需要你进行部署，只需要通过浏览器插件就能驱动你的 MCP，对于非技术同学来说更加友好。

Star History

主要功能

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

1. 登录和检查登录状态

第一步必须，小红书需要进行登录。可以检查当前登录状态。

登录演示：

login.mp4

检查登录状态演示：

mcp_check_login.mp4

2. 发布图文内容

支持发布图文内容到小红书，包括标题、内容描述和图片。

图片支持方式：

支持两种图片输入方式：

HTTP/HTTPS 图片链接

["https://example.com/image1.jpg", "https://example.com/image2.png"]

本地图片绝对路径（推荐）

["/Users/username/Pictures/image1.jpg", "/home/user/images/image2.png"]

为什么推荐使用本地路径：

✅ 稳定性更好，不依赖网络
✅ 上传速度更快
✅ 避免图片链接失效问题
✅ 支持更多图片格式

发布图文帖子演示：

claude_push.mp4

3. 发布视频内容

支持发布视频内容到小红书，包括标题、内容描述和本地视频文件。

视频支持方式：

仅支持本地视频文件绝对路径：

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

功能特点：

✅ 支持本地视频文件上传
✅ 自动处理视频格式转换
✅ 支持标题、内容描述和标签
✅ 等待视频处理完成后自动发布

注意事项：

仅支持本地视频文件，不支持 HTTP 链接
视频处理时间较长，请耐心等待
建议视频文件大小不超过 1GB

4. 搜索内容

根据关键词搜索小红书内容。

搜索帖子演示：

mcp_search.mp4

5. 获取推荐列表

获取小红书首页推荐内容列表。

获取推荐列表演示：

mcp_list_notes.mp4

6. 获取帖子详情（包括互动数据和评论）

获取小红书帖子的完整详情，包括：

帖子内容（标题、描述、图片等）
用户信息
互动数据（点赞、收藏、分享、评论数）
评论列表及子评论

⚠️ 重要提示：

需要提供帖子 ID 和 xsec_token（两个参数缺一不可）
这两个参数可以从 Feed 列表或搜索结果中获取
必须先登录才能使用此功能

获取帖子详情演示：

get_feed_detail.mp4

7. 发表评论到帖子

支持自动发表评论到小红书帖子。

功能说明：

自动定位评论输入框
输入评论内容并发布
支持 HTTP API 和 MCP 工具调用

⚠️ 重要提示：

需要先登录才能使用此功能
需要提供帖子 ID、xsec_token 和评论内容
这些参数可以从 Feed 列表或搜索结果中获取

发表评论演示：

post_comment.mp4

8. 获取用户个人主页

获取小红书用户的个人主页信息，包括用户基本信息和笔记内容。

功能说明：

获取用户基本信息（昵称、简介、头像等）
获取关注数、粉丝数、获赞量统计
获取用户发布的笔记内容列表
支持 HTTP API 和 MCP 工具调用

⚠️ 重要提示：

需要先登录才能使用此功能
需要提供用户 ID 和 xsec_token
这些参数可以从 Feed 列表或搜索结果中获取

返回信息包括：

用户基本信息：昵称、简介、头像、认证状态
统计数据：关注数、粉丝数、获赞量、笔记数
笔记列表：用户发布的所有公开笔记

小红书基础运营知识

标题：（非常重要）小红书要求标题不超过 20 个字
正文：（非常重要）：正文不能超过 1000 个字
当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。
（低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。
Tags：现已支持。添加合适的Tags能带来更多的流量。
根据本人实操，小红书每天的发帖量应该是 50 篇。
（非常重要）小红书的同一个账号不允许在多个网页端登录，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。

风险说明

该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。
我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。

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

实操结果

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

一周左右的成果

1. 使用教程

1.1. 快速开始（推荐）

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

直接从 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），请确保网络连接正常。后续运行无需重复下载。

方式二：源码编译

源码编译安装详情

依赖 Golang 环境，安装方法请参考 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

方式三：使用 Docker 容器（最简单）

Docker 部署详情

使用 Docker 部署是最简单的方式，无需安装任何开发环境。

1. 从 Docker Hub 拉取镜像（推荐）

我们提供了预构建的 Docker 镜像，可以直接从 Docker Hub 拉取使用：

# 拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp

Docker Hub 地址：https://hub.docker.com/r/xpzouying/xiaohongshu-mcp

2. 使用 Docker Compose 启动（推荐）

我们提供了配置好的 docker-compose.yml 文件，可以直接使用：

# 下载 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. 自己构建镜像（可选）

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

4. 配置说明

Docker 版本会自动：

配置 Chrome 浏览器和中文字体
挂载 ./data 用于存储 cookies
挂载 ./images 用于存储发布的图片
暴露 18060 端口供 MCP 连接

详细使用说明请参考：Docker 部署指南

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

1.4. 验证 MCP

npx @modelcontextprotocol/inspector

运行后，打开红色标记的链接，配置 MCP inspector，输入 http://localhost:18060/mcp ，点击 Connect 按钮。

按照上面配置 MCP inspector 后，点击 List Tools 按钮，查看所有的 Tools。

1.5. 使用 MCP 发布

检查登录状态

发布图文

示例中是从 https://unsplash.com/ 中随机找了个图片做测试。

搜索内容

使用搜索功能，根据关键词搜索小红书内容：

2. MCP 客户端接入

本服务支持标准的 Model Context Protocol (MCP)，可以接入各种支持 MCP 的 AI 客户端。

2.1. 快速开始

启动 MCP 服务

# 启动服务（默认无头模式）
go run .

# 或者有界面模式
go run . -headless=false

服务将运行在：http://localhost:18060/mcp

验证服务状态

# 测试 MCP 连接
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

Claude Code CLI 接入

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

2.2. 支持的客户端

Claude Code CLI

官方命令行工具，已在上面快速开始部分展示：

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

Cursor

配置文件的方式

创建或编辑 MCP 配置文件：

项目级配置（推荐）：在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "小红书内容发布服务 - MCP Streamable HTTP"
    }
  }
}

全局配置：在用户目录创建 ~/.cursor/mcp.json (同样内容)。

使用步骤

确保小红书 MCP 服务正在运行
保存配置文件后，重启 Cursor
在 Cursor 聊天中，工具应该自动可用
可以通过聊天界面的 "Available Tools" 查看已连接的 MCP 工具

Demo

插件 MCP 接入：

调用 MCP 工具：（以检查登录状态为例）

VSCode

方法一：使用命令面板配置

按 Ctrl/Cmd + Shift + P 打开命令面板
运行 MCP: Add Server 命令
选择 HTTP 方式。
输入地址： http://localhost:18060/mcp，或者修改成对应的 Server 地址。
输入 MCP 名字： xiaohongshu-mcp。

方法二：直接编辑配置文件

工作区配置（推荐）：在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

查看配置：

确认运行状态。
查看 tools 是否正确检测。

Demo

以搜索帖子内容为例：

Google Gemini CLI

在 ~/.gemini/settings.json 或项目目录 .gemini/settings.json 中配置：

{
  "mcpServers": {
    "xiaohongshu": {
      "httpUrl": "http://localhost:18060/mcp",
      "timeout": 30000
    }
  }
}

更多信息请参考 Gemini CLI MCP 文档

MCP Inspector

调试工具，用于测试 MCP 连接：

# 启动 MCP Inspector
npx @modelcontextprotocol/inspector

# 在浏览器中连接到：http://localhost:18060/mcp

使用步骤：

使用 MCP Inspector 测试连接
测试 Ping Server 功能验证连接
检查 List Tools 是否返回 6 个工具

Cline

Cline 是一个强大的 AI 编程助手，支持 MCP 协议集成。

配置方法

在 Cline 的 MCP 设置中添加以下配置：

{
  "xiaohongshu-mcp": {
    "url": "http://localhost:18060/mcp",
    "type": "streamableHttp",
    "autoApprove": [],
    "disabled": false
  }
}

使用步骤

确保小红书 MCP 服务正在运行（http://localhost:18060/mcp）
在 Cline 中打开 MCP 设置
添加上述配置到 MCP 服务器列表
保存配置并重启 Cline
在对话中可以直接使用小红书相关功能

配置说明

url: MCP 服务地址
type: 使用 streamableHttp 类型以获得更好的性能
autoApprove: 可配置自动批准的工具列表（留空表示手动批准）
disabled: 设置为 false 启用此 MCP 服务

使用示例

配置完成后，可以在 Cline 中直接使用自然语言操作小红书：

帮我检查小红书登录状态

帮我发布一篇关于春天的图文到小红书，使用这张图片：/path/to/spring.jpg

搜索小红书上关于"美食"的内容

其他支持 HTTP MCP 的客户端

任何支持 HTTP MCP 协议的客户端都可以连接到：http://localhost:18060/mcp

基本配置模板：

{
  "name": "xiaohongshu-mcp",
  "url": "http://localhost:18060/mcp",
  "type": "http"
}

2.3. 可用 MCP 工具

连接成功后，可使用以下 MCP 工具：

check_login_status - 检查小红书登录状态（无参数）
publish_content - 发布图文内容到小红书（必需：title, content, images）
- images: 支持 HTTP 链接或本地绝对路径，推荐使用本地路径
publish_with_video - 发布视频内容到小红书（必需：title, content, video）
- video: 仅支持本地视频文件绝对路径
list_feeds - 获取小红书首页推荐列表（无参数）
search_feeds - 搜索小红书内容（需要：keyword）
get_feed_detail - 获取帖子详情（需要：feed_id, xsec_token）
post_comment_to_feed - 发表评论到小红书帖子（需要：feed_id, xsec_token, content）
user_profile - 获取用户个人主页信息（需要：user_id, xsec_token）

2.4. 使用示例

使用 Claude Code 发布内容到小红书：

示例 1：使用 HTTP 图片链接

帮我写一篇帖子发布到小红书上，
配图为：https://cn.bing.com/th?id=OHR.MaoriRock_EN-US6499689741_UHD.jpg&w=3840
图片是："纽西兰陶波湖的Ngātoroirangi矿湾毛利岩雕（© Joppi/Getty Images）"

使用 xiaohongshu-mcp 进行发布。

示例 2：使用本地图片路径（推荐）

帮我写一篇关于春天的帖子发布到小红书上，
使用这些本地图片：
- /Users/username/Pictures/spring_flowers.jpg
- /Users/username/Pictures/cherry_blossom.jpg

使用 xiaohongshu-mcp 进行发布。

示例 3：发布视频内容

帮我写一篇关于美食制作的视频发布到小红书上，
使用这个本地视频文件：
- /Users/username/Videos/cooking_tutorial.mp4

使用 xiaohongshu-mcp 的视频发布功能。

发布结果：

3. 🌟 实战案例展示 (Community Showcases)

💡 强烈推荐查看：这些都是社区贡献者的真实使用案例，包含详细的配置步骤和实战经验！

📚 完整教程列表

n8n 完整集成教程 - 工作流自动化平台集成
Cherry Studio 完整配置教程 - AI 客户端完美接入
Claude Code + Kimi K2 接入教程 - Claude Code 门槛太高，那么就接入 Kimi 国产大模型吧～
AnythingLLM 完整指南 - AnythingLLM 是一款 all-in-one 多模态 AI 客户端，支持 workflow 定义，支持多种大模型和插件扩展。

🎯 提示: 点击上方链接查看详细的图文教程，快速上手各种集成方案！

📢 欢迎贡献: 如果你有新的集成案例，欢迎提交 PR 分享给社区！

4. 小红书 MCP 互助群

重要：在群里问问题之前，请一定要先仔细看完 README 文档以及查看 Issues。

【飞书3群】：扫码进入	【微信群 9 群】：扫码进入

🙏 致谢贡献者 ✨

感谢以下所有为本项目做出贡献的朋友！（排名不分先后）

_zy 💻 🤔 📖 🎨 🚧 🚇 👀	_clearwater 💻	_Zhongpeng 💻	_{Duong Tran} 💻	_Angiin 💻	_{Henan Mu} 💻	_Journey 💻
_{Eve Yu} 💻	_CooperGuo 💻	_{Banghao Chi} 💻	_varz1 💻	_{Melo Y Guan} 💻	_lmxdawn 💻	_haikow 💻
_Carlo 💻	_hrz 💻

✨ 特别感谢

贡献者
@wanpengxie

本项目遵循 all-contributors 规范。欢迎任何形式的贡献！

赞赏支持

欢迎请作者喝杯咖啡～（随缘支持，感谢！）

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

通过支付宝向 [email protected] 赞赏。

微信：

Name		Name	Last commit message	Last commit date
Latest commit History 153 Commits
.claude		.claude
.cursor		.cursor
.github		.github
.vscode		.vscode
assets		assets
browser		browser
cmd/login		cmd/login
configs		configs
cookies		cookies
deploy/macos		deploy/macos
docker		docker
docs		docs
donate		donate
errors		errors
examples		examples
pkg/downloader		pkg/downloader
xiaohongshu		xiaohongshu
.all-contributorsrc		.all-contributorsrc
.dockerignore		.dockerignore
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
README.md		README.md
README_EN.md		README_EN.md
app_server.go		app_server.go
go.mod		go.mod
go.sum		go.sum
handlers_api.go		handlers_api.go
main.go		main.go
mcp_handlers.go		mcp_handlers.go
mcp_server.go		mcp_server.go
middleware.go		middleware.go
routes.go		routes.go
service.go		service.go
types.go		types.go

Uh oh!

xpzouying/xiaohongshu-mcp

Folders and files

Latest commit

History

Repository files navigation

xiaohongshu-mcp

Star History

1. 使用教程

1.1. 快速开始（推荐）

1.2. 登录

1.3. 启动 MCP 服务

1.4. 验证 MCP

1.5. 使用 MCP 发布

检查登录状态

发布图文

搜索内容

2. MCP 客户端接入

2.1. 快速开始

启动 MCP 服务

验证服务状态

Claude Code CLI 接入

2.2. 支持的客户端

配置文件的方式

使用步骤

方法一：使用命令面板配置

方法二：直接编辑配置文件

配置方法

使用步骤

配置说明

使用示例

2.3. 可用 MCP 工具

2.4. 使用示例

3. 🌟 实战案例展示 (Community Showcases)

📚 完整教程列表

4. 小红书 MCP 互助群

🙏 致谢贡献者 ✨

✨ 特别感谢

赞赏支持

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 31

Sponsor this project

Uh oh!

Packages 0

Contributors 19

Languages

Packages