摘要
1) 一句话总结 xiaohongshu-mcp 是一个基于 Go 语言开源的 MCP 接口服务，充当 AI 客户端与小红书之间的桥梁，支持通过自然语言实现小红书的内容检索、数据获取与自动化发布。
2) 核心要点
- 技术栈与部署：使用 Go 语言开发，提供预编译二进制文件、源码编译以及 Docker 镜像（内置 Chrome 浏览器和中文字体），默认运行在本地
18060端口。 - 生态兼容性：基于标准 MCP 协议，可无缝接入 Claude Code、Cursor、VSCode、n8n、AnythingLLM 等多种 AI 工具与工作流平台。
- 自动化发布：支持发布图文（支持网络链接或本地绝对路径图片）和视频（仅支持本地绝对路径，内置自动格式转换）。
- 数据检索与互动：支持关键词搜索、获取首页推荐、抓取帖子详情（含评论与互动数据）、自动发表评论以及获取指定用户主页数据。
- 账号管理：首次使用需通过配套工具手动登录以保存 Cookies 状态，后续操作依赖此状态。
- 用户友好替代方案：针对非技术用户，项目方提供了基于浏览器插件的免部署替代工具（x-mcp）。
3) 风险与限制
- 平台规则限制：小红书发帖标题不能超过 20 个字，正文不能超过 1000 个字。
- 多端登录互踢风险：同一账号在多个网页端同时登录会导致互踢，若在其他浏览器登录网页版会导致 MCP 服务掉线（建议使用移动 App 查看状态）。
- 参数强依赖：获取帖子详情、发表评论、获取用户主页等高级功能必须在登录状态下进行，且强依赖
feed_id（或user_id）和xsec_token参数。 - 视频发布限制：视频发布不支持网络链接，且处理时间较长，建议文件大小不超过 1GB。
- 风控与异常风险：存在 Cookies 过期需重新登录的情况；若提示发布成功但未显示，可能因账号被风控限制网页版发布权限，或因图片过大、路径含中文字符、网络图片失效等原因导致。
- 合规风险：项目仅供学习目的，明确禁止用于一切违法行为。
功能与定位
xiaohongshu-mcp 是一个为小红书（xiaohongshu.com）提供标准 Model Context Protocol (MCP) 接口的开源服务。它的核心定位是充当 AI 与小红书平台之间的桥梁，允许各类支持 MCP 协议的 AI 客户端（如 Claude Code、Cursor、VSCode 等）通过自然语言指令，直接对小红书进行内容检索、数据获取以及自动化发布等操作。
典型使用场景
- AI 自动化运营：利用大模型生成图文或视频内容后，直接通过指令触发自动发布，实现自媒体账号的半自动化或全自动化运营。
- 内容检索与分析：在 AI 编程助手或对话客户端中，直接通过自然语言搜索小红书的帖子、获取首页推荐列表或抓取特定用户的个人主页数据。
- 互动管理：通过 AI 自动获取帖子详情（含互动数据和评论）并进行自动回复或评论。
核心功能
- 账号登录与状态管理：支持手动登录以保存小红书状态，并提供检查当前登录状态的接口。
- 图文内容发布：支持发布带标题、正文描述和标签的图文帖子。图片支持 HTTP/HTTPS 网络链接或本地绝对路径（推荐使用本地路径以提升稳定性和速度）。
- 视频内容发布：支持本地视频文件的自动格式转换与上传发布（仅支持本地绝对路径）。
- 内容搜索与推荐：可根据关键词搜索小红书内容，或获取小红书首页的推荐内容列表。
- 帖子详情与互动获取：提供获取帖子完整详情（标题、描述、图片、用户信息、点赞/收藏/分享/评论数及子评论）的功能。
- 自动发表评论：支持自动定位评论框并向指定帖子发送评论内容。
- 用户主页数据获取：可获取指定用户的基本信息（昵称、简介、头像）、统计数据（关注、粉丝、获赞）以及公开发布的笔记列表。
特色与差异点
- 广泛的生态兼容性：基于标准 MCP 协议，可无缝接入 Claude Code CLI、Cursor、VSCode、Google Gemini CLI、Cline、n8n、Cherry Studio、AnythingLLM 等多种 AI 工具与工作流平台。
- 灵活的部署方式：提供开箱即用的预编译二进制文件、Docker 镜像（内置 Chrome 浏览器和中文字体）以及源码编译选项。支持无头模式（Headless）和带浏览器界面模式。
- 非技术用户友好替代方案：针对部署困难的用户，项目方提供了基于浏览器插件的免部署替代工具（x-mcp）。
- 公益性质：项目接受的赞赏支持均用于慈善捐赠，并公开捐赠记录。
使用方式概览
- 环境准备与启动：通过二进制文件、Docker 或源码启动 MCP 服务（默认运行在本地
18060端口）。 - 首次登录：首次使用需运行配套的登录工具，手动完成小红书登录以保存 Cookies 状态。
- 客户端接入：在支持 MCP 的 AI 客户端配置文件中，添加该服务的 HTTP 地址（如
http://localhost:18060/mcp）。 - 自然语言交互：配置完成后，用户可直接向 AI 下达指令（例如：“帮我写一篇关于春天的帖子并使用本地图片发布到小红书”），AI 将自动调用对应的 MCP 工具完成操作。
限制与注意事项
- 平台规则限制：小红书要求发帖标题不超过 20 个字，正文不超过 1000 个字。
- 多端登录互踢风险：同一小红书账号不允许在多个网页端同时登录。若 MCP 服务已登录，在其他浏览器再次登录网页版会导致 MCP 账号被“踢出”。建议使用移动 App 端查看账号状态。
- 高级功能参数依赖：获取帖子详情、发表评论、获取用户主页等功能，必须在登录状态下进行，且强依赖
feed_id（或user_id）和xsec_token参数（可从搜索或推荐列表中获取）。 - 视频发布限制：视频发布仅支持本地文件，不支持网络链接；处理时间较长，建议文件大小不超过 1GB。
- 风控与运行异常：
- 存在 Cookies 过期需重新登录的情况。
- 若提示发布成功但未显示，可能是账号被风控限制了网页版发布权限，或图片过大、图片路径包含中文字符、网络图片无法访问等原因。
- 合规声明：项目基于学习目的开源，明确禁止用于一切违法行为。