简介

​xiaohongshu-mcp​ 是一个基于Model Context Protocol (MCP)的开源工具，专门为小红书(xiaohongshu.com)平台设计。该项目通过标准化协议实现AI助手与小红书平台的深度集成，让用户能够通过Claude、Cursor等AI工具直接自动化管理小红书账号，包括内容发布、搜索、互动等核心功能。

🔗 ​GitHub地址​：

https://github.com/xpzouying/xiaohongshu-mcp

📱 ​核心价值​：

小红书自动化 · AI驱动运营 · 多客户端支持 · 开源免费

​技术特色​：

• ​MCP协议集成​：标准化接口支持多种AI客户端

• ​全功能覆盖​：登录、发布、搜索、评论等完整功能链

• ​安全稳定​：基于成熟项目，稳定运行一年无封号记录

• ​多平台支持​：支持Claude、Cursor、VSCode、Gemini等客户端

• ​国产化适配​：专门针对小红书平台特性优化

---

主要功能

1. ​功能架构​

2. ​功能详情​

​功能类别​	​具体能力​	​技术实现​
​账号管理​	登录状态检查，会话维护	Cookie管理，安全认证
​内容发布​	图文内容发布，标题和描述优化	小红书API集成，多媒体处理
​内容搜索​	关键词搜索，结果过滤和排序	搜索算法，结果解析
​数据分析​	帖子详情获取，互动数据分析	数据抓取，指标计算
​互动管理​	评论发布，用户互动管理	评论API，用户行为模拟
​推荐系统​	首页推荐内容获取和分析	推荐算法解析，内容筛选

3. ​技术特性​

• ​协议标准化​：完全兼容MCP协议

• ​多客户端支持​：Claude、Cursor、VSCode、Gemini等

• ​安全机制​：完善的错误处理和会话管理

• ​性能优化​：高效的数据处理和网络请求

• ​可扩展性​：模块化设计，易于功能扩展

---

安装与配置

1. ​环境要求​

# 基础要求
操作系统: Windows/macOS/Linux
Golang: 1.18+
内存: 4GB+ RAM
网络: 稳定网络连接

# 小红书账号要求
已验证的小红书账号
未在其他网页端登录（避免会话冲突）

2. ​安装步骤​

​安装Golang环境​：

# macOS
brew install go

# Ubuntu/Debian
sudo apt install golang

# Windows
# 从 https://golang.org/dl/ 下载安装包

​配置Golang环境​：

# 设置国内代理（推荐）
go env -w GOPROXY=https://goproxy.cn,direct

# 或者使用阿里云代理
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

​安装项目​：

# 克隆仓库
git clone https://github.com/xpzouying/xiaohongshu-mcp.git
cd xiaohongshu-mcp

# 安装依赖
go mod download

# 构建项目
go build

3. ​登录配置​

​首次登录​：

# 运行登录程序
go run cmd/login/main.go

# 按照提示完成小红书登录
# 程序会自动保存登录状态

​验证登录状态​：

# 启动MCP服务
go run .

# 在另一个终端检查登录状态
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "check_login_status"
    }
  }'

4. ​服务配置​

​启动服务​：

# 无头模式（推荐）
go run .

# 有界面模式（调试用）
go run . -headless=false

# 指定端口
go run . -port=8080

​环境变量配置​：

# 设置服务端口
export XHS_MCP_PORT=18060

# 设置日志级别
export XHS_LOG_LEVEL=debug

# 设置缓存目录
export XHS_CACHE_DIR=./cache

---

使用指南

1. ​基础工作流​

2. ​客户端配置​

​Claude Code配置​：

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

# 验证连接
claude mcp list

​Cursor配置​：

// 创建 .cursor/mcp.json
{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "小红书内容发布服务"
    }
  }
}

​VSCode配置​：

// 创建 .vscode/mcp.json
{
  "servers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  }
}

3. ​功能使用示例​

​检查登录状态​：

# 使用curl调用
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "check_login_status"
    }
  }'

​发布图文内容​：

# Python调用示例
import requests
import json

