小红书 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
命令速查
| 命令 | 说明 |
|---|---|
node xhs.js status | 检查登录状态 |
node xhs.js login | 登录（弹出浏览器） |
node xhs.js search <关键词> [数量] | 搜索笔记 |
node xhs.js detail <笔记URL> | 获取帖子详情和评论 |
node xhs.js publish | 交互式发布图文笔记 |
node xhs.js track <关键词> [数量] | 生成话题热点报告 |
使用示例
$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
数据存储
| 路径 | 说明 |
|---|---|
%USERPROFILE%\.xiaohongshu-win\cookies.json | 登录 Cookie |
%USERPROFILE%\.xiaohongshu-win\browser-profile\ | Chromium 持久化 Profile |
%USERPROFILE%\.xiaohongshu-win\browsers\ | Playwright Chromium 二进制 |
%USERPROFILE%\.xiaohongshu-win\search_*.json | 搜索结果缓存 |
%USERPROFILE%\.xiaohongshu-win\report_*.md | 话题报告 |
注意事项
- Cookie 有效期约 30 天，过期后重新
node xhs.js login - 发布限制：标题 ≤ 20 字，正文 ≤ 1000 字
- 所有操作通过真实 Chromium 浏览器执行，行为与人工一致
- Node.js 路径不能含中文，脚本需在 workspace 目录运行