xiaohongshu-skill

pip install redbook-cli
xhs init                    # 引导：环境检查 → 代理 → 启动 MCP → 扫码登录（一次即可）

git clone https://github.com/Youhai020616/xiaohongshu.git
cd xiaohongshu && bash setup.sh

docker compose up -d && docker compose exec cli xhs login

xhs init                                 # 首次引导设置
xhs search "美食"                         # 搜索 → 结果自动缓存
xhs read 1                               # 查看第 1 条（短索引）
xhs like 1                               # 点赞第 1 条
xhs fav 2                                # 收藏第 2 条
xhs comment 1 -c "好文!"                  # 评论第 1 条
xhs publish -t "标题" -c "内容" -i img.jpg  # 发布图文

xhs search "关键词"                        # 基础搜索
xhs search "旅行" --sort 最多点赞          # 按点赞排序
xhs search "穿搭" --type 图文             # 按类型筛选
xhs search "AI" -o results.csv           # 导出 CSV
xhs search "咖啡" --engine cdp            # CDP 引擎（额外返回推荐词）
xhs read 1                               # 按短索引查看
xhs detail 1 --comments                  # 同时加载评论
xhs detail FEED_ID -t TOKEN              # 按 ID + xsec_token 查看
xhs feeds                                # 首页推荐

xhs publish -t "标题" -c "正文" -i photo.jpg                       # 图文
xhs publish -t "标题" -c "正文" -v video.mp4                       # 视频
xhs publish -t "标题" -c "正文" -i img.jpg --tags 旅行 --tags 美食  # 带标签
xhs publish -t "测试" -c "内容" -i img.jpg --visibility 仅自己可见   # 私密
xhs publish -t "标题" -c "正文" -i img.jpg --schedule "2026-05-01T10:00:00+08:00"  # 定时
xhs pub -t "标题" -c "正文" -i img.jpg --dry-run                    # 仅预览

xhs like 1                               # 点赞（短索引）
xhs like FEED_ID -t TOKEN --unlike       # 取消点赞
xhs fav 1                                # 收藏
xhs comment 1 -c "写得好!"               # 评论
xhs reply 1 --comment-id X --user-id Y -c "回复"  # 回复评论

xhs analytics                            # 创作者数据看板（CDP）
xhs analytics --csv data.csv             # 导出 CSV
xhs notifications                        # 提及 / 互动通知（CDP）
xhs me                                   # 我的信息
xhs profile USER_ID -t TOKEN             # 用户主页

xhs login                                # MCP 扫码登录（自动启动 MCP 服务）
xhs login --cdp                          # CDP 浏览器登录
xhs status                               # 两个引擎的登录状态
xhs server start                         # 启动 MCP 服务（二进制，自动安装）
xhs server start --docker                # 以 Docker 启动 MCP 服务
xhs server status | stop | log           # 管理 MCP 服务
xhs account list                         # 列出账号
xhs config show                          # 查看配置
xhs config set mcp.proxy http://...      # 设置代理

xhs status --json-output | jq '.data.authenticated'
xhs search "AI" --json-output | jq '.data'
xhs like 1 --json-output               # 变更类命令也返回结构化结果

{ "ok": true,  "schema_version": "1", "data": ... }
{ "ok": false, "schema_version": "1", "error": { "code": "mcp_error", "message": "..." } }

pip install 'redbook-cli[api]'
xhs api start --port 8080              # Swagger 文档: http://127.0.0.1:8080/docs

docker compose up -d                                  # 构建并启动（MCP :18060，CDP :9222）
docker compose exec cli xhs login                     # 扫码登录
docker compose exec cli xhs search "美食"
docker compose exec cli xhs publish -t "标题" -c "正文" -i /app/data/images/photo.jpg
docker compose logs -f                                # 日志
docker compose down                                   # 停止

{
  "mcp":     { "host": "127.0.0.1", "port": 18060, "proxy": "", "auto_start": true },
  "cdp":     { "host": "127.0.0.1", "port": 9222,  "headless": false },
  "default": { "account": "default", "engine": "auto", "output": "table" }
}

xhs config set mcp.proxy http://127.0.0.1:7897   # MCP 代理
xhs config set default.engine cdp                # 强制引擎：auto | mcp | cdp
xhs config set cdp.headless true                 # CDP 使用无头 Chrome
xhs config get mcp.port
xhs config reset

flowchart LR
    CLI[xhs 命令] --> MCP[MCP 服务<br/>Go · :18060]
    CLI --> CDP[CDP 脚本<br/>Chrome · :9222]
    MCP -->|搜索 / 发布 / 互动| XHS[xiaohongshu.com]
    CDP -->|数据看板 / 通知| XHS
    MCP -.->|不可用时回退| CDP
    API[xhs api · FastAPI] --> CLI

git clone https://github.com/Youhai020616/xiaohongshu.git && cd xiaohongshu
python3 -m venv .venv && source .venv/bin/activate
pip install -e . && pip install pytest ruff
ruff check src/ tests/
pytest tests/ -v