星战科技xingzhan.cloud
返回市场
小红书-MCP

小红书-MCP

作者：xpzouying7069 星标更新：2025-11-16
安装使用来源：spider==github.com

项目介绍

xiaohongshu-mcp

<!-- ALL-CONTRIBUTORS-BADGE:START - 不要删除或修改此部分 -->

所有贡献者

<!-- ALL-CONTRIBUTORS-BADGE:END -->

已捐赠 获得赞赏 Docker Pulls

针对 Xiaohongshu/xiaohongshu.com 的 MCP。

遇到问题时，请务必先查看 各种疑难杂症。

在列出上述 疑难杂症 之后，仍然无法解决您的部署问题。因此，我强烈建议使用我写的另一个工具:xpzouying/x-mcp。该工具不需要您进行部署，只需通过浏览器插件驱动您的 MCP，对于非技术人员来说更加友好。

星标历史

星标历史图表

感谢和支持

对本项目的全部感谢都将用于慈善捐款。所有慈善捐款记录，请参阅 DONATIONS.md。

请在捐款时注明 MCP 和姓名。 如果您需要更正/撤销签名，请打开一个 issue 或通过电子邮件联系我们。

支付宝（二维码未显示）：

通过支付宝 xpzouying@gmail.com 捐款。

微信

<img src="donate/wechat@2x.png" alt="微信支付二维码" width="260" />

项目简介

主要功能

💡 提示: 点击下方的功能标题以展开并查看演示视频

<details> <summary><b>1. 登录和检查登录状态</b></summary>

第一步是必要的，Xiaohongshu 需要登录。您可以检查当前的登录状态。

登录演示：

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>

支持向 Xiaohongshu 发布图文内容，包括标题、内容描述和图片。

图片支持方法：

支持两种图片输入方式：

  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>

支持向 Xiaohongshu 发布视频内容，包括标题、内容描述和本地视频文件。

视频支持方法：

仅支持本地视频文件的绝对路径：

"/Users/username/Videos/video.mp4"

特性：

  • ✅ 支持本地视频文件上传
  • ✅ 自动处理视频格式转换
  • ✅ 支持标题、内容描述和标签
  • ✅ 视频处理完成后自动发布

注意事项：

  • 仅支持本地视频文件，不支持 HTTP 链接
  • 视频处理时间较长，请耐心等待
  • 建议视频文件大小不超过 1GB
</details> <details> <summary><b>4. 搜索内容</b></summary>

根据关键词在 Xiaohongshu 上搜索内容。

搜索帖子演示：

https://github.com/user-attachments/assets/03c5077d-6160-4b18-b629-2e40933a1fd3

</details> <details> <summary><b>5. 获取推荐列表</b></summary>

获取 Xiaohongshu 首页的推荐内容列表。

获取推荐列表演示：

https://github.com/user-attachments/assets/110fc15d-46f2-4cca-bdad-9de5b5b8cc28

</details> <details> <summary><b>6. 获取帖子详情（包括互动数据和评论）</b></summary>

获取 Xiaohongshu 帖子的完整详情，包括：

  • 帖子内容（标题、描述、图片等）
  • 用户信息
  • 互动数据（点赞、收藏、分享、评论）
  • 评论列表和子评论

⚠️ 重要通知：

  • 需要提供帖子ID和xsec_token（两个参数缺一不可）
  • 这两个参数可以从动态列表或搜索结果中获取
  • 必须先登录才能使用此功能

获取帖子详情演示：

https://github.com/user-attachments/assets/76a26130-a216-4371-a6b3-937b8fda092a

</details> <details> <summary><b>7. 发表评论到帖子</b></summary>

支持自动在 Xiaohongshu 帖子上发表评论。

功能描述：

  • 自动定位评论输入框
  • 输入评论内容并发布
  • 支持 HTTP API 和 MCP 工具调用

⚠️ 重要通知：

  • 需要先登录才能使用此功能
  • 需要提供帖子ID、xsec_token 和评论内容
  • 这些参数可以从动态列表或搜索结果中获取

发表评论演示：

https://github.com/user-attachments/assets/cc385b6c-422c-489b-a5fc-63e92c695b80

</details> <details> <summary><b>8. 获取用户个人主页</b></summary>

获取 Xiaohongshu 用户的个人主页信息，包括基本用户信息和笔记内容。

