小红书批量管理工具

客户端层 (Claude Code / HTTP Client)
    ↓
接口层 (MCP Server + HTTP Server)
    ↓
服务层 (Service Aggregator)
    ↓
业务模块层 (Batch, Scheduler, Analytics, etc.)
    ↓
核心层 (Xiaohongshu Client)
    ↓
基础设施层 (go-rod, Gin, MCP SDK)

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

# 安装依赖
go mod download

# 编译
go build -o xhs-mcp-pro .

server:
  port: ":18060"

browser:
  headless: true  # false 可以看到浏览器操作
  timeout: 60

xiaohongshu:
  cookie_path: "cookies"  # Cookie 存储目录

business:
  batch:
    max_concurrency: 3    # 批量操作并发数
    retry_times: 3        # 重试次数
    retry_delay: 5        # 重试延迟（秒）
  scheduler:
    enabled: true
  analytics:
    enabled: true

# 开发模式（可以看到浏览器操作）
./xhs-mcp-pro --headless=false

# 生产模式（无头模式）
./xhs-mcp-pro --headless=true

# 指定浏览器路径
./xhs-mcp-pro --bin="/path/to/chrome"

curl http://localhost:18060/health

{
  "tool": "publish_content",
  "arguments": {
    "title": "标题",
    "content": "内容描述",
    "images": [
      "https://example.com/image.jpg",  // HTTP 链接（自动下载）
      "/path/to/local/image.jpg"        // 本地路径
    ],
    "tags": ["美食", "旅行"]
  }
}

{
  "tool": "publish_video",
  "arguments": {
    "title": "视频标题",
    "content": "视频描述",
    "video": "/path/to/video.mp4",
    "tags": ["美食", "教程"]
  }
}

{
  "tool": "batch_publish_content",
  "arguments": {
    "items": [
      {
        "title": "标题1",
        "content": "内容1",
        "images": ["/path/to/image1.jpg"],
        "tags": ["标签1"]
      }
    ],
    "delay_seconds": 10
  }
}

curl -X POST http://localhost:18060/api/v1/publish/content \
  -H "Content-Type: application/json" \
  -d '{
    "title": "标题",
    "content": "内容",
    "images": ["/path/to/image.jpg"],
    "tags": ["美食", "旅行"]
  }'

curl -X POST http://localhost:18060/api/v1/scheduler/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "type": "publish_content",
    "content": {
      "title": "定时发布",
      "content": "内容",
      "images": ["/path/to/image.jpg"]
    },
    "cron_expr": "0 0 9 * * *",
    "account_id": "account_id"
  }'

{
  "mcpServers": {
    "xhs-mcp-pro": {
      "command": "/path/to/xhs-mcp-pro",
      "args": ["--headless", "true"],
      "env": {
        "ROD_BROWSER_BIN": "/path/to/chrome"
      }
    }
  }
}

帮我写一篇帖子发布到小红书上，
配图为：https://example.com/image.jpg
使用 xiaohongshu-mcp 进行发布。

xhs-mcp-pro/
├── main.go                    # 程序入口
├── mcp_server.go              # MCP 服务器
├── app_server.go              # HTTP 服务器
├── handlers_api.go             # API 处理器
├── config.yaml                # 配置文件
├── go.mod                     # Go 模块
├── internal/
│   ├── config/                # 配置管理
│   ├── service/               # 核心服务
│   ├── types/                 # 类型定义
│   ├── xiaohongshu/           # 小红书客户端
│   │   ├── client.go          # 客户端封装
│   │   ├── publish.go         # 图文发布
│   │   └── publish_video.go   # 视频发布
│   └── business/              # 商业功能模块
│       ├── batch.go           # 批量操作
│       ├── scheduler.go       # 定时任务
│       ├── analytics.go       # 数据分析
│       ├── account.go         # 账号管理
│       └── template.go        # 模板管理
├── cookies/                   # Cookie 存储目录
└── docs/                      # 文档目录

./xhs-mcp-pro \
  --headless=false \          # 是否无头模式
  --bin="/path/to/chrome" \    # 浏览器路径
  --port=":18060" \            # 服务端口
  --config="config.yaml"       # 配置文件路径

# 指定浏览器路径
export ROD_BROWSER_BIN="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

log:
  level: "debug"  # debug, info, warn, error
  output: "stdout"  # stdout 或文件路径