小红书 Windows 原生 Skill

技术栈：Node.js + Playwright（Chromium）
纯 Windows 原生，无跨平台依赖。

🆕 v1.1.0 新功能

• 定时任务 - 支持 Cron 定时自动搜索热点
• 即梦AI集成 - 可直接生成封面图片
• Browser Relay - 支持复用本地 Chrome 浏览器

架构

xhs.js          ← 命令行入口（所有命令）
xhs-core.js     ← 核心库（登录/搜索/发布/详情）
  └── Playwright → 控制本地 Chromium（Windows 原生）
        └── 小红书 Web（www.xiaohongshu.com）
              └── 拦截 API 响应（snake_case JSON）

数据存储： %USERPROFILE%\.xiaohongshu-win\
浏览器路径： %USERPROFILE%\.xiaohongshu-win\browsers\（需设置 PLAYWRIGHT_BROWSERS_PATH）

⚠️ 重要：运行路径限制

由于 Node.js 不支持含中文的路径，所有命令必须从无中文路径运行。
推荐工作目录：C:\Users\<用户名>\.qclaw\workspace\

脚本文件已同步到 workspace，直接在那里运行：

$env:PLAYWRIGHT_BROWSERS_PATH = "$env:USERPROFILE\.xiaohongshu-win\browsers"
Set-Location "C:\Users\mll-c\.qclaw\workspace"
node xhs.js <命令>

首次使用

# 1. 安装依赖（只需一次，在 workspace 目录）
Set-Location "C:\Users\mll-c\.qclaw\workspace"
npm install --save playwright

# 2. 安装 Chromium（只需一次，约 150MB）
$env:PLAYWRIGHT_BROWSERS_PATH = "$env:USERPROFILE\.xiaohongshu-win\browsers"
npx playwright install chromium

# 3. 登录（弹出浏览器扫码）
node xhs.js login

# 4. 验证
node xhs.js status

详细说明见 references/setup.md

命令速查

使用示例

$env:PLAYWRIGHT_BROWSERS_PATH = "$env:USERPROFILE\.xiaohongshu-win\browsers"
cd "C:\Users\mll-c\.qclaw\workspace"

# 搜索 qclaw 相关内容
node xhs.js search qclaw 20

# 生成话题报告
node xhs.js track qclaw 10

# 获取帖子详情
node xhs.js detail https://www.xiaohongshu.com/explore/69aee455000000001b016268

# 发布笔记
node xhs.js publish

数据存储

注意事项

• Cookie 有效期约 30 天，过期后重新 node xhs.js login
• 发布限制：标题 ≤ 20 字，正文 ≤ 1000 字
• 所有操作通过真实 Chromium 浏览器执行，行为与人工一致
• Node.js 路径不能含中文，脚本需在 workspace 目录运行