功能描述：

  • 获取基本用户信息（昵称、头像、认证状态等）
  • 获取关注数、粉丝数和收到的点赞数统计
  • 获取用户发布的笔记内容列表
  • 支持 HTTP API 和 MCP 工具调用

⚠️ 重要通知：

  • 需要先登录才能使用此功能
  • 需要提供用户ID和xsec_token
  • 这些参数可以从动态列表或搜索结果中获取

返回的信息包括：

  • 用户基本信息：昵称、头像、认证状态
  • 统计数据：关注数、粉丝数、点赞数、笔记数
  • 笔记列表：用户发布的所有公开笔记
</details>

Xiaohongshu 基础操作知识

  • 标题：（非常重要）Xiaohongshu 要求标题不得超过 20 字
  • 正文：（非常重要）正文不得超过 1000 字
  • 当前支持发送文本和图片以及视频：从推荐角度来看，图文流量会优于视频和纯文本流量。
  • （低优先级）考虑纯文本支持。1. 个人感觉纯文本会大大增加操作复杂性；在我的使用场景中，纯文本的价值相对较低。
  • 标签：现在支持。添加适当的标签可以带来更多的流量。
  • 根据我的实际经验，Xiaohongshu 的每日发帖量应为 50 篇。
  • （非常重要）Xiaohongshu 的同一账号不允许在多个网页上登录 如果您登录了当前的 xiaohongshu mcp，请不要在其他网页上登录该账号，否则当前 MCP 账号会被“踢出登录”。您可以使用移动应用查看当前账号信息。

风险披露

  1. 该项目基于我们自己的另一个项目开源。原始项目已稳定运行超过一年，没有任何账号被封的情况，除了 cookie 过期后需要重新登录。
  2. 我使用 Claude Code 连接，并经过几周的稳定自动化运行验证，确认没有问题后才开放。

本项目旨在学习目的，禁止一切非法活动。

实际效果

第一天，点赞/收藏数量达到 999+，

<img width="386" height="278" alt="CleanShot 2025-09-05 at 01 31 55@2x" src="https://gips2.baidu.com/it/u=966478860,2382873980&fm=3081&app=3081&f=PNG?w=386&h=278" /> <img width="350" height="280" alt="CleanShot 2025-09-05 at 01 32 49@2x" src="https://gips0.baidu.com/it/u=3698944841,2404073098&fm=3081&app=3081&f=PNG?w=998&h=798" />

大约一周的结果

<img width="1840" height="582" alt="CleanShot 2025-09-05 at 01 33 13@2x" src="https://gips3.baidu.com/it/u=2320614448,2843543925&fm=3081&app=3081&f=PNG?w=1840&h=582" />

1. 使用教程

1.1. 快速开始（推荐）

方法 1：下载预编译的二进制文件

直接从 GitHub 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）将在首次运行时自动下载，请确保网络连接正常。后续运行无需重复下载。

方法 2：源码编译

<details> <summary>源码编译安装详情</summary>

依赖于 Golang 环境，请参考安装方法 Golang 官方文档。

设置 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
</details>

方法 3：使用 Docker 容器（最简单）

<details> <summary>Docker 部署详情</summary>

使用 Docker 部署是最简单的方式，无需安装任何开发环境。

1. 从 Docker Hub 拉取镜像（推荐）

我们提供了预构建的 Docker 镜像，可以直接从 Docker Hub 拉取使用：

# 拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp

Docker Hub 地址：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 用于存储 cookie
  • 挂载 ./images 用于存储发布的图片
  • 暴露端口 18060 供 MCP 连接

详细使用说明，请参阅：Docker 部署指南

</details>

当在 Windows 上遇到问题时，请首先查看这里：Windows 安装指南

1.2. 登录

第一次需要手动登录，需要保存 Xiaohongshu 的登录状态。

使用二进制文件：

# 运行对应平台的登录工具
./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

1.4. 验证 MCP

npx @modelcontextprotocol/inspector

运行 Inspector

运行后，打开红色标记的链接，配置 MCP inspector，并输入 http://localhost:18060/mcp ，点击 Connect 按钮。

配置 MCP inspector

按照上述配置 MCP inspector 后，点击 List Tools 按钮查看所有工具。

1.5. 使用 MCP 发布

检查登录状态

检查登录状态

发布图文

示例中是从 https://unsplash.com/ 随机选择了一张图片进行测试。

发布图文

搜索内容

使用搜索功能，根据关键词在 Xiaohongshu 上搜索内容：

搜索内容

2. MCP 客户端访问

此服务支持标准模型上下文协议（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