- name
- xiaohongshu-mcp-openclaw
- description
- 当用户提到小红书/XHS/Rednote 并需要关键词搜笔记、看笔记详情、抓评论、统计点赞与评论数时使用。通过 xpzouying/xiaohongshu-mcp + mcporter 提供统一查询流程。
- metadata
- {"openclaw":{"emoji":"📕","requires":{"bins":["bash","mcporter","python3","jq"]},"install":[{"id":"node","kind":"node","package":"mcporter","bins":["mcporter"],"label":"Install mcporter (node)"}]}}
xiaohongshu-mcp-openclaw
通过本 skill 可统一完成：
- 关键词搜索笔记
- 获取笔记详情和评论
- 输出点赞数/评论数等归一化指标
- 多笔记抓取并自动汇总
Quick Start
初始化（安装服务端 + 启动 + 注册 + 冒烟 + 登录守卫）：
bash {baseDir}/scripts/quickstart.sh分发前环境预检：
bash {baseDir}/scripts/preflight.sh已安装到 OpenClaw 后可用：
bash {baseDir}/scripts/install_to_openclaw.sh
openclaw skills info xiaohongshu-mcp-openclaw默认会同步到 ~/.agents/skills/xiaohongshu-mcp-openclaw-1.0.0；如不需要可加 XHS_SYNC_AGENTS_SKILL=0。
Agent Rules (Critical)
- 用户提到“登录/扫码/看不到二维码/fail to login/未登录”时，必须先执行：
bash {baseDir}/scripts/login_qr.sh xiaohongshu-mcp- 回复用户时必须带上脚本输出中的
qr_file和open_command（若存在）。 - 若返回
status=qr_url_ready，必须返回qr_url_hint（和open_command若存在），不要只说“请扫码”。 - 禁止直接调用
mcporter call xiaohongshu-mcp.get_login_qrcode --output raw后只给文字提示。
Core Commands
登录守卫（已登录则直接返回）：
python3 {baseDir}/scripts/xhs_mcp_client.py --server xiaohongshu-mcp ensure-login二维码登录（推荐，落盘 PNG 并返回可打开路径）：
bash {baseDir}/scripts/login_qr.sh xiaohongshu-mcp仅生成二维码文件，不自动打开：
XHS_QR_AUTO_OPEN=0 bash {baseDir}/scripts/login_qr.sh xiaohongshu-mcp登录守卫精简模式（不返回完整二维码 base64）：
python3 {baseDir}/scripts/xhs_mcp_client.py --server xiaohongshu-mcp ensure-login --strip-qr-image登录专用流程（临时 headful，成功后自动切回 headless）：
bash {baseDir}/scripts/login_flow.sh xiaohongshu-mcp 120关键词搜索：
python3 {baseDir}/scripts/xhs_mcp_client.py --server xiaohongshu-mcp search --keyword 防晒 --limit 5详情 + 评论报告：
python3 {baseDir}/scripts/xhs_mcp_client.py --server xiaohongshu-mcp report --keyword 防晒 --search-limit 5 --comment-limit 3多笔记总结：
bash {baseDir}/scripts/multi_summary.sh 防晒 5 2登录诊断：
bash {baseDir}/scripts/login_doctor.sh xiaohongshu-mcp生成可分享分发包：
bash {baseDir}/scripts/build_distribution.sh可选：安装系统级常驻服务（防止隔天 offline）：
bash {baseDir}/scripts/service_install.sh xiaohongshu-mcp
bash {baseDir}/scripts/service_status.sh xiaohongshu-mcpNotes
- 默认
headless=true，避免频繁弹浏览器页面。 - 脚本主要面向 Linux/macOS shell；Windows 建议用 WSL/Git Bash。
- 常驻服务支持：macOS
launchd、Linuxsystemd --user。 - 查询命令默认带登录预检（未登录会直接返回并提示
ensure-login）。 ensure-login默认包含二维码图片数据，便于上层代理直接展示扫码图。- 登录场景优先使用
scripts/login_qr.sh，该脚本会把二维码保存到本地 PNG（默认~/.openclaw/workspace/xhs-login-qrcode.png），避免“有扫码提示但看不到二维码图片”。 xhs_mcp_client.py/login_qr.sh已兼容mcporter的非标准对象输出（JS object literal），不依赖PyYAML也可解析二维码。- 禁止直接调用
mcporter call xiaohongshu-mcp.get_login_qrcode --output raw并只回复文字；必须返回qr_file（或open_command）给用户。 - 若服务未启动，
xhs_mcp_client.py会返回error_type=server_offline和可直接执行的next_commands（先启动再重试），不要只回复“离线”。 detail/comments建议传xsec_token（可从search结果中取）。- 出现登录/验证码时，需用户手动完成校验后重试。
- 返回 “Sorry, This Page Isn't Available Right Now.” 多为目标笔记当前账号不可见。
- 新会话如果没有加载该 skill，可先执行
openclaw skills info xiaohongshu-mcp-openclaw；找不到时执行bash {baseDir}/scripts/install_to_openclaw.sh后再新开会话。
Full Docs
详细使用说明见：
README.mdreferences/field-mapping.md