Agent skill

xhs-login

管理小红书登录状态:检查是否已登录、二维码扫码登录、重置登录切换账号。 当用户提到登录、扫码、账号、切换账号、退出登录、登录状态检查,或其他 skill 报告"未登录"需要先登录时使用。

Stars 182
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/xhs-login

SKILL.md

执行流程

1. 检查登录状态

调用 check_login_status(无参数),返回是否已登录及用户名。

  • 已登录 → 告知用户当前登录账号
  • 未登录 → 进入步骤 2

2. 扫码登录

调用 get_login_qrcode(无参数)。MCP 工具返回两部分内容:

  • 文本:超时提示(含截止时间)
  • 图片:PNG 格式二维码(MCP image content type,Base64 编码)

展示二维码:MCP 返回的图片会通过客户端渲染给用户。如果客户端无法直接展示图片(如纯文本终端),则将 Base64 数据保存为临时 PNG 文件,告知用户文件路径让其手动打开:

bash
# fallback: 保存二维码到临时文件
echo "<base64_data>" | base64 -d > /tmp/xhs-qrcode.png
open /tmp/xhs-qrcode.png   # macOS
xdg-open /tmp/xhs-qrcode.png  # Linux

提示用户:

  • 打开小红书 App 扫描二维码
  • 二维码有效期有限,过期需重新获取

扫码完成后,调用 check_login_status 确认登录成功。

3. 重新登录 / 切换账号

当用户要求重新登录或切换账号时:

  1. 调用 delete_cookies(⚠️ 需用户确认)— 清除当前登录状态
  2. 调用 get_login_qrcode — 获取新二维码
  3. 引导用户扫码

约束

  • delete_cookies 会清除登录状态,执行前必须确认
  • 登录需要用户手动用手机 App 扫码,无法自动完成

失败处理

场景 处理
MCP 工具不可用 引导用户使用 /setup-xhs-mcp 完成部署和连接配置
二维码超时 重新调用 get_login_qrcode

Expand your agent's capabilities with these related and highly-rated skills.

autoclaw-cc/xiaohongshu-mcp-skills

xhs-search

搜索小红书笔记,支持关键词搜索和多维度筛选(排序、内容类型、时间范围、位置等)。 当用户想在小红书上搜索、查找内容时使用——包括搜笔记、找攻略、看看小红书上有没有某某内容、搜一下、查一查等场景。

182 31
Explore
autoclaw-cc/xiaohongshu-mcp-skills

xhs-explore

浏览小红书推荐流、查看笔记详情和评论。 当用户想看推荐内容、刷首页、查看某条笔记的详情/评论、或已有 feed_id 想获取完整内容时使用。

182 31
Explore
autoclaw-cc/xiaohongshu-mcp-skills

xhs-interact

对小红书笔记进行互动:点赞/取消点赞、收藏/取消收藏、发表评论、回复评论。 当用户想对小红书笔记进行互动时使用——赞一下、收藏一下、留个评论、回复某条评论、取消点赞、取消收藏等。

182 31
Explore
autoclaw-cc/xiaohongshu-mcp-skills

post-to-xhs

发布内容到小红书,支持图文笔记和视频笔记。自动判断发布类型,校验标题和素材,用户确认后发布。 当用户想在小红书发布内容时使用——包括发笔记、发图文、发视频、上传图片、写一篇小红书、把内容发到红书上、种草笔记、好物分享等,即使用户只说"帮我发一下"但上下文明确是小红书也应触发。

182 31
Explore
autoclaw-cc/xiaohongshu-mcp-skills

setup-xhs-mcp

安装部署 xiaohongshu-mcp 服务并配置 MCP 连接,引导用户完成从零到可用的全流程。 当用户第一次使用小红书功能、提到安装/部署/配置小红书、环境搭建、MCP 服务连接失败、或 check_login_status 等 MCP 工具不可用时使用。

182 31
Explore
autoclaw-cc/xiaohongshu-mcp-skills

xhs-content-plan

小红书内容策划助手:搜索分析热门内容和竞品,帮助规划内容方向、选题、标签策略。 当用户想做小红书运营规划时使用——内容策划、选题灵感、竞品分析、爆款分析、热门话题研究、怎么做小红书、涨粉策略等。

182 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results