xpzouying/xiaohongshu-mcp

xiaohongshu‑mcp

是什么 – 一个将小红书（Xiaohongshu）社交平台作为 Model Context Protocol（MCP）服务器暴露的自托管服务。通过运行该服务器，AI助手（Claude Code、Cursor、VS Code、Open Code、Cline 等）可以调用小红书的功能，如登录、发布内容、搜索、点赞/收藏、评论，以及获取用户或帖子的详细信息。

核心功能

登录管理 – 支持二维码登录、Cookie 处理、状态检查、Cookie 重置。
内容发布 – 发布图文笔记（标题、正文、图片）或视频笔记（标题、正文、本地视频）。支持标签、定时发布、可见性选项和商品链接。
动态操作 – 获取首页推荐列表、按关键词搜索并加过滤条件、获取完整帖子详情（含评论和互动数据）、点赞/取消点赞、收藏/取消收藏。
社交互动 – 发布评论、回复特定评论、获取用户个人资料及其发布的笔记。
MCP 集成 – 所有功能均以标准 MCP 工具形式暴露（如 check_login_status、publish_content、search_feeds 等），任何 MCP 兼容客户端均可调用。

如何运行

预构建二进制文件 – 从 Releases 页面下载适用于 macOS Apple Silicon、Windows x64 或 Linux x64 的可执行文件。先运行一次 xiaohongshu-login-* 二进制文件完成登录，再启动 xiaohongshu-mcp-*。
Docker – 拉取镜像 xpzouying/xiaohongshu-mcp，使用提供的 docker-compose.yml 启动。容器会自动安装无头 Chromium 浏览器，挂载 ./data 用于存储 Cookie，./images 用于上传媒体，并暴露端口 18060。
从源码构建 – 需要 Go 1.20+。设置 GOPROXY（如 https://goproxy.cn），然后运行 go build ./...。

典型使用流程

# 1. 登录（每个会话只需一次）
./xiaohongshu-login-darwin-arm64   # 或 Windows/Linux 二进制文件

# 2. 启动 MCP 服务器（默认无头模式）
./xiaohongshu-mcp-darwin-arm64
#   → 监听 http://localhost:18060/mcp

# 3. 使用 MCP 检查器验证
npx @modelcontextprotocol/inspector
#   → 连接到上述 URL 并列出可用工具

连接 AI 客户端 – 将服务器地址（http://localhost:18060/mcp）添加到客户端的 MCP 配置中。示例包括：

Claude Code CLI（claude mcp add …）
Open Code CLI（交互式 opencode mcp add）
Cursor（.cursor/mcp.json）
VS Code（.vscode/mcp.json）
Google Gemini CLI、Cline 以及任意通用 HTTP-MCP 客户端。

安全与可选认证

默认情况下服务器仅在本地主机开放。生产环境请设置 AUTH_TOKEN（或 -token 标志），并让客户端发送 Authorization: Bearer <token>。
通过 XHS_PROXY（HTTP/HTTPS/SOCKS5）支持代理，适用于需要出站路由的环境。

社区与支持

29 位贡献者（All‑Contributors 标志）。
Docker 拉取统计、星标历史图表，以及专用的捐赠页面（所有收益将捐赠给慈善机构）。
详尽的故障排除指南（Issue #56）和专为非技术用户设计的浏览器扩展版本（xpzouying/x-mcp）。

谁可能使用它

需要读取或发布小红书内容的 AI 代理开发者。
希望通过提示词自动化发布、评论或数据采集的内容创作者。
正在实验社交平台驱动的 LLM 工作流的研究人员。

以上所有细节均直接来自仓库的 README；未推断任何额外功能。

xpzouying/xiaohongshu-mcp

xiaohongshu‑mcp

相关