# 小红书自动化管理操作指南

> 基于 xiaohongshu-mcp 的完整自动化运营方案

## 目录

1. [项目概述](#项目概述)
2. [环境部署](#环境部署)
3. [登录认证](#登录认证)
4. [内容发布](#内容发布)
5. [运营管理](#运营管理)
6. [最佳实践](#最佳实践)
7. [故障排除](#故障排除)
8. [附录：完整代码](#附录完整代码)

---

## 项目概述

### 什么是小红书自动化管理？

小红书自动化管理是基于 `xiaohongshu-mcp` 开源项目的一套完整内容运营方案，支持：

- ✅ 图文内容自动发布
- ✅ 视频内容自动发布  
- ✅ 笔记搜索和数据分析
- ✅ 评论管理和互动
- ✅ 账号状态监控

### 项目地址

- GitHub: [https://github.com/xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)
- 官方博客: [https://www.haha.ai/xiaohongshu-mcp](https://www.haha.ai/xiaohongshu-mcp)

---

## 环境部署

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

#### 1. 下载二进制文件

从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载对应平台的文件：

| 平台 | 主程序 | 登录工具 |
|------|--------|----------|
| Linux x64 | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |
| macOS Apple Silicon | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |
| macOS Intel | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |
| Windows x64 | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |

#### 2. 赋予执行权限

```bash
chmod +x xiaohongshu-mcp-linux-amd64
chmod +x xiaohongshu-login-linux-amd64
```

#### 3. 目录结构建议

```
xiaohongshu-automation/
├── bin/
│   ├── xiaohongshu-mcp-linux-amd64
│   └── xiaohongshu-login-linux-amd64
├── media/
│   ├── images/
│   └── videos/
├── scripts/
│   └── publish.py
└── data/
    └── cookies/
```

### 方式二：Docker 容器（最简单）

```bash
# 1. 拉取镜像
docker pull xpzouying/xiaohongshu-mcp

# 2. 使用 Docker Compose
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml
docker compose up -d

# 3. 查看日志
docker compose logs -f
```

---

## 登录认证

### 重要提示

⚠️ **最关键：不要在多个网页端登录同一账号！**

> 登录了 MCP 服务后，**不要再在其他网页端登录该账号**，否则会把 MCP 会话"踢出登录"。可以使用手机 App 查看账号信息。

### 登录步骤

#### 1. 运行登录工具

```bash
cd bin/
./xiaohongshu-login-linux-amd64
```

#### 2. 扫码登录

工具会打开浏览器显示二维码，用小红书手机 App 扫码即可。

#### 3. 验证登录状态

启动 MCP 服务后，检查登录状态：

```bash
curl http://localhost:18060/api/v1/login/status
```

成功响应：
```json
{
  "success": true,
  "data": {
    "is_logged_in": true,
    "username": "your_username"
  },
  "message": "检查登录状态成功"
}
```

---

## 内容发布

### 图文发布

#### 内容规范

- **标题**: 不超过 20 个字（非常重要）
- **正文**: 不超过 1000 个字（非常重要）
- **图片**: 支持本地绝对路径或 HTTP/HTTPS 链接
- **标签**: 建议添加 3-5 个相关标签

#### Python 代码示例

```python
#!/usr/bin/env python3
"""
小红书图文发布脚本
"""

import requests
import json
import sys
import os

BASE_URL = "http://localhost:18060"

def publish_note(title, content, images, tags=None):
    """
    发布图文笔记
    
    Args:
        title: 笔记标题（≤20字）
        content: 笔记内容（≤1000字）
        images: 图片路径列表（本地绝对路径）
        tags: 可选标签列表
    
    Returns:
        API 响应结果
    """
    payload = {
        "title": title,
        "content": content,
        "images": images
    }
    
    if tags:
        payload["tags"] = tags
    
    try:
        resp = requests.post(
            f"{BASE_URL}/api/v1/publish",
            json=payload,
            timeout=120
        )
        return resp.json()
    except Exception as e:
        print(f"发布异常: {e}")
        return None

# 使用示例
if __name__ == "__main__":
    title = "✨ 你的笔记标题"
    content = """这里是笔记正文内容

可以换行，用空行分段。

#标签1 #标签2 #标签3"""
    
    images = [
        "/path/to/your/image1.jpg",
        "/path/to/your/image2.jpg"
    ]
    
    result = publish_note(title, content, images)
    print(json.dumps(result, ensure_ascii=False, indent=2))
```

### 视频发布

#### 视频规范

- **格式**: 仅支持本地视频文件绝对路径
- **大小**: 建议不超过 1GB
- **处理时间**: 视频处理时间较长，请耐心等待
- **标题和正文**: 同图文规范

#### Python 代码示例

```python
#!/usr/bin/env python3
"""
小红书视频发布脚本
"""

import requests
import json
import time

BASE_URL = "http://localhost:18060"

def publish_video(title, content, video_path, tags=None):
    """
    发布视频笔记
    
    Args:
        title: 视频标题（≤20字）
        content: 视频描述（≤1000字）
        video_path: 视频文件本地绝对路径
        tags: 可选标签列表
    
    Returns:
        API 响应结果
    """
    payload = {
        "Title": title,
        "Content": content,
        "Video": video_path
    }
    
    if tags:
        payload["Tags"] = tags
    
    print(f"开始发布: {title}")
    print(f"开始时间: {time.strftime('%Y-%m-%d %H:%M:%S')}")
    print("视频处理需要时间，请耐心等待...")
    
    try:
        resp = requests.post(
            f"{BASE_URL}/api/v1/publish_video",
            json=payload,
            timeout=1800  # 30分钟超时
        )
        
        print(f"结束时间: {time.strftime('%Y-%m-%d %H:%M:%S')}")
        return resp.json()
    except Exception as e:
        print(f"发布异常: {e}")
        return None

# 使用示例
if __name__ == "__main__":
    title = "🎬 你的视频标题"
    content = """这里是视频描述

#标签1 #标签2 #标签3"""
    
    video_path = "/path/to/your/video.mp4"
    
    result = publish_video(title, content, video_path)
    print(json.dumps(result, ensure_ascii=False, indent=2))
```

---

## 运营管理

### 搜索笔记

```python
def search_notes(keyword, sort_by="综合", note_type="不限", publish_time="不限"):
    """
    搜索小红书笔记
    
    Args:
        keyword: 搜索关键词
        sort_by: 排序方式（综合/最新/最多点赞/最多评论/最多收藏）
        note_type: 笔记类型（不限/视频/图文）
        publish_time: 发布时间（不限/一天内/一周内/半年内）
    
    Returns:
        搜索结果
    """
    payload = {
        "keyword": keyword,
        "filters": {
            "sort_by": sort_by,
            "note_type": note_type,
            "publish_time": publish_time
        }
    }
    
    resp = requests.post(
        f"{BASE_URL}/api/v1/feeds/search",
        json=payload,
        timeout=60
    )
    return resp.json()
```

### 获取推荐列表

```python
def get_recommended_feeds():
    """获取首页推荐笔记列表"""
    resp = requests.get(f"{BASE_URL}/api/v1/feeds/list", timeout=60)
    return resp.json()
```

### 获取笔记详情

```python
def get_note_detail(feed_id, xsec_token, load_comments=False):
    """
    获取笔记完整详情
    
    Args:
        feed_id: 笔记 ID（从搜索或推荐列表获取）
        xsec_token: 安全令牌（从搜索或推荐列表获取）
        load_comments: 是否加载所有评论
    
    Returns:
        笔记详情（含互动数据和评论）
    """
    payload = {
        "feed_id": feed_id,
        "xsec_token": xsec_token,
        "load_all_comments": load_comments
    }
    
    resp = requests.post(
        f"{BASE_URL}/api/v1/feeds/detail",
        json=payload,
        timeout=60
    )
    return resp.json()
```

---

## 最佳实践

### 1. 发布频率控制

- **每日限制**: 建议不超过 50 篇/天
- **时间间隔**: 两篇发布之间建议间隔 5-10 分钟
- **错峰发布**: 避免在高峰期集中发布

### 2. 内容质量建议

- **标题**: 20 字以内，包含关键词
- **正文**: 1000 字以内，段落清晰
- **图片/视频**: 清晰、原创、无水印
- **标签**: 3-5 个相关标签，不要堆砌

### 3. 账号安全建议

- ✅ 只用手机 App 查看发布结果
- ✅ 不要在多个网页端登录同一账号
- ✅ 先实名认证再开始运营
- ✅ 定期检查账号状态
- ❌ 不要出现引流、纯搬运内容
- ❌ 不要使用违禁词

### 4. 限流保护代码

```python
import time
import random
from functools import wraps

def rate_limited(calls_per_second=1.0, max_retries=5):
    """
    限流装饰器
    
    Args:
        calls_per_second: 每秒最多调用次数
        max_retries: 最大重试次数
    """
    min_interval = 1.0 / calls_per_second
    last_call = 0.0
    
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            nonlocal last_call
            
            for attempt in range(max_retries + 1):
                # 限流等待
                now = time.time()
                time_since_last = now - last_call
                if time_since_last < min_interval:
                    time.sleep(min_interval - time_since_last)
                last_call = time.time()
                
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    error_msg = str(e).lower()
                    is_rate_limit = any(kw in error_msg for kw in [
                        'rate limit', 'too many requests', '429', '限流'
                    ])
                    
                    if is_rate_limit and attempt < max_retries:
                        # 指数退避 + 抖动
                        delay = 2.0 * (2 ** attempt) * random.uniform(0.8, 1.2)
                        time.sleep(min(delay, 60))
                    else:
                        raise
            
            raise Exception("超过最大重试次数")
        
        return wrapper
    return decorator
```

---

## 故障排除

### 常见问题

#### Q1: 发布后没有看到笔记？

**A**: 
1. 用手机 App 查看（不要用网页端）
2. 等待 5-10 分钟，可能有延迟
3. 检查是否触发了审核流程

#### Q2: 提示"未登录"？

**A**: 
1. 检查是否在其他网页端登录了同一账号
2. 如果是，退出网页端登录
3. 重新运行登录工具扫码登录

#### Q3: 视频发布卡住？

**A**: 
1. 视频处理需要时间，耐心等待（建议 30 分钟超时）
2. 检查视频大小和格式
3. 尝试先发图文验证账号状态

#### Q4: 发布失败，提示错误？

**A**:
1. 检查标题长度（≤20 字）
2. 检查正文长度（≤1000 字）
3. 检查内容中是否有违禁词
4. 检查今日发布量是否超限

### 健康检查

```python
def check_service_health():
    """检查服务健康状态"""
    try:
        resp = requests.get(f"{BASE_URL}/health", timeout=10)
        return resp.json()
    except Exception as e:
        return {"success": False, "error": str(e)}

def check_login_status():
    """检查登录状态"""
    try:
        resp = requests.get(f"{BASE_URL}/api/v1/login/status", timeout=10)
        return resp.json()
    except Exception as e:
        return {"success": False, "error": str(e)}
```

---

## 附录：完整代码

### 完整发布脚本（含限流保护）

```python
#!/usr/bin/env python3
"""
小红书完整发布脚本（含限流保护）
"""

import requests
import json
import time
import random
from functools import wraps

BASE_URL = "http://localhost:18060"

def rate_limited(calls_per_second=0.5, max_retries=5):
    """限流装饰器"""
    min_interval = 1.0 / calls_per_second
    last_call = 0.0
    
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            nonlocal last_call
            
            for attempt in range(max_retries + 1):
                now = time.time()
                time_since_last = now - last_call
                if time_since_last < min_interval:
                    time.sleep(min_interval - time_since_last)
                last_call = time.time()
                
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    error_msg = str(e).lower()
                    is_rate_limit = any(kw in error_msg for kw in [
                        'rate limit', 'too many requests', '429', '限流'
                    ])
                    
                    if is_rate_limit and attempt < max_retries:
                        delay = 2.0 * (2 ** attempt) * random.uniform(0.8, 1.2)
                        time.sleep(min(delay, 60))
                    else:
                        raise
            
            raise Exception("超过最大重试次数")
        return wrapper
    return decorator

@rate_limited(calls_per_second=0.5, max_retries=3)
def publish_image_note(title, content, images, tags=None):
    """发布图文笔记"""
    if len(title) > 20:
        print(f"⚠️  标题过长: {len(title)} 字（建议≤20）")
    
    if len(content) > 1000:
        print(f"⚠️  正文过长: {len(content)} 字（建议≤1000）")
    
    payload = {
        "title": title,
        "content": content,
        "images": images
    }
    
    if tags:
        payload["tags"] = tags
    
    resp = requests.post(
        f"{BASE_URL}/api/v1/publish",
        json=payload,
        timeout=120
    )
    return resp.json()

@rate_limited(calls_per_second=0.3, max_retries=3)
def publish_video_note(title, content, video_path, tags=None):
    """发布视频笔记"""
    if len(title) > 20:
        print(f"⚠️  标题过长: {len(title)} 字（建议≤20）")
    
    if len(content) > 1000:
        print(f"⚠️  正文过长: {len(content)} 字（建议≤1000）")
    
    payload = {
        "Title": title,
        "Content": content,
        "Video": video_path
    }
    
    if tags:
        payload["Tags"] = tags
    
    print(f"开始发布视频: {title}")
    print(f"开始时间: {time.strftime('%Y-%m-%d %H:%M:%S')}")
    print("视频处理需要时间，请耐心等待...")
    
    resp = requests.post(
        f"{BASE_URL}/api/v1/publish_video",
        json=payload,
        timeout=1800
    )
    
    print(f"结束时间: {time.strftime('%Y-%m-%d %H:%M:%S')}")
    return resp.json()

def check_status():
    """检查服务和登录状态"""
    print("="*60)
    print("检查服务状态...")
    
    # 健康检查
    try:
        resp = requests.get(f"{BASE_URL}/health", timeout=10)
        health = resp.json()
        print(f"服务健康: {health.get('success', False)}")
    except Exception as e:
        print(f"服务检查失败: {e}")
    
    # 登录检查
    try:
        resp = requests.get(f"{BASE_URL}/api/v1/login/status", timeout=10)
        login = resp.json()
        is_logged_in = login.get('data', {}).get('is_logged_in', False)
        username = login.get('data', {}).get('username', 'Unknown')
        print(f"登录状态: {is_logged_in}")
        if is_logged_in:
            print(f"用户名: {username}")
    except Exception as e:
        print(f"登录检查失败: {e}")
    
    print("="*60)

# 使用示例
if __name__ == "__main__":
    import sys
    
    if len(sys.argv) > 1 and sys.argv[1] == "check":
        check_status()
    else:
        print("请修改脚本中的内容后运行")
        print("或运行: python script.py check  检查状态")
```

---

## 总结

这份操作指南涵盖了小红书自动化管理的完整流程：

1. ✅ 环境部署（二进制/Docker）
2. ✅ 登录认证（重要安全提示）
3. ✅ 内容发布（图文/视频完整代码）
4. ✅ 运营管理（搜索/详情/互动）
5. ✅ 最佳实践（频率/质量/安全）
6. ✅ 故障排除（常见问题/健康检查）
7. ✅ 完整代码（含限流保护）

根据官方建议，**图文的流量会比视频更好**，可以根据实际情况选择发布形式。

---

**参考资料**
- GitHub 项目: https://github.com/xpzouying/xiaohongshu-mcp
- 官方博客: https://www.haha.ai/xiaohongshu-mcp
- Docker Hub: https://hub.docker.com/r/xpzouying/xiaohongshu-mcp


小红书自动化管理是基于 xiaohongshu-mcp 开源项目的一套完整内容运营方案，支持：

小龙虾自动管理小红书最全手册（含码、问题规避设置）

编程语言

小红书自动化管理工具基于xiaohongshu-mcp开源项目，提供图文/视频自动发布、数据分析、评论管理等完整运营方案。支持Docker部署和预编译二进制文件，包含限流保护机制和最佳实践指南，帮助用户高效运营小红书账号。

安全令牌

容器

Docker

Python

GitHub

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

小龙虾自动管理小红书最全手册（含码、问题规避设置）-腾讯云开发者社区-腾讯云

小龙虾自动管理小红书最全手册（含码、问题规避设置）

小龙虾自动管理小红书最全手册（含码、问题规避设置）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