xpzouying/xiaohongshu-mcp

项目介绍

这是一个面向小红书的 MCP（Model Context Protocol）服务端。它把登录状态检查、图文发布、视频发布、搜索内容、获取推荐列表、读取帖子详情与评论、发表和回复评论、点赞、收藏、获取用户主页等操作封装成 MCP 工具，接入 Claude Code CLI、Cursor、VSCode、Gemini CLI、Cline 或 MCP Inspector 等客户端后，可以用自然语言完成这些操作。完整的工具列表见 MCP 工具说明。

服务依赖本机浏览器会话保存小红书登录状态。首次手动登录后，服务会复用 cookies，后续调用不需要每次重新登录。

快速使用

1. 从 GitHub Releases 下载对应平台的二进制文件，或从源码编译。预编译包覆盖 macOS Apple Silicon、Windows x64 和 Linux x64，macOS Intel 与 Linux ARM64 暂不支持。
2. 先运行登录工具：

chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64

3. 再启动 MCP 服务：

chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64

首次启动会自动下载无头浏览器（约 150 MB），需要网络可用。服务地址为 http://localhost:18060/mcp；需要查看浏览器界面时加 -headless=false。

4. 接入 MCP 客户端。以 Claude Code CLI 为例：

claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
claude mcp list

5. 使用 MCP Inspector 验证：

npx @modelcontextprotocol/inspector

连接 http://localhost:18060/mcp 后点击 List Tools，配置正确时应能看到 13 个工具。

也可以使用 Docker：docker compose -f docker/docker-compose.yml up -d 启动默认无界面版；GUI 版通过 docker/novnc/compose.yml 启动，浏览器桌面在 6080 端口，MCP 地址相同。

使用约束

• 小红书必须登录；部分工具还需要 feed_id 和 xsec_token，这两个参数要从推荐流或搜索结果中取得。
• 同一小红书账号不能同时登录多个网页端。登录当前 MCP 后，不要再在其他网页端登录该账号，否则当前会话会被踢出；查看账号信息可以用移动 App。
• 图文发布支持 HTTP/HTTPS 图片链接和本地绝对路径，推荐使用本地路径。视频发布只接受本地视频文件的绝对路径，不支持 HTTP 链接；README 建议视频不超过 1 GB，处理时间较长。
• 标题不超过 20 个字、正文不超过 1000 个字；README 也提醒注意违禁词和平台不允许的引流、搬运内容。
• 可选鉴权通过 AUTH_TOKEN 环境变量或 -token 启动参数开启，启用后所有 MCP 客户端都要带 Authorization: Bearer <token> 请求头。命令行参数可能出现在进程列表中，部署环境优先使用环境变量。代理通过 XHS_PROXY 配置，支持 HTTP、HTTPS 和 SOCKS5。
• GUI 版 Docker 没有独立密码，只应通过本机或 SSH 转发访问，不要直接暴露公网。
• 项目采用 Apache-2.0 许可证。

HotRepo 点评

项目在 2026-11-02 进入 Go 语言日榜，当天排名第 16、新增 37 Star；该快照记录的总数为 16,742 Star、2,458 Fork。这个体量说明项目已经积累了相当规模的关注和使用基础，但它属于高度依赖账号状态和平台规则的工具，接入真实账号前需要先确认登录方式、发布限制和内容合规要求。