xiaohongshu-mcp-pro
小红书 MCP Server，支持无桌面环境（纯命令行/服务器）发布内容，手机号验证码登录（无需扫码），以及多账号独立管理。
基于 xiaohongshu-mcp 二次开发，感谢原作者及所有贡献者的出色工作。
核心特性
| 特性 | 说明 |
|---|
| 无桌面发布 | 完全 Headless，服务器/Docker 环境直接运行，无需图形界面 |
| 手机号登录 | 手机验证码完成登录，无需打开浏览器扫二维码 |
| Session 持久化 | Chrome profile 目录保存完整 session，重启无需重新登录 |
| 多账号管理 | 每个账号独立 profile 目录，session 完全隔离，一键切换 |
| 广播发布 | 一次调用同时向多个账号发布相同内容 |
| 图文 / 视频 | 支持图文笔记和视频笔记发布 |
| 内容浏览 | 首页推荐、搜索、笔记详情、用户主页 |
| 互动操作 | 评论、回复、点赞、收藏 |
快速开始
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 工具。
启动参数
| 参数 | 说明 | 默认值 |
|---|
-bin | Chrome 可执行文件路径 | 自动寻找 |
-port | 监听端口 | :18060 |
-headless | 是否无头模式 | true |
XHS_PROXY | HTTP 代理地址 | 无 |
ACCOUNTS_PATH | 账号注册表文件路径 | accounts.json |
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 个）
登录管理
| 工具 | 说明 |
|---|
creator_phone_login | 发送手机验证码 |
creator_verify_otp | 填写验证码完成登录 |
check_login_status | 检查当前账号登录状态 |
get_login_qrcode | QR 码登录（可选） |
delete_cookies | 重置当前账号登录状态 |
账号管理
| 工具 | 说明 |
|---|
list_accounts | 列出所有账号及激活状态 |
add_account | 添加账号 |
switch_account | 切换激活账号 |
remove_account | 删除账号及其 profile 数据 |
内容发布
| 工具 | 说明 |
|---|
publish_content | 发布图文笔记 |
publish_with_video | 发布视频笔记 |
broadcast_publish | 广播发布到多账号 |
内容浏览
| 工具 | 说明 |
|---|
list_feeds | 获取首页推荐列表 |
search_feeds | 搜索内容 |
get_feed_detail | 获取笔记详情+评论 |
user_profile | 获取用户主页信息 |
互动操作
| 工具 | 说明 |
|---|
post_comment_to_feed | 发表评论 |
reply_comment_in_feed | 回复评论 |
like_feed | 点赞 |
favorite_feed | 收藏 |
详细使用说明
参见 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 &
致谢
