项目概述

xiaohongshu-mcp 是一个基于 MCP (Model Context Protocol) 协议的小红书自动化工具，让 AI 助手能够直接与小红书平台交互

核心价值

🤖
AI集成

与Claude、Cursor等AI客户端无缝集成

⚡
自动化

自动化内容发布、搜索、评论等操作

🔧
易用性

提供预编译二进制文件，开箱即用

🌐
跨平台

支持 macOS、Windows、Linux 多平台

核心特性

7大核心功能，全面覆盖小红书内容管理需求

🔐

登录管理

支持小红书账号登录和登录状态检查，确保操作权限和安全性。提供可视化登录界面和状态监控。

📝

内容发布

支持发布图文内容到小红书，包括标题、描述和图片。支持HTTP链接和本地图片路径两种方式。

🔍

内容搜索

根据关键词搜索小红书内容，获取相关帖子信息，支持精确搜索和模糊匹配。

📋

推荐列表

获取小红书首页推荐内容列表，了解热门趋势和用户偏好，为内容创作提供参考。

📊

帖子详情

获取帖子完整详情，包括内容、用户信息、互动数据（点赞、收藏、分享、评论数）和评论列表。

💬

评论互动

支持自动发表评论到小红书帖子，实现智能互动和社区参与，提升账号活跃度。

👤

用户信息

获取用户个人主页信息，包括基本信息、统计数据和发布的笔记内容列表。

技术架构

基于现代化技术栈，确保高性能和稳定性

技术栈组成

🐹
Go 1.24.0

高性能后端语言

🌐
Gin Framework

轻量级Web框架

🤖
go-rod

浏览器自动化引擎

🔗
MCP Protocol

模型上下文协议

架构特点

  • 无头浏览器技术：使用 go-rod 实现真实浏览器环境操作
  • MCP协议支持：标准化的AI工具接口，支持多种客户端
  • HTTP API：提供RESTful API接口，便于集成和调用
  • 并发处理：Go语言天然支持高并发，处理多任务效率高
  • 跨平台部署：支持多操作系统，提供预编译二进制文件

安装指南

多种安装方式，选择最适合你的方案

方式一：下载预编译二进制文件（推荐）

直接从 GitHub Releases 下载对应平台的二进制文件：

下载链接 
# macOS Apple Silicon
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-arm64

# macOS Intel
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-amd64

# Windows x64
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-windows-amd64.exe

# Linux x64
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-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

MCP客户端集成

支持多种AI客户端，实现无缝集成

🤖

Claude Code CLI

官方命令行工具，支持HTTP MCP服务器连接

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

Cursor IDE

在项目根目录创建 .cursor/mcp.json 配置文件

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp"
    }
  }
}
🔧

VSCode

使用命令面板或配置文件方式接入

# 命令面板
Ctrl/Cmd + Shift + P
> MCP: Add Server
> HTTP: http://localhost:18060/mcp
🔍

MCP Inspector

调试工具，用于测试MCP连接和功能

# 启动 Inspector
npx @modelcontextprotocol/inspector
# 连接: http://localhost:18060/mcp

使用示例

实际操作演示，快速上手

基本使用流程

1. 启动服务

运行 xiaohongshu-mcp 启动 MCP 服务，默认监听 18060 端口

2. 登录账号

使用登录工具完成小红书账号登录，保存登录状态

3. 配置客户端

在AI客户端中配置MCP服务器地址，连接工具

使用示例：发布内容 
帮我写一篇关于春天的帖子发布到小红书上，
使用这些本地图片：
- /Users/username/Pictures/spring_flowers.jpg
- /Users/username/Pictures/cherry_blossom.jpg

使用 xiaohongshu-mcp 进行发布。

可用MCP工具

check_login_status

检查登录状态

publish_content

发布图文内容

search_feeds

搜索内容

list_feeds

获取推荐列表

get_feed_detail

获取帖子详情

post_comment_to_feed

发表评论

社区支持

活跃的开源社区，持续更新和支持

⭐

GitHub 仓库

4.3k+ Stars，578 Forks，活跃的开源项目

访问仓库 →
📚

详细文档

完整的使用文档和API说明，包含多种集成案例

查看文档 →
👥

交流群组

微信群和飞书群，技术交流和问题解答

扫码加入技术交流群

🚀

持续更新

定期发布新版本，修复问题和添加新功能

最新版本：v2025.09.22.0508

风险说明

该项目基于学习目的开发，作者已稳定运行一年多无封号情况。请遵守小红书平台规则，禁止一切违法行为。 建议合理使用，避免频繁操作。同一账号不要在多个网页端同时登录，以免被踢出登录状态。