xhs-login
xhs-login handles Xiaohongshu account access by checking login status, generating QR codes for mobile app authentication, and resetting sessions to switch accounts. The skill guides users through each step and handles timeouts by regenerating codes when needed.
xhs-login manages Xiaohongshu authentication through QR code scanning, status checks, and account switching.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-03-05
xhs-login manages Xiaohongshu authentication through QR code scanning, status checks, and account switching. xhs-login handles Xiaohongshu account access by checking login status, generating QR codes for mobile app authentication, and resetting sessions to switch accounts. The skill guides users through each step and handles timeouts by regenerating codes when needed.
Use it when
- xhs-login provides account status checking by verifying your current authentication state and displaying your account information.
- xhs-login supports account switching by resetting your login session and re-authenticating with a different account.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
autoclaw-cc/xiaohongshu-mcp-skills/xhs-login
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to login xiaohongshu using xhs-login?
xhs-login enables Xiaohongshu account access by generating a QR code for mobile app authentication. Launch the skill, scan the displayed QR code with your Xiaohongshu mobile app, and follow the on-screen prompts to complete login. The skill handles the authentication handshake and confirms when your session is active.
How do I check my login status in xhs-login?
xhs-login provides account status checking by verifying your current authentication state and displaying your account information. Use the status-check feature to confirm whether you're logged in, view your profile details, and see session validity. This helps you verify active sessions before performing account operations.
小红书切换账号 with xhs-login?
xhs-login supports account switching by resetting your login session and re-authenticating with a different account. The skill clears your current session state, generates a fresh QR code, and guides you through logging in with your alternate Xiaohongshu credentials on the mobile app.
What happens if my xhs-login QR code expires?
xhs-login automatically handles QR code timeouts by detecting expiration and regenerating a new code. If your scan attempt times out or the code becomes invalid, the skill prompts you to scan the newly generated QR code. This ensures continuous authentication without manual intervention.
Can xhs-login reset my login state?
xhs-login includes session reset functionality to clear your current authentication and prepare for re-authentication. This feature is useful when switching accounts or troubleshooting login issues. After reset, the skill generates a fresh QR code for you to scan and establish a new session.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
执行流程
1. 检查登录状态
调用 check_login_status（无参数），返回是否已登录及用户名。
- 已登录 → 告知用户当前登录账号
- 未登录 → 进入步骤 2
2. 扫码登录
调用 get_login_qrcode（无参数）。MCP 工具返回两部分内容：
- 文本：超时提示（含截止时间）
- 图片：PNG 格式二维码（MCP image content type，Base64 编码）
展示二维码：MCP 返回的图片会通过客户端渲染给用户。如果客户端无法直接展示图片（如纯文本终端），则将 Base64 数据保存为临时 PNG 文件，告知用户文件路径让其手动打开：
# 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. 重新登录 / 切换账号
当用户要求重新登录或切换账号时：
- 调用
delete_cookies（⚠️ 需用户确认）— 清除当前登录状态 - 调用
get_login_qrcode— 获取新二维码 - 引导用户扫码
约束
delete_cookies会清除登录状态，执行前必须确认- 登录需要用户手动用手机 App 扫码，无法自动完成
失败处理
| 场景 | 处理 |
|---|---|
| MCP 工具不可用 | 引导用户使用 /setup-xhs-mcp 完成部署和连接配置 |
| 二维码超时 | 重新调用 get_login_qrcode |
File tree — 1 file
skills/xhs-login/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Log into Xiaohongshu using QR code scan”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Post-to-xhs automates publishing to Xiaohongshu by handling both image and video notes. The skill collects your title, content, and media, validates against platform constraints, shows a preview for confirmation, then publishes directly.
This skill walks you through installing and configuring the xiaohongshu-mcp service, from initial deployment to verifying MCP connectivity. It supports Docker Compose (recommended), binary downloads, and source compilation, with built-in guidance for macOS, Linux, and Windows. After setup, it helps you register the MCP endpoint with Claude Code, Cursor, or other compatible clients.
xhs-search enables keyword-based discovery across Xiaohongshu's note library with flexible filtering by sort order, content format, publish date, and geographic scope. Results display engagement metrics and author details, with direct access to note exploration and interaction features.
xhs-explore lets you browse Xiaohongshu's recommendation feed and access individual note details with full comment threads. Retrieve recommended notes from your home feed, then drill into specific posts to see content, images, author info, and engagement metrics.
xhs-profile fetches a Xiaohongshu user's profile page, including basic details, follower and engagement metrics, and their recent published posts. Use it to explore any creator's account information and content history.
xhs-interact lets you automate engagement on Xiaohongshu notes—liking, favoriting, posting comments, and replying to existing ones. The skill routes your intent to the right action, handles confirmation for comments and replies (which can't be undone), and executes reversible operations like likes and favorites directly.
More skills xhs-content-plan (MIT) · Openclaw Xhs (NOASSERTION) · Xiaohongshu Mcp Skill (unlicensed)