Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
小红书内容发布与管理助手。当用户要求登录、发小红书、搜索小红书、评论点赞收藏等任何小红书相关操作时使用。
小红书内容发布与管理助手。当用户要求登录、发小红书、搜索小红书、评论点赞收藏等任何小红书相关操作时使用。
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
首次使用需要确认环境中有 Python 解释器。 # 使用 pip 安装 pip install -U xhs-mcp-py # 安装 Playwright 浏览器(必需) playwright install chromium
小红书所有功能(发布、搜索、点赞、评论等)都需要先登录。
执行任何操作前,先检查是否已登录: xhs-mcp status 输出 ✅ 已登录:可以继续操作 输出 ❌ 未登录:必须先执行登录步骤
推荐按以下顺序尝试登录: 方式一:终端二维码(Claude Code / Open Code 推荐) xhs-mcp login-qrcode --terminal ⚠️ 需要安装 zbar 库才能解析二维码: macOS: brew install zbar Ubuntu: apt install libzbar0 如果未安装 zbar,会自动保存二维码图片并提示路径 用户扫码后按回车完成登录 如果终端显示失败,fallback 到方式二 方式二:浏览器扫码登录(有图形界面的环境) xhs-mcp login-browser 会弹出浏览器窗口供用户扫码 如果无法弹出浏览器(如远程服务器无图形界面),会提示使用二维码方式 方式三:保存二维码图片(OpenClaw 推荐) xhs-mcp login-qrcode --save /tmp/qrcode.png 将二维码图片发送给用户扫码 用户扫码后按回车完成登录 如果以上方式都失败: 提醒用户需要安装浏览器环境(Playwright + Chromium) 或需要图形界面环境
login-qrcode 参数: 参数类型必需说明-s/--savestring❌保存二维码图片到指定路径--terminal/--no-terminalflag❌是否在终端显示二维码(默认 terminal) 登录成功后,cookies 会保存到本地文件,后续操作自动复用(有效期约 7-30 天)。
命令:xhs-mcp publish 参数:(-i/--image、--tag 可多次指定) 参数类型必需说明-t/--titlestring✅文字标题-c/--contentstring✅文字正文内容-i/--imagestring✅图片路径(可多次指定)--tagstring❌话题标签(可多次指定)--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp publish -t "标题" -c "正文" -i /abs/1.jpg -i /abs/2.jpg --tag 旅行 --tag 美食
命令:xhs-mcp publish-video 参数: 参数类型必需说明-t/--titlestring✅文字标题-c/--contentstring✅文字正文内容-v/--videostring✅视频路径--tagstring❌话题标签(可多次指定)--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp publish-video -t "标题" -c "正文" -v /abs/video.mp4
命令:xhs-mcp publish-text-card 参数:(-p/--page、--tag 可多次指定) 参数类型必需说明-c/--coverstring✅封面文字-p/--pagestring❌正文页文字(可多次指定,最多17页)-s/--stylestring❌卡片样式:基础|边框|备忘|手写|便签|涂写|简约|光影|几何-t/--titlestring❌文字标题--contentstring❌文字正文内容--tagstring❌话题标签(可多次指定)--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp publish-text-card -c "封面" -p "第一页" -p "第二页" -s "基础" -t "笔记标题"
命令:xhs-mcp search 参数: 参数类型必需说明-k/--keywordstring✅搜索关键词--headless/--no-headlessflag❌是否无头模式(默认 headless) 输出: 命令会打印搜索到的笔记列表。每条结果会包含: ID:对应后续命令里的 --feed-id xsec_token:对应后续命令里的 --xsec-token 示例(截断): 1. 标题... 作者: xxx | 点赞: 123 ID: 1234567890abcdef xsec_token: xsec_xxx
以下命令需要你先从搜索结果或笔记链接中拿到 feed_id 和 xsec_token。
命令:xhs-mcp like 参数: 参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌--unlikeflag❌取消点赞(默认 false 为点赞)--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN xhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN --unlike
命令:xhs-mcp favorite 参数: 参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌--unfavoriteflag❌取消收藏(默认 false 为收藏)--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN xhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN --unfavorite
命令:xhs-mcp comment 参数: 参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌-c/--contentstring✅评论内容--headless/--no-headlessflag❌是否无头模式(默认 headless) 示例: xhs-mcp comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c "评论内容"
命令:xhs-mcp reply-comment 参数: 参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌-c/--contentstring✅回复内容--comment-idstring❌目标评论 ID--user-idstring❌目标用户 ID--headless/--no-headlessflag❌是否无头模式(默认 headless) --comment-id 和 --user-id 至少需要提供一个。 示例: xhs-mcp reply-comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c "回复内容" --comment-id COMMENT_ID
命令:xhs-mcp logout 会删除本地 cookies。
如果你的运行环境支持 MCP(例如 Claude Desktop / Cursor),可以启动 MCP: xhs-mcp serve
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.