def publish_to_xiaohongshu(title, content, image_url):
    payload = {
        "method": "tools/call",
        "params": {
            "name": "publish_content",
            "arguments": {
                "title": title,
                "content": content,
                "images": [image_url]
            }
        }
    }
    
    response = requests.post(
        "http://localhost:18060/mcp",
        json=payload,
        headers={"Content-Type": "application/json"}
    )
    
    return response.json()

# 发布示例
result = publish_to_xiaohongshu(
    "春日赏花攻略",
    "分享几个超美的赏花地点，赶紧收藏吧！",
    "https://example.com/flower.jpg"
)

​搜索内容​：

# 搜索小红书内容
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "search_feeds",
      "arguments": {
        "keyword": "春日穿搭"
      }
    }
  }'

4. ​高级功能​

​批量操作​：

# 批量发布多个内容
contents = [
    {"title": "穿搭分享1", "content": "内容1", "image": "url1"},
    {"title": "穿搭分享2", "content": "内容2", "image": "url2"},
    {"title": "穿搭分享3", "content": "内容3", "image": "url3"}
]

for content in contents:
    result = publish_to_xiaohongshu(
        content["title"],
        content["content"],
        content["image"]
    )
    print(f"发布结果: {result}")

​定时任务​：

# 使用cron定时发布
0 9 * * * /path/to/xiaohongshu-mcp publish --title "早安分享" --content "新的一天开始啦！" --image /path/to/image.jpg

---

应用场景实例

案例1：个人博主内容管理

​场景​：时尚博主每日内容发布和互动

​解决方案​：

# 每日内容发布自动化
def daily_content_routine():
    # 1. 检查登录状态
    check_login_status()
    
    # 2. 发布主要内容
    publish_content(
        title="今日穿搭分享",
        content="简约白色系穿搭，清爽又时尚！",
        images=["https://example.com/outfit1.jpg"]
    )
    
    # 3. 搜索相关话题
    search_results = search_feeds(keyword="简约穿搭")
    
    # 4. 与粉丝互动
    for post in search_results[:3]:
        post_comment(
            feed_id=post["id"],
            xsec_token=post["token"],
            content="穿搭很好看！学习了～"
        )

# 定时执行
schedule.every().day.at("09:00").do(daily_content_routine)

​实施效果​：

• 内容发布效率 ​提升80%​​

• 粉丝互动率 ​提高45%​​

• 每日运营时间 ​从3小时减少到30分钟​

• 内容一致性 ​显著提升​

案例2：品牌社交媒体运营

​场景​：美妆品牌多账号管理

​解决方案​：

​技术实现​：

class BrandSocialManager:
    def __init__(self, accounts):
        self.accounts = accounts
        self.clients = {}
        
        for account in accounts:
            self.clients[account] = XiaohongshuClient(account)
    
    def multi_account_publish(self, content_template):
        for account, client in self.clients.items():
            # 个性化内容
            personalized_content = content_template.format(
                brand=account["brand_name"]
            )
            
            # 发布内容
            client.publish_content(
                title=account["title_template"],
                content=personalized_content,
                images=account["images"]
            )
    
    def monitor_performance(self):
        metrics = {}
        for account, client in self.clients.items():
            metrics[account] = client.get_analytics()
        return metrics

​实施效果​：

• 多账号管理效率 ​提升300%​​

• 内容发布一致性 ​100%保证​

• 运营成本 ​降低60%​​

• 品牌曝光度 ​显著增加​

案例3：电商导流运营

​场景​：电商平台小红书导流

​解决方案​：

# 电商内容自动化发布
class EcommerceXHSManager:
    def __init__(self, product_db):
        self.product_db = product_db
        self.xhs_client = XiaohongshuClient()
    
    def auto_post_products(self):
        # 获取需要推广的产品
        products = self.product_db.get_promotion_products()
        
        for product in products:
            # 生成小红书风格内容
            content = self.generate_xhs_content(product)
            
            # 发布内容
            self.xhs_client.publish_content(
                title=product["title"],
                content=content,
                images=product["images"]
            )
    
    def generate_xhs_content(self, product):
        return f"""
        🔥发现宝藏好物！{product['name']}
        
        💡使用体验：
        {product['description']}
        
        👍推荐指数：⭐️⭐️⭐️⭐️⭐️
        💰价格：{product['price']}
        🛒购买链接：{product['link']}
        
        #好物分享 #{product['category']} #种草
        """
    
    def track_conversion(self):
        # 监控导流效果
        comments = self.xhs_client.get_comments()
        return analyze_conversion(comments)

