xpzouying/xiaohongshu-mcp

# xiaohongshu-mcp MCP for 小红书/xiaohongshu.com。 - 我的博客文章：[haha.ai/xiaohongshu-mcp](https://www.haha.ai/xiaohongshu-mcp) **遇到任何问题，务必要先看 [各种疑难杂症](https://github.com/xpzouying/xiaohongshu-mcp/issues/56)**。 上面的 **疑难杂症** 列表后，还是解决不了你的部署问题，那么强烈推荐使用我写的另外一个工具：[xpzouying/x-mcp](https://github.com/xpzouying/x-mcp)，这个工具不需要你进行部署，只需要通过浏览器插件就能驱动你的 MCP，对于非技术同学来说更加友好。 ## 项目简介 **主要功能**

1. 登录和检查登录状态

第一步必须，小红书需要进行登录。可以检查当前登录状态。 **登录演示：** https://github.com/user-attachments/assets/8b05eb42-d437-41b7-9235-e2143f19e8b7 **检查登录状态演示：** https://github.com/user-attachments/assets/bd9a9a4a-58cb-4421-b8f3-015f703ce1f9

2. 发布图文内容

支持发布图文内容到小红书，包括标题、内容描述和图片。 **图片支持方式：** 支持两种图片输入方式： 1. **HTTP/HTTPS 图片链接** ["https://example.com/image1.jpg", "https://example.com/image2.png"] 2. **本地图片绝对路径**（推荐） ["/Users/username/Pictures/image1.jpg", "/home/user/images/image2.png"] **为什么推荐使用本地路径：** - ✅ 稳定性更好，不依赖网络 - ✅ 上传速度更快 - ✅ 避免图片链接失效问题 - ✅ 支持更多图片格式 **发布图文帖子演示：** https://github.com/user-attachments/assets/8aee0814-eb96-40af-b871-e66e6bbb6b06

3. 发布视频内容

支持发布视频内容到小红书，包括标题、内容描述和本地视频文件。 **视频支持方式：** 仅支持本地视频文件绝对路径： "/Users/username/Videos/video.mp4" **功能特点：** - ✅ 支持本地视频文件上传 - ✅ 自动处理视频格式转换 - ✅ 支持标题、内容描述和标签 - ✅ 等待视频处理完成后自动发布 **注意事项：** - 仅支持本地视频文件，不支持 HTTP 链接 - 视频处理时间较长，请耐心等待 - 建议视频文件大小不超过 1GB

4. 搜索内容

根据关键词搜索小红书内容。 **搜索帖子演示：** https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3

5. 获取推荐列表

获取小红书首页推荐内容列表。 **获取推荐列表演示：** https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28

6. 获取帖子详情（包括互动数据和评论）

获取小红书帖子的完整详情，包括： - 帖子内容（标题、描述、图片等） - 用户信息 - 互动数据（点赞、收藏、分享、评论数） - 评论列表及子评论 **⚠️ 重要提示：** - 需要提供帖子 ID 和 xsec_token（两个参数缺一不可） - 这两个参数可以从 Feed 列表或搜索结果中获取 - 必须先登录才能使用此功能 **获取帖子详情演示：** https://github.com/user-attachments/assets/76a26130-a216-4371-a6b3-937b8fda092a

7. 发表评论到帖子

支持自动发表评论到小红书帖子。 **功能说明：** - 自动定位评论输入框 - 输入评论内容并发布 - 支持 HTTP API 和 MCP 工具调用 **⚠️ 重要提示：** - 需要先登录才能使用此功能 - 需要提供帖子 ID、xsec_token 和评论内容 - 这些参数可以从 Feed 列表或搜索结果中获取 **发表评论演示：** https://github.com/user-attachments/assets/cc385b6c-422c-489b-a5fc-63e92c695b80

8. 获取用户个人主页

获取小红书用户的个人主页信息，包括用户基本信息和笔记内容。 **功能说明：** - 获取用户基本信息（昵称、简介、头像等） - 获取关注数、粉丝数、获赞量统计 - 获取用户发布的笔记内容列表 - 支持 HTTP API 和 MCP 工具调用 **⚠️ 重要提示：** - 需要先登录才能使用此功能 - 需要提供用户 ID 和 xsec_token - 这些参数可以从 Feed 列表或搜索结果中获取 **返回信息包括：** - 用户基本信息：昵称、简介、头像、认证状态 - 统计数据：关注数、粉丝数、获赞量、笔记数 - 笔记列表：用户发布的所有公开笔记

