xiaohongshu-mcp：小红书 MCP 服务完全指南
xiaohongshu-mcp：小红书 MCP 服务完全指南
§1 学习目标
完成本文档后，你将能够：
- ✅ 理解 xiaohongshu-mcp 的核心定位与设计理念
- ✅ 掌握 xiaohongshu-mcp 的完整功能体系
- ✅ 熟练部署 xiaohongshu-mcp（Binary/Docker/源码）
- ✅ 配置多客户端接入（Claude Code/Cursor/Cline/OpenClaw）
- ✅ 使用 MCP 工具发布小红书内容（图文/视频）
- ✅ 使用搜索和内容获取功能
- ✅ 进行评论互动（发表评论/回复评论/点赞/收藏）
- ✅ 排查常见问题
- ✅ 为 xiaohongshu-mcp 贡献代码
§2 项目概述
2.1 什么是 xiaohongshu-mcp？
xiaohongshu-mcp（官方仓库：xpzouying/xiaohongshu-mcp）是一个基于 Model Context Protocol (MCP) 的小红书服务端实现，让你的 AI 助手直接访问小红书数据。
官方描述：
MCP for 小红书 / xiaohongshu.com。让你的 AI 助手直接访问小红书数据。
翻译：xiaohongshu-mcp 是一个 MCP 协议服务端，用于小红书平台。它允许 AI 助手（如 Claude Code、Cursor 等）直接操作用户的小红书账号，包括发布内容、搜索、评论、获取用户信息等功能。
2.2 核心价值主张
| 价值 | 说明 |
|---|---|
| AI 驱动 | 让 AI 助手直接操作用户小红书账号 |
| MCP 协议 | 标准化接口，支持多种 AI 客户端 |
| 全功能 | 发布图文/视频、搜索、评论、点赞、收藏等 |
| 多客户端 | Claude Code/Cursor/Cline/OpenClaw 等 |
| 开源透明 | 代码开源，慈善捐赠模式 |
| 活跃社区 | 微信群 20+ 群、飞书群 4 个、33 位贡献者 |
2.3 核心数据
Stars: 12,400 (12.4k)
Forks: 1,900 (1.9k)
Watchers: 33
贡献者: 33 人
提交数: 340+ 次
发布版本: 90 个
最新版本: v2026.03.09.0605-0e16f4b (2026-03-09)
语言: Go 71.3%, Python 27.5%2.4 项目定位
xiaohongshu-mcp 填补了 AI 助手与小红书平台之间的Gap。通过 MCP 协议，AI 助手可以像人类一样操作小红书账号，实现自动化运营、内容发布、社群互动等功能。
§3 核心功能详解
3.1 内容发布
3.1.1 发布图文
publish_content 工具用于发布图文内容到小红书：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
title | string | ✅ | 标题（不超过 20 字） |
content | string | ✅ | 正文（不超过 1000 字） |
images | string[] | ✅ | 图片路径列表（至少 1 张），支持 HTTP 链接或本地绝对路径 |
tags | string[] | 可选 | 话题标签列表，如 ["美食", "旅行"] |
schedule_at | string | 可选 | 定时发布时间，ISO8601 格式，支持 1 小时至 14 天内 |
is_original | boolean | 可选 | 是否声明原创，默认 false |
visibility | string | 可选 | 可见范围：公开可见（默认）/ 仅自己可见 / 仅互关好友可见 |
products | string[] | 可选 | 商品关键词列表，用于绑定带货商品 |
3.1.2 发布视频
publish_with_video 工具用于发布视频内容：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
title | string | ✅ | 标题 |
content | string | ✅ | 正文 |
video | string | ✅ | 本地视频文件绝对路径（仅支持单个视频文件） |
tags | string[] | 可选 | 话题标签列表 |
schedule_at | string | 可选 | 定时发布时间 |
visibility | string | 可选 | 可见范围 |
products | string[] | 可选 | 商品关键词列表 |
3.2 登录与认证
3.2.1 检查登录状态
check_login_status 用于检查当前小红书账号的登录状态（无参数）。
3.2.2 获取登录二维码
get_login_qrcode 用于获取登录二维码，返回 Base64 图片和超时时间（无参数）。
3.2.3 删除 Cookies
delete_cookies 用于删除 cookies 文件，重置登录状态，删除后需要重新登录（无参数）。
⚠️ 重要提示：
- 小红书同一账号不允许在多个网页端登录
- 登录 MCP 后，不要在其它网页端登录该账号，否则会被"踢出登录"
- 可以使用移动 App 端查看账号信息
3.3 内容获取
3.3.1 获取首页推荐
list_feeds 用于获取小红书首页推荐列表（无参数）。
3.3.2 搜索内容
search_feeds 用于搜索小红书内容：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
keyword | string | ✅ | 搜索关键词 |
filters.sort_by | string | 可选 | 排序依据：综合（默认）/ 最新 / 最多点赞 / 最多评论 / 最多收藏 |
filters.note_type | string | 可选 | 笔记类型：不限（默认）/ 视频 / 图文 |
filters.publish_time | string | 可选 | 发布时间：不限（默认）/ 一天内 / 一周内 / 半年内 |
filters.search_scope | string | 可选 | 搜索范围：不限（默认）/ 已看过 / 未看过 / 已关注 |
filters.location | string | 可选 | 位置距离：不限（默认）/ 同城 / 附近 |
3.3.3 获取帖子详情
get_feed_detail 用于获取帖子详情：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
feed_id | string | ✅ | 帖子 ID |
xsec_token | string | ✅ | 安全令牌 |
load_all_comments | boolean | 可选 | 是否加载全部评论，默认 false 仅返回前 10 条一级评论 |
limit | number | 可选 | 限制加载的一级评论数量，默认 20 |
click_more_replies | boolean | 可选 | 是否展开二级回复，默认 false |
reply_limit | number | 可选 | 跳过回复数过多的评论阈值，默认 10 |
scroll_speed | string | 可选 | 滚动速度：slow / normal / fast |
3.4 评论互动
3.4.1 发表评论
post_comment_to_feed 用于发表评论到小红书帖子：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
feed_id | string | ✅ | 帖子 ID |
xsec_token | string | ✅ | 安全令牌 |
content | string | ✅ | 评论内容 |
3.4.2 回复评论
reply_comment_in_feed 用于回复帖子下的指定评论：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
feed_id | string | ✅ | 帖子 ID |
xsec_token | string | ✅ | 安全令牌 |
content | string | ✅ | 回复内容 |
comment_id 或 user_id | string | ✅ | 评论 ID 或用户 ID（至少提供一个） |
3.5 点赞与收藏
3.5.1 点赞
like_feed 用于点赞或取消点赞：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
feed_id | string | ✅ | 帖子 ID |
xsec_token | string | ✅ | 安全令牌 |
unlike | boolean | 可选 | true 为取消点赞，默认为点赞 |
3.5.2 收藏
favorite_feed 用于收藏或取消收藏：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
feed_id | string | ✅ | 帖子 ID |
xsec_token | string | ✅ | 安全令牌 |
unfavorite | boolean | 可选 | true 为取消收藏，默认为收藏 |
3.6 用户信息
user_profile 用于获取用户个人主页信息：
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
user_id | string | ✅ | 用户 ID |
xsec_token | string | ✅ | 安全令牌 |
§4 安装与部署
4.1 方案 A：下载预编译二进制文件（推荐）
4.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 |
4.1.2 安装步骤
# 1. 赋予执行权限
chmod +x xiaohongshu-mcp-darwin-arm64
chmod +x xiaohongshu-login-darwin-arm64
# 2. 运行登录工具
./xiaohongshu-login-darwin-arm64
# 3. 启动 MCP 服务（无头模式，无浏览器界面）
./xiaohongshu-mcp-darwin-arm64
# 4. 或者启动 MCP 服务（非无头模式，有浏览器界面）
./xiaohongshu-mcp-darwin-arm64 -headless=false⚠️ 重要提示：首次运行时会自动下载无头浏览器（约 150MB），请确保网络连接正常。
4.1.3 配置代理（可选）
如果需要通过代理访问小红书，可以设置 XHS_PROXY 环境变量：
# 设置代理后启动
XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64
# 支持 HTTP/HTTPS/SOCKS5 代理
# 日志中会自动隐藏代理的认证信息4.2 方案 B：源码编译
# 克隆仓库
git clone https://github.com/xpzouying/xiaohongshu-mcp.git
cd xiaohongshu-mcp
# 编译 MCP 主程序
go build -o xiaohongshu-mcp .
# 编译登录工具
go build -o xiaohongshu-login ./cmd/login
# 运行登录
./xiaohongshu-login
# 运行 MCP 服务
./xiaohongshu-mcp4.3 方案 C：Docker 部署（最简单）
# 拉取镜像
docker pull xpzouying/xiaohongshu-mcp:latest
# 运行容器
docker run -d \
--name xiaohongshu-mcp \
-p 18060:18060 \
xpzouying/xiaohongshu-mcp:latest
# 非无头模式
docker run -d \
--name xiaohongshu-mcp \
-p 18060:18060 \
xpzouying/xiaohongshu-mcp:latest \
-headless=false⚠️ Docker 环境提示：在 Docker 环境下，请使用 http://host.docker.internal:18060/mcp 而非 http://localhost:18060/mcp。
4.4 方案 D：OpenClaw 深度集成
对于已部署本项目的用户，可以使用 OpenClaw 集成：
| 版本 | 仓库 | 说明 |
|---|---|---|
| xiaohongshu-mcp-skills | autoclaw-cc/xiaohongshu-mcp-skills | 适用于已部署完本项目的用户 |
| xiaohongshu-skills | autoclaw-cc/xiaohongshu-skills | 开箱即用版 |
§5 客户端接入
5.1 Claude Code CLI 接入
# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
# 检查 MCP 是否添加成功
claude mcp list5.2 Cursor 接入
参考 .cursor 目录配置。
5.3 Cline 接入
在 Cline 设置中添加 MCP 服务器配置。
5.4 验证 MCP 连接
使用 MCP Inspector 验证连接：
npx @modelcontextprotocol/inspector打开 Inspector 后，配置 MCP endpoint 为 http://localhost:18060/mcp，点击 Connect，然后点击 List Tools 查看所有可用工具。
5.5 支持的客户端一览
| 客户端 | 支持情况 | 说明 |
|---|---|---|
| Claude Code CLI | ✅ 官方推荐 | 最稳定 |
| Cursor | ✅ 支持 | MCP Streamable HTTP |
| Cline | ✅ 支持 | MCP 协议 |
| OpenClaw | ✅ 支持 | 深度集成 |
| n8n | ✅ 社区教程 | 工作流自动化 |
| Cherry Studio | ✅ 社区教程 | AI 客户端 |
| AnythingLLM | ✅ 社区教程 | 多模态 AI |
| Kimi K2 | ✅ 社区教程 | Claude Code 门槛太高时的替代 |
§6 使用示例
6.1 使用 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 进行发布。6.2 使用 Claude Code 发布视频
帮我写一篇关于美食制作的视频发布到小红书上，使用这个本地视频文件：
- /Users/username/Videos/cooking_tutorial.mp4
使用 xiaohongshu-mcp 的视频发布功能。6.3 搜索小红书内容
帮我搜索一下最近关于 AI 写作的小红书帖子，看看有哪些热门内容。6.4 评论互动
帮我给我刚发布的那篇小红书帖子添加一条评论："写得真好，收藏了！"§7 小红书运营须知
7.1 内容规范
| 项目 | 要求 |
|---|---|
| 标题 | 不超过 20 个字 |
| 正文 | 不超过 1000 个字 |
| 配图 | 从推荐角度看，图文的流量比视频和纯文字更好 |
| Tags | 添加合适的 Tags 能带来更多流量 |
| 每日发帖 | 建议每天 50 篇以内 |
7.2 风险说明
账号安全：项目原作者的账号稳定运行一年多，没有出现过封号，只有 Cookies 过期需要重新登录的情况
实名认证：如果账号没有实名认证，特别是新号，一般会触发实名认证的消息提醒（不是封号）
违禁词：曝光低的话，首先检查内容是否有违禁词
引流限制：一定不要出现引流、纯搬运的情况，属于官方重点打击对象
多设备登录：小红书同一账号不允许在多个网页端登录，登录 MCP 后会被踢出
§8 项目结构
8.1 目录结构
| 目录 | 说明 |
|---|---|
.cursor | Cursor IDE 配置 |
.github | GitHub 配置 |
.vscode | VS Code 配置 |
assets | 资源文件（截图、演示） |
browser | 无头浏览器相关代码 |
cmd/login | 登录工具源码 |
configs | 配置文件 |
cookies | Cookies 存储 |
deploy/macos | macOS 部署配置 |
docker | Docker 相关文件 |
docs | 文档 |
donate | 捐赠记录 |
errors | 错误定义 |
examples | 集成示例（n8n、Cherry Studio、AnythingLLM 等） |
pkg | 核心包 |
skills/post-to-xhs | Skills 相关 |
xiaohongshu | 小红书核心逻辑 |
8.2 核心文件
| 文件 | 说明 |
|---|---|
main.go | 主入口 |
app_server.go | MCP 应用服务器 |
mcp_handlers.go | MCP 处理器 |
mcp_server.go | MCP 服务端 |
service.go | 业务逻辑服务 |
handlers_api.go | API 处理器 |
routes.go | 路由配置 |
middleware.go | 中间件 |
types.go | 类型定义 |
go.mod / go.sum | Go 依赖 |
§9 常见问题
Q1：为什么检查登录用户名显示异常？
A：用户名是写死的，不影响功能。
Q2：显示发布成功后，但实际上没有显示？
排查步骤：
- 使用非无头模式重新发布一次
- 更换不同的内容重新发布
- 登录网页版小红书，查看账号是否被风控限制网页版发布
- 检查图片大小是否过大
- 确认图片路径中没有中文字符
- 若使用网络图片地址，请确认图片链接可正常访问
Q3：程序出现闪退如何解决？
A：建议从源码安装，或使用 Docker 安装。
Q4：提示无法连接？
A：
- Docker 环境：请使用
http://host.docker.internal:18060/mcp - 非 Docker 环境：请使用本机 IPv4 地址访问
Q5：OpenClaw 接入有问题？
A：OpenClaw 的 AI 自动部署行为不在本项目维护范围内，MCPorter 作为中间层可能引入额外的兼容性问题。建议改用 Claude Code CLI、Cursor 或 Cline 等原生支持 HTTP MCP 的客户端。
§10 总结
10.1 核心优势
| 优势 | 说明 |
|---|---|
| MCP 标准化 | 符合 Model Context Protocol 协议 |
| 多客户端支持 | Claude Code/Cursor/Cline/OpenClaw 等 |
| 全功能覆盖 | 发布/搜索/评论/点赞/收藏/用户信息 |
| 多部署方式 | Binary/Docker/源码/OpenClaw |
| 活跃社区 | 微信群 20+、飞书群 4 个 |
| 慈善捐赠 | 所有赞赏用于慈善 |
10.2 适用场景
| 场景 | 推荐指数 |
|---|---|
| AI 内容创作自动化 | ⭐⭐⭐⭐⭐ |
| 小红书运营效率提升 | ⭐⭐⭐⭐⭐ |
| 多账号管理 | ⭐⭐⭐⭐ |
| 社群互动自动化 | ⭐⭐⭐⭐ |
| 内容分析与调研 | ⭐⭐⭐⭐ |
10.3 项目信息
| 项目 | 信息 |
|---|---|
| Stars | 12.4k |
| Forks | 1.9k |
| 贡献者 | 33 人 |
| 发布版本 | 90 个 |
| 最新版本 | v2026.03.09.0605-0e16f4b (2026-03-09) |
| 语言 | Go 71.3%, Python 27.5% |
10.4 相关资源
10.5 捐赠支持
本项目所有的赞赏都会用于慈善捐赠。捐赠时，请备注 MCP 以及名字。如需更正或撤回署名，请开 Issue 或通过邮箱联系 xpzouying@gmail.com。
文档版本 1.0 | 撰写日期：2026-03-31 | 基于 v2026.03.09.0605-0e16f4b (2026-03-09) | Stars: 12.4k ⭐