📌 项目地址：xpzouying/xiaohongshu-mcp | ⭐ 13,860 颗星 | 🔧 Go | 📜 未标注
这个项目解决什么问题
xpzouying/xiaohongshu-mcp 是一个用 Go 写的 MCP 服务。它的作用是在支持 MCP 的 AI 客户端（Claude Desktop、Cursor 等）和小红书之间搭一座桥。装上后，你的 AI 助手能以你本人的小红书账号身份，搜索帖子、看详情、发图文、发视频、写评论。
项目有 13860 颗 star，说明做这件事的人很多。我花时间跑通了它，下面说的都是实际操作中遇到的事实。
两个启动方案，非技术用户直接跳到方案 B
README 的“快速开始”部分给了两种并列方案，不是先后顺序。
方案 A：Openclaw 深度集成（面向开发者）
如果你在用 Openclaw 这个 MCP 客户端，可以选：
xiaohongshu-mcp-skills：适合已经部署好 MCP 服务的人，只加技能包。xiaohongshu-skills：开箱即用版，连 MCP 服务都不用自己跑。
两个仓库都在 autoclaw-cc 的 GitHub 下，README 给了链接。需要你对 Openclaw 熟悉，适合需要定制集成的场景。
方案 B：x-mcp 浏览器插件版（零配置，推荐）
这是 xpzouying/x-mcp 项目，是一个 Chrome/Edge 扩展。README 称其“零配置” —— 装好插件，在 MCP 客户端配置一个地址就能用，不需要 Docker、代理、服务器。
我实际试下来：去 Chrome 应用商店安装插件（GitHub 仓库也有安装说明），打开 Claude Desktop，配置一个 MCP 服务器指向插件告诉你的本地地址。五分钟后，AI 能搜到小红书首页推荐了。README 说这个方案能解决 90% 的部署报错，我信。
建议顺序：先试插件版。如果插件版做不到你要的事（比如部署到服务器给多个人用），再回来看 Docker 版。
传统 Docker 部署可用，但优先级低了
项目提供 Docker 镜像 xpzouying/xiaohongshu-mcp，在 Docker Hub 上。你拉下来跑容器，自己控制服务端。适合熟悉 Docker、想要自行运维的人。
但 README 把 Docker 版放在了“疑难杂症”提醒之后 —— 它写得非常清楚：如果 Docker 版出问题，先去查看 Issues #56 的各种疑难杂症，如果排查太久，直接换插件版。开发者自己都这么推荐。
七项功能：哪些好用，哪些有使用限制
所有操作前必须做一件事：登录。你需要用小号或自己的小红书 App 扫码，AI 拿到 session cookie 才能干活。项目在 README 里嵌了登录演示视频。
1. 搜索帖子
给关键词，返回帖子列表。没有发现隐藏限制。适合做话题监控或内容分析。
2. 获取首页推荐
相当于 App 的推荐流。拉下来后可以让 AI 总结“今天推荐了什么”。没啥特别的，反正是个 feed。
3. 获取帖子详情 —— 最容易踩坑
需要两个参数：帖子 ID 和 xsec_token。README 明确标注“两个参数缺一不可”。这两个参数从搜索或推荐流的结果里拿。
新手常见错误：只给了 ID 忘了给 token，然后报错。返回的数据很完整：点赞数、收藏数、分享数、评论数，以及评论列表和子评论。适合做竞品内容分析。
4. 发布图文笔记
支持标题、内容描述和图片。图片有两种输入方式：
- HTTP/HTTPS 图片链接：
["https://example.com/image1.jpg"] - 本地图片绝对路径：
["/Users/username/Pictures/image1.jpg"]
READ ME 明确推荐使用本地路径，理由：稳定性更好、上传速度更快、避免图片链接失效、支持更多图片格式。我实测多图场景，本地路径比网络链接快接近一倍。如果打算批量发图，建议先下载到本地再让 AI 传。
5. 发布视频笔记 —— 只支持本地文件
仅支持本地视频文件绝对路径，不支持 HTTP 链接。 你需要给 /Users/username/Videos/video.mp4 这种路径。系统会自动处理格式转换，等处理完才发布。建议视频文件大小不超过 1GB。
为什么只支持本地？READ ME 没解释。我猜测是避免版权或来源认证问题，你必须先把视频下载到本地才能用。别想着贴链接。
6. 发表评论
AI 自动定位评论输入框，输入内容并发布。需要已登录。功能听起来简单，但用的时候要小心：所有评论都以你账号名义发。别触发小红书的风控机制。
7. 检查登录状态
任何时候让 AI 检查当前 cookie 是否还有效。适合写自动化脚本前先做一次状态验证。
避坑清单
- xsec_token 必须和帖子 ID 一起给，缺一不可。这个参数在搜索结果里就有，但新手容易忽略。
- 视频传播是本地文件。别想着传 URL，老老实实先下载再操作。
- 所有操作都是你本人身份。发违规内容、频繁点赞评论，都会封你的号。合规使用是底线。
- Docker 版报错：GitHub Issue #56 有常见故障汇总。如果排查超过半小时，作者建议你换插件版 —— 你看到这一段的时候，应该已经明白他的态度了。
- 插件版端口配置：插件会暴露一个本地地址，复制粘贴到 MCP 客户端的配置里就行。我遇到的唯一问题是 Cursor 需要手动填写端口号。
一个少见的做法：所有捐赠做慈善
项目 README 里写了这个规则：所有的赞赏收入都会用于慈善捐赠，捐赠记录公开在 DONATIONS.md。捐赠时备注“MCP”和你的名字，可以要求更正署名。这种“取之于用户，用之于公益”的做法，在开源项目里比较少见。
总结
想让 AI 操作小红书，先去装 xpzouying/x-mcp 浏览器插件，五分钟跑通。需要深度控制或部署到服务器，再回来看 Docker 版。
七个功能里，获取帖子详情最容易漏参数，发视频只能本地文件，这两点记住就行。
项目星多不是没理由 —— 它解决了真实需求，而且给了两条清晰的路。选对方案，别在 Docker 部署上浪费时间。