**小红书基础运营知识** - **标题：（非常重要）小红书要求标题不超过 20 个字** - **正文：（非常重要）：正文不能超过 1000 个字** - 当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。 - （低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。 - Tags：现已支持。添加合适的 Tags 能带来更多的流量。 - 根据本人实操，小红书每天的发帖量应该是 **50 篇**。 - **（非常重要）小红书的同一个账号不允许在多个网页端登录**，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。 - 曝光低的话，首先查看内容中是否有违禁词，搜一下有很多第三方免费工具。 - 一定不要出现引流、纯搬运的情况，属于官方重点打击对象。 **风险说明** 1. 该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。 2. 我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。 3. 如果账号没有实名认证，特别是新号，一般会触发 **实名认证** 的消息提醒（参见下图）。⚠️ 这个不是封号，不用 MCP 也会要求实名认证。实名认证后，账号就正常了。建议使用该项目前就先实名。 该项目是基于学习的目的，禁止一切违法行为。 **实操结果** 第一天点赞/收藏数达到了 999+， 一周左右的成果 ## 1. 使用教程 ### 1.1. 快速开始（推荐） **方式一：下载预编译二进制文件** 直接从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载对应平台的二进制文件： **主程序（MCP 服务）：** - **macOS Apple Silicon**: `xiaohongshu-mcp-darwin-arm64` - **macOS Intel**: `xiaohongshu-mcp-darwin-amd64` - **Windows x64**: `xiaohongshu-mcp-windows-amd64.exe` - **Linux x64**: `xiaohongshu-mcp-linux-amd64` **登录工具：** - **macOS Apple Silicon**: `xiaohongshu-login-darwin-arm64` - **macOS Intel**: `xiaohongshu-login-darwin-amd64` - **Windows x64**: `xiaohongshu-login-windows-amd64.exe` - **Linux x64**: `xiaohongshu-login-linux-amd64` 使用步骤： # 1. 首先运行登录工具 chmod +x xiaohongshu-login-darwin-arm64 ./xiaohongshu-login-darwin-arm64 # 2. 然后启动 MCP 服务 chmod +x xiaohongshu-mcp-darwin-arm64 ./xiaohongshu-mcp-darwin-arm64 **⚠️ 重要提示**：首次运行时会自动下载无头浏览器（约 150MB），请确保网络连接正常。后续运行无需重复下载。 **方式二：源码编译**

源码编译安装详情

