xpzouying/xiaohongshu-mcp
MCP for xiaohongshu.com
xiaohongshu-mcp – 面向小红书（Xiaohongshu）的AI驱动桥接器
简介 – 一个自托管服务，实现模型上下文协议（MCP），让AI助手（Claude Code、Cursor、VS Code、Open Claw等）能够读写中国社交平台小红书。它公开了一组JSON-RPC工具（登录、发布帖子、搜索、评论、点赞、收藏、获取用户资料等），可从任何兼容MCP的客户端调用。
核心能力
| 工具 | 功能 |
|---|---|
check_login_status |
返回小红书账号是否已登录。 |
get_login_qrcode |
生成用于交互式登录的二维码（Base64）。 |
publish_content |
发布图文帖子（标题、正文、图片URL或本地路径、可选标签、定时、可见性、商品链接）。 |
publish_with_video |
发布视频帖子（标题、正文、本地视频文件、可选标签、定时、可见性）。 |
list_feeds |
获取首页推荐信息流。 |
search_feeds |
按关键词搜索小红书，支持排序、类型、时间范围筛选等。 |
get_feed_detail |
获取完整帖子详情，包括作者信息、互动数和评论。 |
post_comment_to_feed / reply_comment_in_feed |
添加评论或回复特定评论。 |
like_feed / favorite_feed |
对帖子点赞/取消点赞或收藏/取消收藏。 |
user_profile |
获取用户个人资料及其公开笔记。 |
快速开始
1. 选择部署方法
| 方法 | 适用人群 |
|---|---|
预编译二进制 – 从Releases页面下载相应的xiaohongshu-mcp和xiaohongshu-login可执行文件（macOS Apple Silicon、Windows x64、Linux x64）。 |
|
Docker – 拉取官方镜像xpzouying/xiaohongshu-mcp并运行（暴露端口18060，挂载./data用于Cookie，./images用于上传媒体）。 |
|
从源码构建 – 需要Go 1.22+；将GOPROXY设置为中国镜像，然后运行go build ./cmd/mcp和go build ./cmd/login。 |
2. 登录一次
# 运行登录辅助程序（选择与操作系统匹配的二进制文件）
./xiaohongshu-login-<platform>
会打开无头Chromium实例，您扫描二维码或输入凭据。该工具会将Cookie保存在data/下，因此后续MCP调用将经过身份验证。
3. 启动MCP服务器
# 默认无头模式（无界面）
./xiaohongshu-mcp-<platform>
# 或使用可见浏览器进行调试
./xiaohongshu-mcp-<platform> -headless=false
服务监听于http://localhost:18060/mcp。
4. （可选）保护端点
设置环境变量AUTH_TOKEN=your-secret或使用-token=your-secret启动二进制文件。客户端随后必须发送Authorization: Bearer <token>。
连接AI客户端（以Claude Code为例）
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
claude mcp list # 应显示服务器已连接
现在任何Claude提示词都可以调用这些工具，例如：
帮我检查小红书登录状态
助手将调用check_login_status并报告结果。
Cursor（.cursor/mcp.json）、VS Code（.vscode/mcp.json）、Open Claw（通过MCPorter）、Google Gemini CLI、Cline等也有类似步骤。
典型工作流程示例
- 发布图片帖子
帮我写一篇关于春天的笔记，标题《春日漫步》，内容随意，配图 /Users/me/Pictures/flowers.jpg，使用 xiaohongshu-mcp 发布。 - 搜索与食物相关的笔记
在小红书上搜索“川菜”，只要图文笔记，按最新排序，使用 xiaohongshu-mcp。 - 自动评论
给笔记 123456 的评论 987654 回复‘谢谢分享’，使用 xiaohongshu-mcp。
社区与支持
- 问题与故障排查 – 有关常见Docker/Windows问题的精选列表，请参见issue #56。
- Docker镜像 – 从Docker Hub拉取；仓库包含用于一键启动的
docker-compose.yml。 - 贡献 – 参见
CONTRIBUTING.md；该项目遵循All-Contributors模型（31位贡献者）。 - 捐赠 – 所有收益用于慈善（参见
DONATIONS.md）。
许可证与免责声明
README指出该软件仅供学习和自动化使用；禁止滥用（垃圾邮件、非法内容）。未显示明确的许可证徽章，请查看仓库的LICENSE文件以了解确切条款。
TL;DR
xiaohongshu-mcp是一个基于Go、支持Docker的MCP服务器，让现代AI助手能够对小红书执行操作——登录、发布图片或视频、搜索、评论、点赞以及获取用户数据——全部通过标准JSON-RPC接口。通过二进制、Docker或源码安装，登录一次，启动服务器，并将任何兼容MCP的AI工具指向http://localhost:18060/mcp。
相关
- 项目
- 项目
- 项目
- 项目
- 项目