小小红书mcp

主要功能

💡 提示： 点击下方功能标题可展开查看视频演示

小红书基础运营知识

• 标题：（非常重要）小红书要求标题不超过 20 个字
• 正文：（非常重要）：正文不能超过 1000 个字
• 当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。
• （低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。
• Tags：现已支持。添加合适的 Tags 能带来更多的流量。
• 根据本人实操，小红书每天的发帖量应该是 50 篇。
• （非常重要）小红书的同一个账号不允许在多个网页端登录，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。

风险说明

1. 该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。
2. 我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。

该项目是基于学习的目的，禁止一切违法行为。

实操结果

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

一周左右的成果

方式一：下载预编译二进制文件

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

方式二：源码编译

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

Windows 遇到问题首先看这里：Windows 安装指南

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

使用二进制文件：

# 运行对应平台的登录工具
./xiaohongshu-login-darwin-arm64

使用源码：

go run cmd/login/main.go

启动 xiaohongshu-mcp 服务。

使用二进制文件：

# 默认：无头模式，没有浏览器界面
./xiaohongshu-mcp-darwin-arm64

# 非无头模式，有浏览器界面
./xiaohongshu-mcp-darwin-arm64 -headless=false

使用源码：

# 默认：无头模式，没有浏览器界面
go run .

# 非无头模式，有浏览器界面
go run . -headless=false

npx @modelcontextprotocol/inspector

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

按照上面配置 MCP inspector 后，点击 List Tools 按钮，查看所有的 Tools。

示例中是从 https://unsplash.com/ 中随机找了个图片做测试。

使用搜索功能，根据关键词搜索小红书内容：

本服务支持标准的 Model Context Protocol (MCP)，可以接入各种支持 MCP 的 AI 客户端。

# 启动服务（默认无头模式）
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}'

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

连接成功后，可使用以下 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）

使用 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 的视频发布功能。

发布结果：

💡 强烈推荐查看：这些都是社区贡献者的真实使用案例，包含详细的配置步骤和实战经验！

1. n8n 完整集成教程 – 工作流自动化平台集成
2. Cherry Studio 完整配置教程 – AI 客户端完美接入
3. Claude Code + Kimi K2 接入教程 – Claude Code 门槛太高，那么就接入 Kimi 国产大模型吧～
4. AnythingLLM 完整指南 – AnythingLLM 是一款 all-in-one 多模态 AI 客户端，支持 workflow 定义，支持多种大模型和插件扩展。