📕 小红书全能助手

两大核心能力：文案创作（标题+正文+封面图）和平台操作（发布+搜索+互动）。

文案创作默认使用当前对话的主模型，无需额外配置。

---

零、查看可用模型（仅当用户询问时）

当用户询问"有哪些模型"、"当前模型"、"可用模型"、"能用什么模型"时，读取配置文件展示：

# 查看当前主模型
cat ~/.openclaw/openclaw.json | jq -r '.agents.defaults.model.primary // .agents.defaults.model // "未设置"' 2>/dev/null

# 查看所有可用模型（提供商/模型ID - 名称）
cat ~/.openclaw/openclaw.json | jq -r '.models.providers | to_entries[] | .key as $p | .value.models[]? | "\($p)/\(.id) - \(.name)"' 2>/dev/null

---

一、文案创作流程

当用户要求写笔记、生成文案、创作小红书内容时，按标题 → 正文 → 封面图三步执行，每步需用户确认后再继续。

1.1 生成标题

优先使用当前对话模型直接生成，参考references/title-guide.md中的规范生成5个不同风格的标题。

核心要求：每个标题使用不同风格，20字以内，含1-2个emoji，禁用平台禁忌词。

备用方案：如果用户明确配置了XHS_AI_API_KEY环境变量并要求使用指定 API，可调用脚本：

bash {baseDir}/scripts/generate.sh title "内容摘要"

输出后询问用户：选择哪个标题？可修改或自定义。默认选第一个。

1.2 生成正文

优先使用当前对话模型直接生成，参考references/content-guide.md中的规范，根据选定标题生成正文。

核心要求：600-800字，像朋友聊天的语气，禁用列表/编号，用自然段落呈现，文末5-10个#标签。

备用方案：如果用户明确配置了XHS_AI_API_KEY环境变量并要求使用指定 API，可调用脚本：

bash {baseDir}/scripts/generate.sh content "完整内容" "选定标题"

输出后询问用户：是否满意？可要求修改。确认后进入封面图步骤。

1.3 生成封面图

封面图结构：1080x1440（3:4），上半部分为主题图片（1080x720），下半部分为纯色底+标题文字（1080x720）。

1.3.1 询问用户选择封面图片来源

必须先询问用户：

封面图的主题图片，你想怎么来？

1. AI 自动生成— 根据文案主题自动生成匹配的图片
2. 上传自己的图片— 提供图片路径，我来帮你拼接封面

1.3.2A 用户选择「AI生成」

继续询问 prompt 方式：

AI图片的提示词，你想怎么来？

1. 预设推荐— 我根据你的文案主题自动生成最佳英文prompt
2. 自定义提示词— 你提供想要的画面描述，我来翻译成英文prompt

预设推荐：Agent 参考references/cover-guide.md自动生成英文 prompt，展示给用户确认后执行。

自定义提示词：用户描述画面，Agent 翻译/优化为英文 prompt，展示确认后执行。

确认 prompt 后，根据主题从references/cover-guide.md配色库选择底色和字色（必须主动搭配，禁止白底黑字）。

生图模型选择策略

优先尝试当前对话使用的模型直接生图（如果当前模型支持图片生成）。Agent 在自己的对话环境中直接调用生图能力：

1. 生成 3:2 比例的主题图片，保存到临时文件（如/tmp/xhs_ai_img.png）
2. 然后调用 cover.sh 时传入__USER_IMAGE__:/tmp/xhs_ai_img.png，跳过脚本内置的 API 调用

如果当前模型不支持生图（生成失败或明确不具备图片生成能力），询问用户：

当前模型不支持图片生成，请选择生图方式：

1. Google Gemini— 需要提供 GEMINI_API_KEY（获取地址）
2. OpenAI / OpenAI兼容API— 需要提供 API Key 和 Base URL
3. 其他方式— 你来提供图片，我帮你拼接封面

用户选择后，设置对应的环境变量再调用 cover.sh：

