- name
- xiaohongshu-aio
- description
- |
- metadata
小红书All in One技能
功能概述
本技能提供完整的小红书账号管理和内容操作功能，基于小红书 MCP 服务器 API。
主要功能
- 账号管理：添加、删除、列出、切换账号
- 登录管理：检查登录状态、获取登录二维码、登出
- 内容发布：发布图文和视频内容
- Feed 管理：列出推荐内容、搜索、获取详情
- 互动操作：点赞、收藏、发表评论
- 用户信息：获取当前用户和其他用户资料
安装
安装技能
方案1：从源代码安装
- 克隆本仓库到本地
- 进入项目目录
- 安装依赖
cd xiaohongshu-aio
uv sync
uv run xhs --help方案2：从 PyPI 安装(推荐)
- 执行：
uv tool install xiaohongshu-aio
安装启动 MCP 服务器
- 执行：
xhs mcp download下载 MCP 服务器 - 执行：
xhs mcp start启动 MCP 服务器 - 执行：
xhs mcp status检查 MCP 服务器状态
执行流程
执行任何操作前，都需要先检查 MCP 服务器是否运行：
xhs mcp status1. 账号管理流程
添加账号
- 执行：
xhs login status确保 MCP 服务器已登录 - 执行：
xhs account add（自动检测用户名） - 或执行：
xhs account add --username 账号名称 --notes "备注" - 系统会自动将当前 cookies 保存为指定账号
切换账号
- 执行：
xhs account switch --username 账号名称 - 系统会将指定账号的 cookies 写入 MCP 服务器的 cookies.json
- 执行：
xhs login status确认切换成功
查看账号
- 查看所有账号：
xhs account list - 查看当前账号：
xhs account current
2. 登录管理流程
检查登录状态
- 执行：
xhs login status - 系统返回当前登录状态和用户名
扫码登录
- 执行：
xhs login qrcode - 系统返回登录二维码（Base64 格式）
- 用户使用小红书 App 扫描二维码
- 扫描后执行：
xhs login status确认登录成功
登出
- 执行：
xhs login logout - 系统会清除当前登录状态
3. 内容发布流程
发布图文内容
- 执行：
xhs publish "标题" "内容" "图片URL1" "图片URL2" --tags 标签1 标签2发布视频内容
- 执行：
xhs publish "视频标题" "视频内容" "视频文件路径" --is-video4. 笔记管理流程
搜索笔记
- 执行：
xhs feed search --keyword "关键词" - 系统返回相关内容列表
获取笔记详情
- 从搜索结果中获取 feed_id 和 xsec_token
- 执行：
xhs feed detail --feed-id "feed_id" --xsec-token "token"5. 互动操作流程
点赞笔记
- 执行：
xhs interact like "feed_id" "token"
发表笔记评论
- 执行：
xhs interact comment "feed_id" "token" --content "评论内容"命令参考
账号管理
xhs account list- 列出所有账号xhs account add [--username 用户名] [--notes 备注]- 添加账号xhs account remove --username 用户名- 删除账号xhs account switch --username 用户名- 切换账号xhs account import [--username 用户名]- 导入 cookiesxhs account current- 获取当前账号
登录管理
xhs login status [--base-url URL]- 检查登录状态xhs login qrcode [--base-url URL]- 获取登录二维码xhs login logout [--base-url URL]- 登出
内容发布
xhs publish 标题 内容 媒体文件... [--tags 标签...] [--is-video] [--base-url URL]- 发布笔记或视频内容
笔记管理
xhs feed list [--base-url URL]- 列出推荐笔记xhs feed search --keyword 关键词 [--base-url URL]- 搜索笔记xhs feed detail --feed-id ID --xsec-token 令牌 [--base-url URL]- 获取笔记详情
互动操作
xhs interact like feed_id 令牌 [--unlike] [--base-url URL]- 点赞/取消点赞xhs interact favorite feed_id 令牌 [--unfavorite] [--base-url URL]- 收藏/取消收藏xhs interact comment feed_id 令牌 --content 内容 [--base-url URL]- 发表评论
用户信息
xhs user me [--base-url URL]- 获取当前用户资料xhs user profile --user-id ID --xsec-token 令牌 [--base-url URL]- 获取其他用户资料
MCP 服务器管理
xhs mcp download- 下载 MCP 服务器xhs mcp test- 检查 MCP 服务器是否运行xhs mcp start- 启动 MCP 服务器xhs mcp stop- 停止 MCP 服务器xhs mcp status- 检查 MCP 服务器状态xhs mcp restart- 重启 MCP 服务器
其他命令
xhs --help- 显示帮助信息- 具体的命令参考可以使用
xhs 命令名['user', 'feed', 'interact', 'mcp'] --help查看详细帮助
配置
环境变量
XHS_MCP_BASE_URL- MCP 服务器地址（优先）XHS_BASE_URL- MCP 服务器地址（备用）XHS_TIMEOUT- HTTP 请求超时时间XHS_VERIFY_SSL- 是否验证 SSL 证书
配置文件
- 账号信息存储在
user_cookies.json - cookies 存储在 MCP 服务器目录的
cookies.json
注意事项
- 账号安全：请妥善保管
user_cookies.json文件 - 频率限制：避免过于频繁的操作，遵守平台规则
- 服务器依赖：本技能依赖运行中的小红书 MCP 服务器
- 网络连接：发布视频时需要稳定的网络连接
- 错误处理：遇到错误时检查 MCP 服务器状态
故障排除
常见问题
| 问题 | 解决方案 |
|---|---|
| 无法连接服务器 | 检查 MCP 服务器是否运行，地址是否正确、重启 MCP 服务器 |
| 登录失败 | 确保二维码扫描及时，检查账号状态 |
| 发布失败 | 检查内容是否符合平台规范，文件是否可访问 |
| 账号切换失败 | 检查账号是否存在，重启 MCP 服务器 |
失败时重启 MCP 服务器：
xhs mcp restart依赖
- Python 3.12+
- 运行中的小红书 MCP 服务器
- 依赖包：httpx, typer, pydantic, rich
完整发布流程
- 检查登录状态
xhs login status- 如未登录，获取二维码
xhs login qrcode- 扫码登录后确认
xhs login status- 添加账号
xhs account add- 发布内容
xhs publish "我的第一篇笔记" "这是内容" "https://example.com/image.jpg" --tags 测试 小红书- 搜索相关内容
xhs feed search --keyword "咖啡"