# Xiaohongshu MCP Skill

> 小红书技能（MCP版本）

- Skill: `zhouhexin/xiaohongshu-mcp-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zhouhexin/xiaohongshu-mcp-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhouhexin/xiaohongshu-mcp-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: zhouhexin (https://skillmd.com/u/zhouhexin)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zhouhexin/xiaohongshu-mcp-skill

---

# 小红书技能（MCP版本）

## 概述
基于MCP（Model Context Protocol）服务的小红书自动化管理技能。通过MCP服务处理登录认证，提供更安全、稳定的账号管理功能。

## 功能特点
- ✅ **MCP认证**：通过MCP服务处理登录，避免直接暴露Cookie
- ✅ **内容获取**：获取用户信息、笔记、话题内容
- ✅ **数据分析**：互动统计、内容分析、趋势分析
- ✅ **自动发布**：笔记创建、图片上传、定时发布
- ✅ **趋势监控**：热门话题跟踪、竞品分析

## MCP服务优势
1. **安全性**：Cookie由MCP服务管理，不在技能中暴露
2. **稳定性**：MCP服务处理登录状态维护
3. **可扩展**：支持多账号、多平台
4. **易维护**：登录逻辑与服务分离

## 安装要求
1. **OpenClaw**：>= 1.0.0
2. **MCP服务**：小红书MCP服务端
3. **Python**：>= 3.6
4. **依赖包**：requests, pyyaml, pandas, matplotlib

## 快速开始

### 1. 配置MCP服务
```yaml
# mcp_config.yaml
services:
  xiaohongshu:
    type: "oauth2"
    endpoint: "https://mcp.example.com/xiaohongshu"
    client_id: "your_client_id"
    scopes:
      - "user_info"
      - "content_read"
      - "content_write"
```

### 2. 使用技能
```bash
# 通过MCP登录
@小助理 使用MCP登录小红书

# 获取账号信息
@小助理 获取我的小红书账号信息

# 分析内容
@小助理 分析我的小红书笔记

# 发布笔记
@小助理 发布小红书笔记
```

## 模块说明

### 核心模块
- **mcp_auth.py** - MCP认证管理
- **content_crawler.py** - 内容获取（通过MCP）
- **data_analyzer.py** - 数据分析
- **note_publisher.py** - 笔记发布（通过MCP）
- **trend_monitor.py** - 趋势监控

### MCP接口
- `mcp_login()` - 通过MCP服务登录
- `mcp_get_user_info()` - 获取用户信息
- `mcp_get_notes()` - 获取笔记列表
- `mcp_publish_note()` - 发布笔记
- `mcp_upload_image()` - 上传图片

## 安全说明
- 所有敏感操作通过MCP服务进行
- 本地不存储Cookie或令牌
- MCP服务处理令牌刷新
- 支持权限控制

## 配置示例

### MCP服务配置
```json
{
  "mcp_services": {
    "xiaohongshu": {
      "name": "小红书",
      "description": "小红书内容管理服务",
      "endpoints": {
        "auth": "/auth/login",
        "user": "/api/user",
        "notes": "/api/notes",
        "publish": "/api/publish"
      }
    }
  }
}
```

### 技能配置
```yaml
# config/config.yaml
mcp:
  enabled: true
  service_name: "xiaohongshu"
  auto_refresh: true
  timeout: 30
  
features:
  user_info: true
  content_crawl: true
  data_analysis: true
  note_publish: true
  trend_monitor: true
```

## 使用场景

### 场景1：MCP登录
```
用户：@小助理 使用MCP登录小红书

小助理：正在通过MCP服务登录小红书...
✅ MCP登录成功！
   用户：美妆达人小美
   权限：内容读取、发布

已保存MCP会话，有效期：7天
```

### 场景2：数据分析
```
用户：@小助理 分析我的小红书数据

小助理：通过MCP获取你的账号数据...
📊 数据分析完成：
   • 粉丝数：125,430
   • 笔记数：328
   • 平均点赞：1,250
   • 最佳内容类型：教程类
```

### 场景3：内容发布
```
用户：@小助理 帮我发布小红书笔记

小助理：通过MCP服务发布笔记...
📝 笔记信息：
   标题：春季穿搭指南
   图片：3张
   标签：穿搭、春季

正在上传图片...
✅ 图片上传完成
✅ 笔记发布成功！
   链接：https://www.xiaohongshu.com/note/abc123
```

## 故障排除

### 常见问题
1. **MCP服务不可用**
   - 检查MCP服务状态
   - 验证网络连接
   - 检查配置文件

2. **权限不足**
   - 重新授权MCP服务
   - 检查scope权限
   - 联系MCP服务管理员

3. **数据获取失败**
   - 检查MCP接口状态
   - 验证用户权限
   - 查看错误日志

### 日志查看
```bash
# 查看MCP服务日志
tail -f /var/log/mcp/xiaohongshu.log

# 查看技能日志
tail -f ~/.xiaohongshu/logs/skill.log
```

## 更新维护

### 版本更新
```bash
# 更新技能
openclaw skills update xiaohongshu-mcp

# 更新MCP服务
mcp service update xiaohongshu
```

### 数据备份
```bash
# 备份配置
cp -r ~/.xiaohongshu/config ~/.xiaohongshu/backup/config_$(date +%Y%m%d)

# 备份数据
cp -r ~/.xiaohongshu/data ~/.xiaohongshu/backup/data_$(date +%Y%m%d)
```

## 技术支持
- 文档：https://docs.openclaw.ai/skills/xiaohongshu-mcp
- 社区：https://discord.com/invite/clawd
- 问题反馈：https://github.com/openclaw/xiaohongshu-mcp-skill/issues

---

**版本**: 1.0.0-mcp  
**最后更新**: 2026-03-10  
**兼容性**: OpenClaw >= 1.0.0, MCP >= 0.1.0