Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
小红书内容发布与管理助手。当用户要求登录、发小红书、搜索小红书、评论点赞收藏等任何小红书相关操作时使用。
小红书内容发布与管理助手。当用户要求登录、发小红书、搜索小红书、评论点赞收藏等任何小红书相关操作时使用。
This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
首次使用需要确认环境中有 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.