xiaohongshu-mcp

项目定位

xpzouying/xiaohongshu-mcp 是一个开源 MCP 服务，把小红书相关操作封装为标准化的工具接口，供 Claude Code、OpenClaw、n8n 等兼容客户端通过自然语言调用。它的定位是为 Agent 提供"结构化、可测试"的工具接口，而不是让模型直接理解网页并乱点。

主要能力

• 登录与会话管理：通过浏览器登录保存 Cookie，供 MCP 服务复用身份。
• 内容发布：接受标题、正文、标签以及本地图片或视频路径，发布图文或视频笔记。
• 内容检索：关键词搜索、读取笔记详情、互动数据。
• 内容互动：评论、收藏等操作。

技术栈与运行方式

• 服务端主要使用 Go 实现。
• 提供 Docker 启动与源码本地运行两种方式。
• 内置对 MCP Inspector 的支持，便于逐个验证工具的参数与返回。
• README 给出 Claude Code、OpenClaw、n8n 等客户端的配置示例。

推荐工作流（作者描述）

1. 启动 MCP 服务并完成小红书登录。
2. 用 MCP Inspector 验证工具列表、参数和返回结果。
3. 在客户端中配置服务地址。
4. 先调用读取、搜索等低风险动作，再测试草稿或发布流程。
5. 准备本地媒体文件的合法路径，等待视频处理完成。
6. 监控 Cookie、账号冲突、失败重试和平台限制。
7. 正式发布前人工检查事实、版权、标题、标签和账号风险。

已知限制

• 同一账号同时在多个网页端登录，可能使 MCP 会话失效。
• 视频必须使用本地绝对路径，处理较慢。
• 图片路径不宜包含中文字符。
• Cookie 过期需要重新登录。
• 自动发布涉及平台规则、账号风控、版权与事实准确性，必须由人工监督。

来源边界

功能与限制以 2026-07-13 可见的 README 为依据，不代表小红书官方授权，也不保证未来接口和风控规则保持不变。"稳定运行一年多"为作者自述。