​实施效果​：

• 导流效率 ​提升200%​​

• 转化率 ​提高35%​​

• 内容生产速度 ​从小时级到分钟级​

• ROI ​显著提升​

案例4：内容机构批量运营

​场景​：MCN机构多博主管理

​解决方案​：

# MCN机构管理系统
class MCNXiaohongshuManager:
    def __init__(self, creators):
        self.creators = creators
        self.accounts = {}
        
        for creator in creators:
            self.accounts[creator["id"]] = {
                "client": XiaohongshuClient(creator["credentials"]),
                "schedule": creator["post_schedule"]
            }
    
    def batch_content_management(self):
        for creator_id, account in self.accounts.items():
            # 获取博主今日内容计划
            content_plan = self.get_daily_content(creator_id)
            
            # 按时发布内容
            for post in content_plan:
                self.schedule_post(creator_id, post)
    
    def performance_analytics(self):
        report = {}
        for creator_id, account in self.accounts.items():
            stats = account["client"].get_performance_stats()
            report[creator_id] = {
                "engagement_rate": stats["engagement"],
                "growth_rate": stats["growth"],
                "content_quality": stats["quality"]
            }
        return report
    
    def automated_interaction(self):
        # 自动与粉丝互动
        for creator_id, account in self.accounts.items():
            comments = account["client"].get_new_comments()
            for comment in comments:
                account["client"].reply_to_comment(
                    comment["id"],
                    self.generate_reply(comment)
                )

​实施效果​：

• 管理效率 ​提升5倍​

• 内容产出量 ​增加300%​​

• 博主成长速度 ​加快50%​​

• 商业化收入 ​显著增长​

---

高级功能与优化

1. ​性能优化​

# 并发处理优化
import asyncio
from concurrent.futures import ThreadPoolExecutor

async def batch_operation(tasks):
    with ThreadPoolExecutor(max_workers=10) as executor:
        loop = asyncio.get_event_loop()
        futures = [
            loop.run_in_executor(executor, task.execute)
            for task in tasks
        ]
        return await asyncio.gather(*futures)

2. ​错误处理​

# 健壮的错误处理机制
def safe_xhs_operation(operation, *args, **kwargs):
    try:
        return operation(*args, **kwargs)
    except XHSAPIError as e:
        if e.is_token_expired():
            refresh_token()
            return operation(*args, **kwargs)
        elif e.is_rate_limited():
            sleep(60)  # 等待1分钟
            return operation(*args, **kwargs)
        else:
            log_error(f"Operation failed: {e}")
            return None

3. ​数据分析​

# 内容性能分析
def analyze_content_performance(posts):
    metrics = []
    for post in posts:
        engagement_rate = (post['likes'] + post['comments']) / post['views']
        metrics.append({
            'post_id': post['id'],
            'engagement_rate': engagement_rate,
            'virality_score': calculate_virality(post),
            'conversion_rate': post['clicks'] / post['views']
        })
    return metrics

---

🌟 ​GitHub地址​：

https://github.com/xpzouying/xiaohongshu-mcp

📚 ​详细文档​：

项目README和docs目录

🎥 ​演示视频​：

仓库中的示例视频文件

​xiaohongshu-mcp​ 代表了社交媒体自动化运营的新方向。正如开发者所述：

"我们通过MCP协议打通了AI助手与小红书平台的壁垒，让内容运营变得简单而高效"

该工具已在多个场景证明其价值：

• ​个人博主​：日常内容发布和粉丝互动

• ​品牌商家​：多账号统一管理和营销推广

• ​MCN机构​：批量博主管理和绩效分析

• ​电商平台​：内容导流和转化优化

• ​营销团队​：数据分析和策略优化

​立即体验xiaohongshu-mcp，开启小红书智能运营新时代！​