运行时依赖
安装命令
点击复制技能文档
小红书All in One技能 功能概述
本技能提供完整的小红书账号管理和内容操作功能,基于小红书 MCP 服务器 API。
主要功能 账号管理:添加、删除、列出、切换账号 登录管理:检查登录状态、获取登录二维码、登出 内容发布:发布图文和视频内容 Feed 管理:列出推荐内容、搜索、获取详情 互动操作:点赞、收藏、发表评论 用户信息:获取当前用户和其他用户资料 安装 安装技能 方案1:从源代码安装 克隆本仓库到本地 进入项目目录 安装依赖 cd xiaohongshu-AIo uv 同步 uv 运行 xhs --help
方案2:从 PyPI 安装(推荐) 执行:uv 工具 安装 xiaohongshu-AIo 安装启动 MCP 服务器 执行:xhs mcp 下载 下载 MCP 服务器 执行:xhs mcp 启动 启动 MCP 服务器 执行:xhs mcp 状态 检查 MCP 服务器状态 执行流程
执行任何操作前,都需要先检查 MCP 服务器是否运行:
xhs mcp 状态
- 账号管理流程
- 登录管理流程
- 内容发布流程
发布视频内容 执行: xhs publish "视频标题" "视频内容" "视频文件路径" --is-video
- 笔记管理流程
- 互动操作流程
命令参考 账号管理 xhs account 列出 - 列出所有账号 xhs account 添加 [--username 用户名] [--notes 备注] - 添加账号 xhs account 移除 --username 用户名 - 删除账号 xhs account switch --username 用户名 - 切换账号 xhs account 导入 [--username 用户名] - 导入 cookies xhs account current - 获取当前账号 登录管理 xhs 记录in 状态 [--base-url URL] - 检查登录状态 xhs 记录in qrcode [--base-url URL] - 获取登录二维码 xhs 记录in 记录out [--base-url URL] - 登出 内容发布 xhs publish 标题 内容 媒体文件... [--tags 标签...] [--is-video] [--base-url URL] - 发布笔记或视频内容 笔记管理 xhs feed 列出 [--base-url URL] - 列出推荐笔记 xhs feed 搜索 --keyword 关键词 [--base-url URL] - 搜索笔记 xhs feed detAIl --feed-id ID --xsec-令牌 令牌 [--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 性能分析 --user-id ID --xsec-令牌 令牌 [--base-url URL] - 获取其他用户资料 MCP 服务器管理 xhs mcp 下载 - 下载 MCP 服务器 xhs mcp test - 检查 MCP 服务器是否运行 xhs mcp 启动 - 启动 MCP 服务器 xhs mcp 停止 - 停止 MCP 服务器 xhs mcp 状态 - 检查 MCP 服务器状态 xhs mcp re启动 - 重启 MCP 服务器 其他命令 xhs --help - 显示帮助信息 具体的命令参考可以使用 xhs 命令名['user', 'feed', 'interact', 'mcp'] --help 查看详细帮助 配置 环境变量 XHS_MCP_BASE_URL - MCP 服务器地址(优先) XHS_BASE_URL - MCP 服务器地址(备用) XHS_TIMEOUT - HTTP 请求超时时间 XHS_验证_SSL - 是否验证 SSL 证书 配置文件 账号信息存储在 user_cookies.json cookies 存储在 MCP 服务器目录的 cookies.json 注意事项 账号安全:请妥善保管 user_cookies.json 文件 频率限制:避免过于频繁的操作,遵守平台规则 服务器依赖:本技能依赖运行中的小红书 MCP 服务器 网络连接:发布视频时需要稳定的网络连接 错误处理:遇到错误时检查 MCP 服务器状态 故障排除 常见问题 问题 解决方案 无法连接服务器 检查 MCP 服务器是否运行,地址是否正确、重启 MCP 服务器 登录失败 确保二维码扫描及时,检查账号状态 发布失败 检查内容是否符合平台规范,文件是否可访问 账号切换失败 检查账号是否存在,重启 MCP 服务器
失败时重启 MCP 服务器:
xhs mcp re启动
依赖 Python 3.12+ 运行中的小红书 MCP 服务器 依赖包:httpx, typer, pydantic, rich 完整发布流程
检查登录状态
xhs 记录in 状态
如未登录,获取二维码
xhs 记录in qrcode
扫码登录后确认
xhs 记录in 状态
添加账号
xhs account 添加
发布内容
xhs publish "我的第一篇笔记" "这是内容" "https://example.com/image.jpg" --tags 测试 小红书
搜索相关内容
xhs feed 搜索 --keyword "咖啡"