xiaohongshu-mcp

# xiaohongshu-mcp <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> [](#contributors-) <!-- ALL-CONTRIBUTORS-BADGE:END --> [](./DONATIONS.md) [](./DONATIONS.md) [](https://hub.docker.com/r/xpzouying/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，对于非技术同学来说更加友好。 ## Star History [](https://www.star-history.com/#xpzouying/xiaohongshu-mcp&Timeline) ## 赞赏支持 本项目所有的赞赏都会用于慈善捐赠。所有的慈善捐赠记录，请参考 [DONATIONS.md](./DONATIONS.md)。 **捐赠时，请备注 MCP 以及名字。** 如需更正/撤回署名，请开 Issue 或通过邮箱联系。 **支付宝（不展示二维码）：** 通过支付宝向 **xpzouying@gmail.com** 赞赏。 **微信：** <img src="donate/wechat@2x.png" alt="WeChat Pay QR" width="260" /> ## 项目简介 **主要功能** > 💡 **提示：** 点击下方功能标题可展开查看视频演示 <details> <summary><b>1. 登录和检查登录状态</b></summary> 第一步必须，小红书需要进行登录。可以检查当前登录状态。 **登录演示：** https://github.com/user-attachments/assets/8b05eb42-d437-41b7-9235-e2143f19e8b7 **检查登录状态演示：** https://github.com/user-attachments/assets/bd9a9a4a-58cb-4421-b8f3-015f703ce1f9 </details> <details> <summary><b>2. 发布图文内容</b></summary> 支持发布图文内容到小红书，包括标题、内容描述和图片。 **图片支持方式：** 支持两种图片输入方式： 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 </details> <details> <summary><b>3. 发布视频内容</b></summary> 支持发布视频内容到小红书，包括标题、内容描述和本地视频文件。 **视频支持方式：** 仅支持本地视频文件绝对路径： ``` "/Users/username/Videos/video.mp4" ``` **功能特点：** - ✅ 支持本地视频文件上传 - ✅ 自动处理视频格式转换 - ✅ 支持标题、内容描述和标签 - ✅ 等待视频处理完成后自动发布 **注意事项：** - 仅支持本地视频文件，不支持 HTTP 链接 - 视频处理时间较长，请耐心等待 - 建议视频文件大小不超过 1GB </details> <details> <summary><b>4. 搜索内容</b></summary> 根据关键词搜索小红书内容。 **搜索帖子演示：** https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3 </details> <details> <summary><b>5. 获取推荐列表</b></summary> 获取小红书首页推荐内容列表。 **获取推荐列表演示：** https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28 </details> <details> <summary><b>6. 获取帖子详情（包括互动数据和评论）</b></summary> 获取小红书帖子的完整详情，包括： - 帖子内容（标题、描述、图片等） - 用户信息 - 互动数据（点赞、收藏、分享、评论数） - 评论列表及子评论 **⚠️ 重要提示：** - 需要提供帖子 ID 和 xsec_token（两个参数缺一不可） - 这两个参数可以从 Feed 列表或搜索结果中获取 - 必须先登录才能使用此功能 **获取帖子详情演示：** https://github.com/user-attachments/assets/76a26130-a216-4371-a6b3-937b8fda092a </details> <details> <summary><b>7. 发表评论到帖子</b></summary> 支持自动发表评论到小红书帖子。 **功能说明：** - 自动定位评论输入框 - 输入评论内容并发布 - 支持 HTTP API 和 MCP 工具调用 **⚠️ 重要提示：** - 需要先登录才能使用此功能 - 需要提供帖子 ID、xsec_token 和评论内容 - 这些参数可以从 Feed 列表或搜索结果中获取 **发表评论演示：** https://github.com/user-attachments/assets/cc385b6c-422c-489b-a5fc-63e92c695b80 </details> <details> <summary><b>8. 获取用户个人主页</b></summary> 获取小红书用户的个人主页信息，包括用户基本信息和笔记内容。 **功能说明：** - 获取用户基本信息（昵称、简介、头像等） - 获取关注数、粉丝数、获赞量统计 - 获取用户发布的笔记内容列表 - 支持 HTTP API 和 MCP 工具调用 **⚠️ 重要提示：** - 需要先登录才能使用此功能 - 需要提供用户 ID 和 xsec_token - 这些参数可以从 Feed 列表或搜索结果中获取 **返回信息包括：** - 用户基本信息：昵称、简介、头像、认证状态 - 统计数据：关注数、粉丝数、获赞量、笔记数 - 笔记列表：用户发布的所有公开笔记 </details> **小红书基础运营知识** - **标题：（非常重要）小红书要求标题不超过 20 个字** - **正文：（非常重要）：正文不能超过 1000 个字** - 当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。 - （低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。 - Tags：现已支持。添加合适的 Tags 能带来更多的流量。 - 根据本人实操，小红书每天的发帖量应该是 **50 篇**。 - **（非常重要）小红书的同一个账号不允许在多个网页端登录**，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。 **风险说明** 1. 该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。 2. 我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。 该项目是基于学习的目的，禁止一切违法行为。 **实操结果** 第一天点赞/收藏数达到了 999+， <img width="386" height="278" alt="CleanShot 2025-09-05 at 01 31 55@2x" src="https://github.com/user-attachments/assets/4b5a283b-bd38-45b8-b608-8f818997366c" /> <img width="350" height="280" alt="CleanShot 2025-09-05 at 01 32 49@2x" src="https://github.com/user-attachments/assets/4481e1e7-3ef6-4bbd-8483-dcee8f77a8f2" /> 一周左右的成果 <img width="1840" height="582" alt="CleanShot 2025-09-05 at 01 33 13@2x" src="https://github.com/user-attachments/assets/fb367944-dc48-4bbd-8ece-934caa86323e" /> ## 1. 使用教程 ### 1.1. 快速开始（推荐） **方式一：下载预编译二进制文件** 直接从 [GitHub Releases