• Gemini：GEMINI_API_KEY=xxx bash cover.sh "标题" "prompt" ...
• OpenAI兼容：IMG_API_TYPE=openai IMG_API_KEY=xxx IMG_API_BASE=https://api.openai.com/v1 IMG_MODEL=dall-e-3 bash cover.sh "标题" "prompt" ...
• 腾讯云混元生图（AIART）：IMG_API_TYPE=hunyuan HUNYUAN_SECRET_ID=AKID... HUNYUAN_SECRET_KEY=... HUNYUAN_REGION=ap-guangzhou bash cover.sh "标题" "prompt" ...
• 其他方式用户提供图片路径，走__USER_IMAGE__模式

若用户之前已提供过 API Key（本次会话中），后续生图直接复用，无需重复询问。

直接调用 cover.sh 的命令格式（仅当需要脚本内置 API 生图时）：

bash {baseDir}/scripts/cover.sh "标题文字" "英文prompt" [输出路径] [底色hex] [字色hex]

1.3.2B 用户选择「上传图片」

用户提供图片路径后，同样搭配底色和字色，执行：

bash {baseDir}/scripts/cover.sh "标题文字" "__USER_IMAGE__:/path/to/image.jpg" [输出路径] [底色hex] [字色hex]

__USER_IMAGE__:前缀会跳过 AI 生成，直接用用户图片裁剪拼接。

封面图前置要求

• ImageMagick（convert或magick）、中文字体（fonts-noto-cjk）
• 生图 API Key（仅脚本内置 API 生图时需要，当前模型直接生图则不需要）

1.4 文案完成后

询问用户是否要直接发布到小红书。如果要发布，自动进入下方「平台操作」的发布流程。

---

二、平台操作

当用户要求发帖、搜索、评论等小红书操作时使用。所有命令在云服务器本地执行，MCP 服务运行在http://localhost:18060/mcp。

2.1 前置检查

每次操作前必须先执行：

bash {baseDir}/check_env.sh

返回码：0= 正常已登录 → 调用工具；1= 未安装 → 安装 MCP 服务；2= 未登录 → 扫码登录流程。

2.2 调用工具

⚠️ 极其重要：小红书 MCP 使用 Streamable HTTP 模式。每次调用都必须：初始化 → 获取 Session ID → 带 Session ID 调用工具。三步在同一个 exec 中执行。

MCP_URL="${XHS_MCP_URL:-http://localhost:18060/mcp}"

# 初始化并获取 Session ID
SESSION_ID=$(curl -s -D /tmp/xhs_headers -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"openclaw","version":"1.0"}},"id":1}' > /dev/null && grep -i 'Mcp-Session-Id' /tmp/xhs_headers | tr -d '\r' | awk '{print $2}')

# 确认初始化
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}' > /dev/null

# 调用工具（替换 <工具名> 和 <参数>）
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"<工具名>","arguments":{<参数>}},"id":2}'

注意：每次调用都必须重新初始化获取新 Session ID，三步必须在同一个 exec 中顺序执行。

2.3 可用工具

1. check_login_status — 检查登录状态

• 触发词: "检查登录"、"登录状态"
• 参数: 无

2. get_login_qrcode — 获取登录二维码

• 触发词: "获取二维码"、"扫码登录"
• 参数: 无
• 返回: Base64 图片和超时时间

3. delete_cookies — 重置登录状态

• 触发词: "退出登录"、"重新登录"、"清除登录"
• 参数: 无
• 注意: 删除后需要重新扫码登录

4. publish_content — 发布图文内容

• 触发词: "发小红书"、"发布笔记"、"发图文"
• 参数:
  • title: 标题，≤20字（必填）
  • content: 正文，≤1000字（必填）
  • images: 图片本地绝对路径数组（必填），如["/tmp/food1.jpg"]

5. publish_with_video — 发布视频内容

• 触发词: "发视频"、"发布视频笔记"
• 参数:
  • title: 标题（必填）
  • contentDescription (Required)
  • video: Absolute local path to the video file (Required)

6. search_feeds — Search Content

• Trigger Words: "Search Xiaohongshu", "Find notes", "Search"
• Parameters:
  • keyword: Search keyword (Required)

7. list_feeds — Get Recommended List

• Trigger Words: "Recommended content", "Homepage recommendations"
• Parameters: None

