xiaohongshu-mcp-pro

小红书 MCP Server，支持无桌面环境（纯命令行/服务器）发布内容，手机号验证码登录（无需扫码），以及多账号独立管理。

基于 xiaohongshu-mcp 二次开发，感谢原作者及所有贡献者的出色工作。

核心特性

快速开始

1. 启动服务

# 无头模式（服务器/Docker 推荐）
./xiaohongshu-mcp-pro -bin /usr/bin/google-chrome

# 本机调试（可见浏览器操作过程）
./xiaohongshu-mcp-pro -bin /usr/bin/google-chrome -headless=false

# 使用代理
XHS_PROXY=http://user:pass@host:port ./xiaohongshu-mcp-pro -bin /usr/bin/google-chrome

服务启动后监听 http://localhost:18060/mcp，注册 20 个 MCP 工具。

启动参数

2. 登录（手机号，推荐）

# 步骤 1：发送验证码（11 位手机号，不需要加 +86）
creator_phone_login(phone="13800000000")

# 步骤 2：填写 6 位验证码
creator_verify_otp(otp="123456")
→ 自动完成 creator + www 两个域的 session，写入 profile，重启不丢失

# 步骤 3：确认登录状态
check_login_status()

部分账号存在二步验证： 填写验证码后，小红书可能弹出安全验证二维码（creator_verify_otp 会返回截图）。用小红书 App 扫码后，服务自动检测跳转并完成 session 保存，整个过程最多等待 120 秒，无需额外操作。

3. 发布内容

# 图文笔记
publish_content(
  title="标题",
  content="正文",
  images=["/绝对路径/image.jpg"],
  tags=["话题"],
  visibility="仅自己可见"
)

# 视频笔记
publish_with_video(
  title="标题",
  content="正文",
  video="/绝对路径/video.mp4"
)

4. 多账号管理

# 添加新账号（自动切换为激活）
add_account(name="副号")

# 用新账号登录
creator_phone_login(phone="副号手机号")
creator_verify_otp(otp="验证码")

# 切换账号
switch_account(name="default")   # 切回主号
switch_account(name="副号")      # 切到副号

# 查看所有账号
list_accounts()

5. 广播发布（多账号同时发布）

broadcast_publish(
  accounts=["default", "副号"],
  title="标题",
  content="正文",
  images=["/path/image.jpg"]
)

MCP 工具清单（20 个）

登录管理

账号管理

内容发布

内容浏览

互动操作

详细使用说明

参见 USAGE.md。

常驻运行

systemd

[Unit]
Description=Xiaohongshu MCP Pro Server
After=network.target

[Service]
ExecStart=/path/to/xiaohongshu-mcp-pro -bin /usr/bin/google-chrome
WorkingDirectory=/path/to/workdir
Environment=ACCOUNTS_PATH=/path/to/workdir/accounts.json
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

后台进程

nohup ./xiaohongshu-mcp-pro -bin /usr/bin/google-chrome > /tmp/xhs-mcp.log 2>&1 &

致谢

本项目基于 xpzouying/xiaohongshu-mcp 二次开发。感谢原项目作者 @xpzouying 及全体贡献者构建了完整的小红书 MCP 基础能力，本项目在此基础上新增了手机号登录、Chrome profile 持久化 session 以及多账号管理等功能。