$git clone https://github.com/xpzouying/xiaohongshu-mcpMCP for 小红书 / xiaohongshu.com。让你的 AI 助手直接访问小红书数据。
| 1 | # xiaohongshu-mcp |
| 2 | |
| 3 | <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> |
| 4 | [](#contributors-) |
| 5 | <!-- ALL-CONTRIBUTORS-BADGE:END --> |
| 6 | |
| 7 | [](./DONATIONS.md) |
| 8 | [](./DONATIONS.md) |
| 9 | [](https://hub.docker.com/r/xpzouying/xiaohongshu-mcp) |
| 10 | |
| 11 | MCP for 小红书 / xiaohongshu.com。让你的 AI 助手直接访问小红书数据。 |
| 12 | |
| 13 | ### 🚀 快速开始:选择最适合你的版本 |
| 14 | |
| 15 | > [!IMPORTANT] |
| 16 | > #### 🔥 方案 A:Openclaw 深度集成 (推荐给开发者) |
| 17 | > - **Openclaw 太火啦 🔥🔥🔥 ,新增 Openclaw 支持,分为两种,请各位按需使用:** |
| 18 | > - [xiaohongshu-mcp-skills](https://github.com/autoclaw-cc/xiaohongshu-mcp-skills)(适用于已部署完本项目的用户) |
| 19 | > - [xiaohongshu-skills](https://github.com/autoclaw-cc/xiaohongshu-skills)(开箱即用版) |
| 20 | |
| 21 | > [!TIP] |
| 22 | > #### ✨ 方案 B:x-mcp 浏览器插件版 (推荐给非技术同学 / 追求极简的用户) |
| 23 | > - **不想折腾 Docker 或部署环境?试试:[xpzouying/x-mcp](https://github.com/xpzouying/x-mcp)** |
| 24 | > - **零配置**:安装插件即用,无需任何代码、代理或复杂的环境配置。 |
| 25 | > - **安全稳定**:直接在常用浏览器 (Chrome/Edge) 及本地网络运行,无服务器 IP 风险,且能解决 90% 的部署报错。 |
| 26 | |
| 27 | ### 📖 相关资源 |
| 28 | |
| 29 | - **我的博客文章**:[haha.ai/xiaohongshu-mcp](https://www.haha.ai/xiaohongshu-mcp) |
| 30 | - **贡献指南**:[Contributing Guide](./CONTRIBUTING.md) |
| 31 | |
| 32 | ### 🛠️ 疑难杂症 |
| 33 | |
| 34 | 如果您在部署传统 Docker 版本时遇到问题,**务必先查看:[各种疑难杂症 (Issues #56)](https://github.com/xpzouying/xiaohongshu-mcp/issues/56)**。 |
| 35 | |
| 36 | > *提示:如果环境排查太耗时,切换到 [x-mcp 插件版](https://github.com/xpzouying/x-mcp) 通常是更高效的选择。* |
| 37 | |
| 38 | ## Star History |
| 39 | |
| 40 | <!-- 图表由 .github/workflows/star-history.yml 每周生成到 star-history 数据分支(star-history.com 托管图表因 GitHub API 限制已失效) --> |
| 41 | <a href="https://www.star-history.com/#xpzouying/xiaohongshu-mcp&Timeline"> |
| 42 | <picture> |
| 43 | <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/star-history/assets/star-history-dark.svg" /> |
| 44 | <img alt="Star History Chart" src="https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/star-history/assets/star-history.svg" /> |
| 45 | </picture> |
| 46 | </a> |
| 47 | |
| 48 | ## 赞赏支持 |
| 49 | |
| 50 | 本项目所有的赞赏都会用于慈善捐赠。所有的慈善捐赠记录,请参考 [DONATIONS.md](./DONATIONS.md)。 |
| 51 | |
| 52 | **捐赠时,请备注 MCP 以及名字。** |
| 53 | 如需更正/撤回署名,请开 Issue 或通过邮箱联系。 |
| 54 | |
| 55 | **支付宝(不展示二维码):** |
| 56 | |
| 57 | 通过支付宝向 **xpzouying@gmail.com** 赞赏。 |
| 58 | |
| 59 | **微信:** |
| 60 | |
| 61 | <img src="donate/wechat@2x.png" alt="WeChat Pay QR" width="260" /> |
| 62 | |
| 63 | ## 项目简介 |
| 64 | |
| 65 | **主要功能** |
| 66 | |
| 67 | > 💡 **提示:** 点击下方功能标题可展开查看视频演示 |
| 68 | |
| 69 | <details> |
| 70 | <summary><b>1. 登录和检查登录状态</b></summary> |
| 71 | |
| 72 | 第一步必须,小红书需要进行登录。可以检查当前登录状态。 |
| 73 | |
| 74 | **登录演示:** |
| 75 | |
| 76 | https://github.com/user-attachments/assets/8b05eb42-d437-41b7-9235-e2143f19e8b7 |
| 77 | |
| 78 | **检查登录状态演示:** |
| 79 | |
| 80 | https://github.com/user-attachments/assets/bd9a9a4a-58cb-4421-b8f3-015f703ce1f9 |
| 81 | |
| 82 | </details> |
| 83 | |
| 84 | <details> |
| 85 | <summary><b>2. 发布图文内容</b></summary> |
| 86 | |
| 87 | 支持发布图文内容到小红书,包括标题、内容描述和图片。 |
| 88 | |
| 89 | **图片支持方式:** |
| 90 | |
| 91 | 支持两种图片输入方式: |
| 92 | |
| 93 | 1. **HTTP/HTTPS 图片链接** |
| 94 | |
| 95 | ``` |
| 96 | ["https://example.com/image1.jpg", "https://example.com/image2.png"] |
| 97 | ``` |
| 98 | |
| 99 | 2. **本地图片绝对路径**(推荐) |
| 100 | ``` |
| 101 | ["/Users/username/Pictures/image1.jpg", "/home/user/images/image2.png"] |
| 102 | ``` |
| 103 | |
| 104 | **为什么推荐使用本地路径:** |
| 105 | |
| 106 | - ✅ 稳定性更好,不依赖网络 |
| 107 | - ✅ 上传速度更快 |
| 108 | - ✅ 避免图片链接失效问题 |
| 109 | - ✅ 支持更多图片格式 |
| 110 | |
| 111 | **发布图文帖子演示:** |
| 112 | |
| 113 | https://github.com/user-attachments/assets/8aee0814-eb96-40af-b871-e66e6bbb6b06 |
| 114 | |
| 115 | </details> |
| 116 | |
| 117 | <details> |
| 118 | <summary><b>3. 发布视频内容</b></summary> |
| 119 | |
| 120 | 支持发布视频内容到小红书,包括标题、内容描述和本地视频文件。 |
| 121 | |
| 122 | **视频支持方式:** |
| 123 | |
| 124 | 仅支持本地视频文件绝对路径: |
| 125 | |
| 126 | ``` |
| 127 | "/Users/username/Videos/video.mp4" |
| 128 | ``` |
| 129 | |
| 130 | **功能特点:** |
| 131 | |
| 132 | - ✅ 支持本地视频文件上传 |
| 133 | - ✅ 自动处理视频格式转换 |
| 134 | - ✅ 支持标题、内容描述和标签 |
| 135 | - ✅ 等待视频处理完成后自动发布 |
| 136 | |
| 137 | **注意事项:** |
| 138 | |
| 139 | - 仅支持本地视频文件,不支持 HTTP 链接 |
| 140 | - 视频处理时间较长,请耐心等待 |
| 141 | - 建议视频文件大小不超过 1GB |
| 142 | |
| 143 | </details> |
| 144 | |
| 145 | <details> |
| 146 | <summary><b>4. 搜索内容</b></summary> |
| 147 | |
| 148 | 根据关键词搜索小红书内容。 |
| 149 | |
| 150 | **搜索帖子演示:** |
| 151 | |
| 152 | https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3 |
| 153 | |
| 154 | </details> |
| 155 | |
| 156 | <details> |
| 157 | <summary><b>5. 获取推荐列表</b></summary> |
| 158 | |
| 159 | 获取小红书首页推荐内容列表。 |
| 160 | |
| 161 | **获取推荐列表演示:** |
| 162 | |
| 163 | https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28 |
| 164 | |
| 165 | </details> |
| 166 | |
| 167 | <details> |
| 168 | <summary><b>6. 获取帖子详情(包括互动数据和评论)</b></summary> |
| 169 | |
| 170 | 获取小红书帖子的完整详情,包括: |
| 171 | |
| 172 | - 帖子内容(标题、描述、图片等) |
| 173 | - 用户信息 |
| 174 | - 互动数据(点赞、收藏、分享、评论数) |
| 175 | - 评论列表及子评论 |
| 176 | |
| 177 | **⚠ |