8. get_feed_detail — Get Post Details

• Trigger Words: "Look at this post", "Post details"
• Parameters:
  • feed_id: Post ID (Obtained from search/recommendation results, Required)
  • xsec_token: Security token (Obtained from search/recommendation results, Required)
  • load_all_comments: Whether to load all comments, default is false to return only the first 10 (Optional)
  • 点击查看更多回复：是否展开二级回复，仅当 load_all_comments=true 时生效（可选）
  • limit：限制加载的一级评论数量，默认 20（可选）
  • reply_limit：跳过回复数过多的评论，默认 10（可选）
  • scroll_speed：滚动速度 slow/normal/fast（可选）

9. like_feed — 点赞/取消点赞

• 触发词："点赞"、"取消点赞"、"喜欢这个"
• 参数：
  • feed_id：帖子ID（必填）
  • xsec_token：安全token（必填）
  • unlike：是否取消点赞，true=取消，默认 false=点赞（可选）

10. favorite_feed — 收藏/取消收藏

• 触发词："收藏"、"取消收藏"、"收藏这个"
• 参数：
  • feed_id帖子ID（必填）
  • xsec_token: 安全token（必填）
  • unfavorite: 是否取消收藏，true=取消，默认 false=收藏（可选）

11. post_comment_to_feed — 发表评论

• 触发词: "评论这个"、"发表评论"
• 参数:
  • feed_id: 帖子ID（必填）
  • xsec_token: 安全token（必填）
  • content: 评论内容（必填）

12. reply_comment_in_feed — 回复评论

• 触发词: "回复评论"、"回复这条"
• 参数:
  • feed_id: 帖子ID（必填）
  • xsec_token: 安全token（必填）
  • content回复内容（必填）
  • comment_id: 目标评论ID，从评论列表获取（可选）
  • user_id: 目标评论用户ID，从评论列表获取（可选）

13. user_profile — 获取用户主页

• 触发词: "看看这个博主"、"用户主页"
• 参数:
  • user_id: 用户ID（必填）
  • xsec_token: 安全token（必填）

2.4 使用示例

搜索：

MCP_URL="http://localhost:18060/mcp"
SESSION_ID=$(curl -s -D /tmp/xhs_headers -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"openclaw","version":"1.0"}},"id":1}' > /dev/null && grep -i 'Mcp-Session-Id' /tmp/xhs_headers | tr -d '\r' | awk '{print $2}')
curl -s -X POST "$MCP_URL" -H "Content-Type: application/json" -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}' > /dev/null
curl -s -X POST "$MCP_URL" -H "Content-Type: application/json" -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_feeds","arguments":{"keyword":"美食探店"}},"id":2}'

---

三、登录流程

当前置检查返回2（未登录）时，询问用户选择登录方式：

需要登录小红书，请选择登录方式：

1. 快捷扫码— 直接获取二维码图片（推荐同城/常用设备）
2. 截图扫码— 通过登录工具截屏获取（推荐异地登录，支持短信验证码）
3. 手动Cookie— 直接粘贴浏览器Cookie字符串（推荐已在浏览器登录的用户）

方式一：快捷扫码（get_login_qrcode）

通过 MCP 工具直接获取二维码 Base64 图片，流程简洁，但不支持输入验证码。异地登录可能触发短信验证，此时需切换为方式二。

步骤 1: 调用 get_login_qrcode 获取二维码

MCP_URL="${XHS_MCP_URL:-http://localhost:18060/mcp}"
SESSION_ID=$(curl -s -D /tmp/xhs_headers -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"openclaw","version":"1.0"}},"id":1}' > /dev/null && grep -i 'Mcp-Session-Id' /tmp/xhs_headers | tr -d '\r' | awk '{print $2}')
curl -s -X POST "$MCP_URL" -H "Content-Type: application/json" -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}' > /dev/null
curl -s -X POST "$MCP_URL" -H "Content-Type: application/json" -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_login_qrcode","arguments":{}},"id":2}'

步骤 2: 将 Base64 转为图片文件

从返回结果中提取 Base64 字符串（去掉data:image/png;base64,前缀），保存为图片：

