小红书 MCP 客户端技能

功能概述

本技能提供完整的小红书账号管理和内容操作功能，基于小红书 MCP 服务器 API。

主要功能

• 账号管理：添加、删除、列出、切换账号
• 登录管理：检查登录状态、获取登录二维码、登出
• 内容发布：发布图文和视频内容
• Feed 管理：列出推荐内容、搜索、获取详情
• 互动操作：点赞、收藏、发表评论
• 用户信息：获取当前用户和其他用户资料

安装

cd xiaohongshu-aio
pip install -e .

执行流程

执行任何操作前，都需要先检查 MCP 服务器是否运行：

chmod +x check-service.sh
./check-service.sh

1. 账号管理流程

添加账号

1. 执行：xhs login status确保 MCP 服务器已登录
2. 执行：xhs account add（自动检测用户名）
3. 或执行：xhs account add --username 账号名称 --notes "备注"
4. 系统会自动将当前 cookies 保存为指定账号

切换账号

1. 执行：xhs account switch --username 账号名称
2. 系统会将指定账号的 cookies 写入 MCP 服务器的 cookies.json
3. 执行：xhs login status 确认切换成功

查看账号

• 查看所有账号：xhs account list
• 查看当前账号：xhs account current

2. 登录管理流程

检查登录状态

1. 执行：xhs login status
2. 系统返回当前登录状态和用户名

扫码登录

1. 执行：xhs login qrcode
2. 系统返回登录二维码（Base64 格式）
3. 用户使用小红书 App 扫描二维码
4. 扫描后执行：xhs login status 确认登录成功

登出

1. 执行：xhs login logout
2. 系统会清除当前登录状态

3. 内容发布流程

发布图文内容

1. 执行：
   bash

   xhs publish "标题" "内容" "图片URL1" "图片URL2" --tags 标签1 标签2
   

发布视频内容

1. 执行：
   bash

   xhs publish "视频标题" "视频内容" "视频文件路径" --is-video
   

4. Feed 管理流程

搜索内容

1. 执行：xhs feed search --keyword "关键词"
2. 系统返回相关内容列表

获取内容详情

1. 从搜索结果中获取 feed_id 和 xsec_token
2. 执行：
   bash

   xhs feed detail --feed-id "feed_id" --xsec-token "token"
   

5. 互动操作流程

点赞内容

1. 执行：xhs interact like "feed_id" "token"

发表评论

1. 执行：
   bash

   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 用户名] - 导入 cookies
• xhs 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] - 发布内容

Feed 管理

• 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] - 获取其他用户资料

配置

环境变量

• XHS_MCP_BASE_URL - MCP 服务器地址（优先）
• XHS_BASE_URL - MCP 服务器地址（备用）
• XHS_TIMEOUT - HTTP 请求超时时间
• XHS_VERIFY_SSL - 是否验证 SSL 证书

配置文件

• 账号信息存储在 user_cookies.json
• cookies 存储在 MCP 服务器目录的 cookies.json

注意事项

1. 账号安全：请妥善保管 user_cookies.json 文件
2. 频率限制：避免过于频繁的操作，遵守平台规则
3. 服务器依赖：本技能依赖运行中的小红书 MCP 服务器
4. 网络连接：发布视频时需要稳定的网络连接
5. 错误处理：遇到错误时检查 MCP 服务器状态

故障排除

常见问题

失败时重启 MCP 服务器：

chmod +x strart-service.sh
./strart-service.sh

依赖

• Python 3.12+
• 运行中的小红书 MCP 服务器
• 依赖包：httpx, typer, pydantic, rich

示例工作流

完整发布流程

1. 检查登录状态

   bash

   xhs login status
   

2. 如未登录，获取二维码

   bash

   xhs login qrcode
   

3. 扫码登录后确认

   bash

   xhs login status
   

4. 添加账号

   bash

   xhs account add
   

5. 发布内容

   bash

   xhs publish "我的第一篇笔记" "这是内容" "https://example.com/image.jpg" --tags 测试 小红书
   

6. 搜索相关内容

   bash

   xhs feed search --keyword "咖啡"
   

7. 点赞内容

   bash

   xhs interact like "feed_id" "token"