小红书 - RedNote

2026-03-26 新闻来源：网淘吧围观:77

电脑广告

手机广告

📕 小红书全能助手

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

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

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

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

# 查看当前主模型
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 询问用户选择封面图片来源

必须先询问用户：

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

AI 自动生成— 根据文案主题自动生成匹配的图片

上传自己的图片— 提供图片路径，我来帮你拼接封面

1.3.2A 用户选择「AI生成」

继续询问 prompt 方式：

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

预设推荐— 我根据你的文案主题自动生成最佳英文prompt

自定义提示词— You describe the desired scene, and I will translate it into an English prompt.

Preset Recommendations: Agent Referencereferences/cover-guide.mdAutomatically generate an English prompt, present it to the user for confirmation, and then execute.

Custom Prompt: The user describes the scene, and the Agent translates/optimizes it into an English prompt. After presenting it for confirmation, execute.

After confirming the prompt, select the background and text colors from thereferences/cover-guide.mdcolor palette based on the theme (must actively match colors; white background with black text is prohibited).

Image Generation Model Selection Strategy

Prioritize trying the model used in the current conversationGenerate image directly (if the current model supports image generation). The Agent directly calls the image generation capability within its own conversation environment:

Generate a theme image with a 3:2 aspect ratio, save it to a temporary file (e.g.,/tmp/xhs_ai_img.png)
Then, when calling cover.sh, pass__USER_IMAGE__:/tmp/xhs_ai_img.pngto skip the built-in API call in the script.

If the current model does not support image generation(generation fails or clearly lacks image generation capability),ask the user:

The current model does not support image generation. Please choose an image generation method:

Google Gemini— Requires providing GEMINI_API_KEY (Get address)

OpenAI / OpenAI-compatible API— 需要提供 API Key 和 Base URL

其他方式— 你来提供图片，我帮你拼接封面

用户选择后，设置对应的环境变量再调用 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: 标题（必填）
- content: 描述（必填）
- video: 视频文件本地绝对路径（必填）

6. search_feeds — 搜索内容

触发词: "搜索小红书"、"找笔记"、"搜一下"
参数:
- keyword: 搜索关键词（必填）

7. list_feeds — 获取推荐列表

触发词: "推荐内容"、"首页推荐"
参数: 无

8. get_feed_detail — 获取帖子详情

触发词: "看看这个帖子"、"帖子详情"
参数:
- feed_id: 帖子ID（从搜索/推荐结果获取，必填）
- xsec_token: 安全令牌（从搜索/推荐结果获取，必填）
- load_all_comments: 是否加载全部评论，默认 false 仅返回前 10 条（可选）
- click_more_replies: 是否展开二级回复，仅 load_all_comments=true 时生效（可选）
- limit: 限制加载的一级评论数量，默认 20（可选）
- reply_limit: 跳过回复数过多的评论，默认 10（可选）
- scroll_speed: 滚动速度 slow/normal/fast（可选）

9. like_feed — 点赞/取消点赞

触发词: "点赞"、"取消点赞"、"喜欢这个"
参数:
- feed_id: 帖子ID（必填）
- xsec_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（未登录）时，询问用户选择登录方式：

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

快捷扫码— 直接获取二维码图片（推荐同城/常用设备）

截图扫码— 通过登录工具截屏获取（推荐异地登录，支持短信验证码）

手动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

根据操作系统确定包管理器（apt/yum/dnf），根据系统架构确定二进制版本（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 服务

推荐使用 systemd 守护（崩溃自动重启 + 开机自启）：

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

或手动启动（不推荐，进程退出不会自动恢复）：

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

安装完成后，回到登录流程完成首次登录。

五、响应处理

成功：解析result.content[0].text获取数据。错误：

未登录: 未登录，走扫码流程
会话过期: 会话过期，重新登录
频率限制: 频率限制，稍后重试

六、注意事项

标题不超过20 字，正文不超过1000 字
图片/视频必须使用服务器上的本地绝对路径
小红书不支持多设备同时登录，登录后不要在浏览器再登录
评论间隔建议 > 30 秒，避免频率限制
所有带 GUI 的进程（login、mcp）必须用 nohup 后台运行，否则会被 exec 超时中断

七、故障排查

# 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

天猫隐藏优惠券

网淘吧

免责申明

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

打赏

文章底部电脑广告

手机广告位-内容正文底部

标签

上一篇：Linear技能使用说明下一篇：Anti-Injection-Skill技能使用说明

小红书 - RedNote

📕 小红书全能助手

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

一、文案创作流程

1.1 生成标题

1.2 生成正文

1.3 生成封面图

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

1.3.2A 用户选择「AI生成」

Image Generation Model Selection Strategy

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

封面图前置要求

1.4 文案完成后

二、平台操作

2.1 前置检查

2.2 调用工具

2.3 可用工具

1. check_login_status — 检查登录状态

2. get_login_qrcode — 获取登录二维码

3. delete_cookies — 重置登录状态

4. publish_content — 发布图文内容

5. publish_with_video — 发布视频内容

6. search_feeds — 搜索内容

7. list_feeds — 获取推荐列表

8. get_feed_detail — 获取帖子详情

9. like_feed — 点赞/取消点赞

10. favorite_feed — 收藏/取消收藏

触发词

触发词

13. user_profile — 获取用户主页

2.4 使用示例

三、登录流程

方式一：快捷扫码（get_login_qrcode）

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

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

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

步骤 4: 等待扫码并验证

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

步骤 1: 启动登录工具

步骤 2: 截取二维码

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

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

步骤 4: 等待扫码

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

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

二维码过期

方式三：手动Cookie登录

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

步骤 2: 转换并保存

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

步骤 4：验证登录状态

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

确认系统环境

安装依赖

启动虚拟显示

下载 MCP 服务

启动 MCP 服务

五、响应处理

六、注意事项

七、故障排查

相关文章

推荐文章

热门浏览

标签列表