依赖 Golang 环境，安装方法请参考 [Golang 官方文档](https://go.dev/doc/install)。 设置 Go 国内源的代理， # 配置 GOPROXY 环境变量，以下三选一 # 1. 七牛 CDN go env -w GOPROXY=https://goproxy.cn,direct # 2. 阿里云 go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct # 3. 官方 go env -w GOPROXY=https://goproxy.io,direct

**方式三：使用 Docker 容器（最简单）**

Docker 部署详情

使用 Docker 部署是最简单的方式，无需安装任何开发环境。 **1. 从 Docker Hub 拉取镜像（推荐）** 我们提供了预构建的 Docker 镜像，可以直接从 Docker Hub 拉取使用： # 拉取最新镜像 docker pull xpzouying/xiaohongshu-mcp Docker Hub 地址：[https://hub.docker.com/r/xpzouying/xiaohongshu-mcp](https://hub.docker.com/r/xpzouying/xiaohongshu-mcp) **2. 使用 Docker Compose 启动（推荐）** 我们提供了配置好的 `docker-compose.yml` 文件，可以直接使用： # 下载 docker-compose.yml wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml # 或者如果已经克隆了项目，进入 docker 目录 cd docker # 启动服务 docker compose up -d # 查看日志 docker compose logs -f # 停止服务 docker compose stop **3. 自己构建镜像（可选）** # 在项目根目录运行 docker build -t xpzouying/xiaohongshu-mcp . **4. 配置说明** Docker 版本会自动： - 配置 Chrome 浏览器和中文字体 - 挂载 `./data` 用于存储 cookies - 挂载 `./images` 用于存储发布的图片 - 暴露 18060 端口供 MCP 连接 详细使用说明请参考：[Docker 部署指南](./docker/README.md)

Windows 遇到问题首先看这里：[Windows 安装指南](./docs/windows_guide.md) ### 1.2. 登录 第一次需要手动登录，需要保存小红书的登录状态。 **使用二进制文件**： # 运行对应平台的登录工具 ./xiaohongshu-login-darwin-arm64 **使用源码**： go run cmd/login/main.go ### 1.3. 启动 MCP 服务 启动 xiaohongshu-mcp 服务。 **使用二进制文件**： # 默认：无头模式，没有浏览器界面 ./xiaohongshu-mcp-darwin-arm64 # 非无头模式，有浏览器界面 ./xiaohongshu-mcp-darwin-arm64 -headless=false **使用源码**： # 默认：无头模式，没有浏览器界面 go run . # 非无头模式，有浏览器界面 go run . -headless=false **配置代理（可选）**： 如果需要通过代理访问，可以设置 `XHS_PROXY` 环境变量： # 设置代理后启动 XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64 # 或使用源码 XHS_PROXY=http://proxy:port go run . 支持 HTTP/HTTPS/SOCKS5 代理，日志中会自动隐藏代理的认证信息。 ## 1.4. 验证 MCP npx @modelcontextprotocol/inspector  运行后，打开红色标记的链接，配置 MCP inspector，输入 `http://localhost:18060/mcp` ，点击 `Connect` 按钮。 **注意：** 左侧边框中的选项是否正确。 按照上面配置 MCP inspector 后，点击 `List Tools` 按钮，查看所有的 Tools。 ## 1.5. 使用 MCP 发布 ### 检查登录状态  ### 发布图文 示例中是从 https://unsplash.com/ 中随机找了个图片做测试。  ### 搜索内容 使用搜索功能，根据关键词搜索小红书内容：  ## 2. MCP 客户端接入 本服务支持标准的 Model Context Protocol (MCP)，可以接入各种支持 MCP 的 AI 客户端。 ### 2.1. 快速开始 #### 启动 MCP 服务 # 启动服务（默认无头模式） go run . # 或者有界面模式 go run . -headless=false 服务将运行在：`http://localhost:18060/mcp` #### 验证服务状态 # 测试 MCP 连接 curl -X POST http://localhost:18060/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}' #### Claude Code CLI 接入 # 添加 HTTP MCP 服务器 claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp # 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令） claude mcp list ### 2.2. 支持的客户端

Claude Code CLI

官方命令行工具，已在上面快速开始部分展示： # 添加 HTTP MCP 服务器 claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp # 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令） claude mcp list

Open Code CLI

使用交互式命令添加 MCP Server： opencode mcp add 以添加 `xiaohongshu-mcp` 为例： ┌ Add MCP server │ ◇ Enter MCP server name │ xiaohongshu-mcp │ ◇ Select MCP server type │ Remote │ ◇ Enter MCP server URL │ http://localhost:18060/mcp │ ◇ Does this server require OAuth authentication? │ No │ ◆ MCP server "xiaohongshu-mcp" added to C:\Users\admin\.config\opencode\opencode.json │ └ MCP server added successfully 验证是否添加成功（确保 MCP 已启动的前提下）： opencode mcp list ┌ MCP Servers │ ● ✓ xiaohongshu-mcp connected

Cursor

#### 配置文件的方式 创建或编辑 MCP 配置文件： **项目级配置**（推荐）： 在项目根目录创建 `.cursor/mcp.json`： { "mcpServers": { "xiaohongshu-mcp": { "url": "http://localhost:18060/mcp", "description": "小红书内容发布服务 - MCP Streamable HTTP" } } } **全局配置**： 在用户目录创建 `~/.cursor/mcp.json` (同样内容)。 #### 使用步骤 1. 确保小红书 MCP 服务正在运行 2. 保存配置文件后，重启 Cursor 3. 在 Cursor 聊天中，工具应该自动可用 4. 可以通过聊天界面的 "Available Tools" 查看已连接的 MCP 工具 **Demo** 插件 MCP 接入：  调用 MCP 工具：（以检查登录状态为例） 

VSCode

#### 方法一：使用命令面板配置 1. 按 `Ctrl/Cmd + Shift + P` 打开命令面板 2. 运行 `MCP: Add Server` 命令 3. 选择 `HTTP` 方式。 4. 输入地址： `http://localhost:18060/mcp`，或者修改成对应的 Server 地址。 5. 输入 MCP 名字： `xiaohongshu-mcp`。 #### 方法二：直接编辑配置文件 **工作区配置**（推荐）： 在项目根目录创建 `.vscode/mcp.json`： { "servers": { "xiaohongshu-mcp": { "url": "http://localhost:18060/mcp", "type": "http" } }, "inputs": [] } **查看配置**：  1. 确认运行状态。 2. 查看 `tools` 是否正确检测。 **Demo** 以搜索帖子内容为例： 

Google Gemini CLI

在 `~/.gemini/settings.json` 或项目目录 `.gemini/settings.json` 中配置： { "mcpServers": { "xiaohongshu": { "httpUrl": "http://localhost:18060/mcp", "timeout": 30000 } } } 更多信息请参考 [Gemini CLI MCP 文档](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)

MCP Inspector

调试工具，用于测试 MCP 连接： # 启动 MCP Inspector npx @modelcontextprotocol/inspector # 在浏览器中连接到：http://localhost:18060/mcp 使用步骤： - 使用 MCP Inspector 测试连接 - 测试 Ping Server 功能验证连接 - 检查 List Tools 是否返回 6 个工具

Cline

Cline 是一个强大的 AI 编程助手，支持 MCP 协议集成。 #### 配置方法 在 Cline 的 MCP 设置中添加以下配置： { "xiaohongshu-mcp": { "url": "http://localhost:18060/mcp", "type": "streamableHttp", "autoApprove": [], "disabled": false } } #### 使用步骤 1. 确保小红书 MCP 服务正在运行（`http://localhost:18060/mcp`） 2. 在 Cline 中打开 MCP 设置 3. 添加上述配置到 MCP 服务器列表 4. 保存配置并重启 Cline 5. 在对话中可以直接使用小红书相关功能 #### 配置说明 - `url`: MCP 服务地址 - `type`: 使用 `streamableHttp` 类型以获得更好的性能 - `autoApprove`: 可配置自动批准的工具列表（留空表示手动批准） - `disabled`: 设置为 `false` 启用此 MCP 服务 #### 使用示例 配置完成后，可以在 Cline 中直接使用自然语言操作小红书： 帮我检查小红书登录状态 帮我发布一篇关于春天的图文到小红书，使用这张图片：/path/to/spring.jpg 搜索小红书上关于"美食"的内容

OpenClaw（通过 MCPorter）

由于 OpenClaw 目前不原生支持 MCP，官方推荐通过 **MCPorter** 来调用 MCP 服务。 #### 安装与配置步骤 直接一次性将一下三行命令丢给 OpenClaw（可以是 Control UI、Telegram、Feishu等方式），Openclaw 会代为部署 MCPorter。 npm i -g mcporter npx mcporter config add xiaohongshu-mcp http://localhost:18060/mcp npx mcporter list xiaohongshu-mcp 完成上述步骤后，即可在 OpenClaw 中通过自然语言调用 xiaohongshu-mcp 的所有功能。

其他支持 HTTP MCP 的客户端

任何支持 HTTP MCP 协议的客户端都可以连接到：`http://localhost:18060/mcp` 基本配置模板： { "name": "xiaohongshu-mcp", "url": "http://localhost:18060/mcp", "type": "http" }

### 2.3. 可用 MCP 工具 连接成功后，可使用以下 MCP 工具： - `check_login_status` - 检查小红书登录状态（无参数） - `publish_content` - 发布图文内容到小红书（必需：title, content, images） - `images`: 支持 HTTP 链接或本地绝对路径，推荐使用本地路径 - `publish_with_video` - 发布视频内容到小红书（必需：title, content, video） - `video`: 仅支持本地视频文件绝对路径 - `list_feeds` - 获取小红书首页推荐列表（无参数） - `search_feeds` - 搜索小红书内容（需要：keyword） - `get_feed_detail` - 获取帖子详情（需要：feed_id, xsec_token） - `post_comment_to_feed` - 发表评论到小红书帖子（需要：feed_id, xsec_token, content） - `user_profile` - 获取用户个人主页信息（需要：user_id, xsec_token） ### 2.4. 使用示例 使用 Claude Code 发布内容到小红书： **示例 1：使用 HTTP 图片链接** 帮我写一篇帖子发布到小红书上， 配图为：https://cn.bing.com/th?id=OHR.MaoriRock_EN-US6499689741_UHD.jpg&w=3840 图片是："纽西兰陶波湖的Ngātoroirangi矿湾毛利岩雕（© Joppi/Getty Images）" 使用 xiaohongshu-mcp 进行发布。 **示例 2：使用本地图片路径（推荐）** 帮我写一篇关于春天的帖子发布到小红书上， 使用这些本地图片： - /Users/username/Pictures/spring_flowers.jpg - /Users/username/Pictures/cherry_blossom.jpg 使用 xiaohongshu-mcp 进行发布。 **示例 3：发布视频内容** 帮我写一篇关于美食制作的视频发布到小红书上， 使用这个本地视频文件： - /Users/username/Videos/cooking_tutorial.mp4 使用 xiaohongshu-mcp 的视频发布功能。  **发布结果：** ### 2.5. 💬 MCP 使用常见问题解答 - OpenClaw 的 AI 自动部署行为不在本项目的维护范围内，部署结果无法保证 - MCPorter 作为中间层可能引入额外的兼容性问题，与 xiaohongshu-mcp 本身无关 - 若遇到连接失败、工具调用异常等问题，请先排查 MCPorter 自身的配置，而非提交 Issue - 在提问社区或群组前，请先确认问题是否能在**不使用 OpenClaw** 的情况下复现 如果你没有强烈的 OpenClaw 使用需求，强烈建议改用 [Claude Code CLI](#claude-code-cli)、[Cursor](#cursor) 或 [Cline](#cline) 等原生支持 HTTP MCP 的客户端，体验会更稳定。 **Q:** 为什么检查登录用户名显示 `xiaghgngshu-mcp`？ **A:** 用户名是写死的。 **Q:** 显示发布成功后，但实际上没有显示？ **A:** 排查步骤如下： 1. 使用 **非无头模式** 重新发布一次。 2. 更换 **不同的内容** 重新发布。 3. 登录网页版小红书，查看账号是否被 **风控限制网页版发布**。 4. 检查 **图片大小** 是否过大。 5. 确认 **图片路径中没有中文字符**。 6. 若使用网络图片地址，请确认 **图片链接可正常访问**。 **Q:** 在设备上运行 MCP 程序出现闪退如何解决？ **A:** 1. 建议 **从源码安装**。 2. 或使用 **Docker 安装 xiaohongshu-mcp**，教程参考： - [使用 Docker 安装 xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp#:~:text=%E6%96%B9%E5%BC%8F%E4%B8%89%EF%BC%9A%E4%BD%BF%E7%94%A8%20Docker%20%E5%AE%B9%E5%99%A8%EF%BC%88%E6%9C%80%E7%AE%80%E5%8D%95%EF%BC%89) - [X-MCP 项目页面](https://github.com/xpzouying/x-mcp/) **Q:** 使用 `http://localhost:18060/mcp` 进行 MCP 验证时提示无法连接？ **A:** - 在 **Docker 环境** 下，请使用 👉 [http://host.docker.internal:18060/mcp](http://host.docker.internal:18060/mcp) - 在 **非 Docker 环境** 下，请使用 **本机 IPv4 地址** 访问。 ## 3. 🌟 实战案例展示 (Community Showcases) ### 📚 完整教程列表 1. **[n8n 完整集成教程](./examples/n8n/README.md)** - 工作流自动化平台集成 2. **[Cherry Studio 完整配置教程](./examples/cherrystudio/README.md)** - AI 客户端完美接入 3. **[Claude Code + Kimi K2 接入教程](./examples/claude-code/claude-code-kimi-k2.md)** - Claude Code 门槛太高，那么就接入 Kimi 国产大模型吧～ 4. **[AnythingLLM 完整指南](./examples/anythingLLM/readme.md)** - AnythingLLM 是一款 all-in-one 多模态 AI 客户端，支持 workflow 定义，支持多种大模型和插件扩展。 ## 4. 小红书 MCP 互助群 **重要：在群里问问题之前，请一定要先仔细看完 README 文档以及查看 Issues。** ### 微信群 | 【微信群 16 群】：扫码进入 | | :------------------------------------------------------------------------------------------------------------------------: | | | ### 飞书群 | 飞书 1 群 | 飞书 2 群 | 飞书 3 群 | 飞书 4 群 | | :-----------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------: | | | | | | ## 🙏 致谢贡献者 ✨ 感谢以下所有为本项目做出贡献的朋友！（排名不分先后）

zy 💻 🤔 📖 🎨 🚧 🚇 👀	clearwater 💻	Zhongpeng 💻	Duong Tran 💻	Angiin 💻	Henan Mu 💻	Journey 💻
Eve Yu 💻	CooperGuo 💻	Banghao Chi 💻	varz1 💻	Melo Y Guan 💻	lmxdawn 💻	haikow 💻
Carlo 💻	hrz 💻	Ctrlz 💻	flippancy 💻	Yuhang Lu 💻	Bryan Thompson 💻	tan jun 💻
coldmountain 💻	mamage 💻 📖	Runyang YOU 💻 📖	e0_7 💻 📖	prehisle 💻 📖

### ✨ 特别感谢

@wanpengxie

@tanxxjun321

@Angiin

本项目遵循 [all-contributors](https://github.com/all-contributors/all-contributors) 规范。欢迎任何形式的贡献！

标签：AIGC, API封装, BeEF, EVTX分析, EVTX分析, LLM工具, MCP, Model Context Protocol, Python, RPA, Selenium, 内容创作, 图文发布, 小红书, 数字营销, 无后门, 日志审计, 浏览器插件, 浏览器自动化, 爬虫, 登录检测, 社交媒体, 自动化发布, 自媒体, 视频发布, 请求拦截