# 假设 BASE64_STR 为提取到的 Base64 内容（不含 data:image/png;base64, 前缀）
echo "$BASE64_STR" | base64 -d > /tmp/xhs_qr.png

步骤 3: 发送二维码给用户

步骤 4: 等待扫码并验证

告知用户扫码，扫码后用check_login_status工具验证是否登录成功。二维码过期则重新执行步骤 1-3。

---

方式二：截图扫码（登录工具 + Xvfb 截屏）

通过 GUI 登录工具获取二维码，支持异地登录时输入短信验证码。

步骤 1: 启动登录工具

所有命令必须用 nohup 后台运行，否则会因超时被中断。

pkill -f xiaohongshu-login 2>/dev/null
sleep 1
cd ~/xiaohongshu-mcp && DISPLAY=:99 nohup ./xiaohongshu-login-linux-amd64 > login.log 2>&1 &
sleep 5

步骤 2: 截取二维码

DISPLAY=:99 import -window root /tmp/xhs_qr.png

步骤 2.1: 检测截图内是否有二维码

zbarimg -q /tmp/xhs_qr.png

• 无输出：二维码未加载，等待 5 秒后重新截图
• 有输出：二维码已生成，继续发送

步骤 3: 发送二维码给用户

步骤 4: 等待扫码

告知用户"已发送二维码，请用小红书APP扫码登录"，等待用户确认。

步骤 4.1: 如提示输入验证码（异地登录常见）

export DISPLAY=:99
WIN_ID=$(xdotool search --onlyvisible --name '小红书|xiaohongshu|Xiaohongshu' | head -n1)
xdotool type --window "$WIN_ID" --delay 50 '<CODE>'
xdotool key --window "$WIN_ID" Return

步骤 5: 验证登录并启动 MCP

cat ~/xiaohongshu-mcp/login.log | tail -5
# 如果显示 "Login successful"：
pkill -f xiaohongshu 2>/dev/null
cd ~/xiaohongshu-mcp && DISPLAY=:99 nohup ./xiaohongshu-mcp-linux-amd64 > mcp.log 2>&1 &

二维码过期

如用户反馈扫码失败，重复步骤 1-3 获取新二维码。

---

方式三：手动Cookie登录

当用户提供浏览器复制的 Cookie 字符串时，将其转换为 JSON 数组格式并保存到~/xiaohongshu-mcp/cookies.json。

步骤 1: 接收用户的 Cookie 字符串

用户会提供类似这样的字符串（从浏览器开发者工具复制）：

a1=19c464ed2df...; webId=807ede65b...; web_session=040069b4...; xsecappid=xhs-pc-web

步骤 2: 转换并保存

将用户提供的 Cookie 字符串按;分割每个键值对，转换为如下 JSON 数组格式，保存到~/xiaohongshu-mcp/cookies.json：

python3 -c "
import json, sys

cookie_str = sys.argv[1].strip()
cookies = []
for pair in cookie_str.split(';'):
    pair = pair.strip()
    if '=' not in pair:
        continue
    name, value = pair.split('=', 1)
    cookies.append({
        'name': name.strip(),
        'value': value.strip(),
        'domain': '.xiaohongshu.com',
        'path': '/',
        'expires': -1,
        'httpOnly': name.strip() in ('web_session', 'id_token', 'acw_tc'),
        'secure': name.strip() in ('web_session', 'id_token'),
        'session': False,
        'priority': 'Medium',
        'sameParty': False,
        'sourceScheme': 'Secure',
        'sourcePort': 443
    })

with open('$HOME/xiaohongshu-mcp/cookies.json', 'w') as f:
    json.dump(cookies, f, ensure_ascii=False)
print(f'✅ 已保存 {len(cookies)} 个 Cookie 到 cookies.json')
" "用户提供的cookie字符串"

步骤 3: 重启 MCP 服务使 Cookie 生效

pkill -f xiaohongshu-mcp-linux 2>/dev/null
sleep 1
cd ~/xiaohongshu-mcp && DISPLAY=:99 nohup ./xiaohongshu-mcp-linux-amd64 > mcp.log 2>&1 &
sleep 3

步骤 4: 验证登录状态

用check_login_status工具验证是否登录成功。如果失败，提示用户 Cookie 可能已过期，建议重新从浏览器获取或改用扫码登录。

注意事项：

• Cookie 中最关键的字段是web_session和a1，缺少这两个会导致登录失败
• 浏览器登录状态和 MCP 登录状态会互相覆盖，导入后建议不要在浏览器再登录同一账号

---

四、安装 MCP 服务（仅首次）

当前置检查返回1时执行。

确认系统环境

hostnamectl

根据Operating System确定包管理器（apt/yum/dnf），根据Architecture确定二进制版本（x86_64=amd64, aarch64=arm64）。

安装依赖

# Ubuntu/Debian
sudo apt update && sudo apt install -y xvfb imagemagick zbar-tools xdotool fonts-noto-cjk

# CentOS/RHEL
sudo yum install -y xorg-x11-server-Xvfb ImageMagick zbar xdotool

启动虚拟显示

# 快速启动
Xvfb :99 -screen 0 1920x1080x24 &

# 或 systemd 服务（推荐，开机自启）
cat > /etc/systemd/system/xvfb.service << 'EOF'
[Unit]
Description=X Virtual Frame Buffer
After=network.target

[Service]
ExecStart=/usr/bin/Xvfb :99 -screen 0 1920x1080x24
Restart=always

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable xvfb && sudo systemctl start xvfb

下载 MCP 服务

项目地址：https://github.com/xpzouying/xiaohongshu-mcp/releases

mkdir -p ~/xiaohongshu-mcp && cd ~/xiaohongshu-mcp

# 根据架构选择（云服务器通常是 x86_64 = amd64）
ARCH="amd64"  # 如果是 ARM 服务器改为 arm64
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-linux-${ARCH}.tar.gz
tar xzf xiaohongshu-mcp-linux-${ARCH}.tar.gz
chmod +x xiaohongshu-*

启动 MCP 服务

It is recommended to use systemd for daemonization (automatic restart on crash + startup on boot):

cat > /etc/systemd/system/xhs-mcp.service << 'EOF'
[Unit]
Description=Xiaohongshu MCP Service
After=network.target xvfb.service
Requires=xvfb.service

[Service]
Environment=DISPLAY=:99
WorkingDirectory=/root/xiaohongshu-mcp
ExecStart=/root/xiaohongshu-mcp/xiaohongshu-mcp-linux-amd64
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable xhs-mcp && sudo systemctl start xhs-mcp
systemctl status xhs-mcp

Or start manually (not recommended, process exit will not automatically recover):

cd ~/xiaohongshu-mcp
DISPLAY=:99 nohup ./xiaohongshu-mcp-linux-amd64 > mcp.log 2>&1 &
sleep 3
pgrep -f xiaohongshu-mcp && echo "✅ 启动成功" || echo "❌ 启动失败，查看 mcp.log"

After installation is complete, return to the login process to complete the first login.

---

V. Response Handling

Success: Parseresult.content[0].textto get the data. Error:

• Not logged in: Not logged in, proceed with QR code scanning process.
• Session expired: Session expired, log in again.
• Rate limited: Rate limited, try again later.

VI. Precautions

1. Title should not exceed20 characters, body text should not exceed1000 characters
2. Images/videos must uselocal absolute paths on the server
3. Xiaohongshu (Little Red Book)does not support simultaneous login on multiple devices, after logging in, do not log in again in the browser.
4. Comment interval is recommended to be > 30 seconds to avoid rate limiting.
5. All GUI processes (login, mcp)must be run in the background using nohup., otherwise it will be interrupted by exec timeout

VII. Troubleshooting

# MCP 服务是否运行
pgrep -f xiaohongshu-mcp-linux

# Xvfb 是否运行
pgrep -x Xvfb

# 查看 MCP 日志
tail -20 ~/xiaohongshu-mcp/mcp.log

# 查看登录日志
tail -20 ~/xiaohongshu-mcp/login.log

# 检查端口
lsof -i :18060

部分文章来自各大搜索引擎，如有侵权，请与我联系删除。