{"skill":{"slug":"xhs-monitor","displayName":"小红书竞品监控助手","summary":"小红书竞品监控 - 自动采集竞品笔记，推送飞书通知，写入数据看板","description":"---\nname: xhs-monitor\ndescription: 小红书竞品监控 - 自动采集竞品笔记，推送飞书通知，写入数据看板\nhomepage: https://github.com/openclaw/xhs-monitor\nmetadata:\n  {\n    \"openclaw\": {\n      \"emoji\": \"📕\",\n      \"requires\": {\n        \"bins\": [\"node\"],\n        \"env\": [\"PATH\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"puppeteer\",\n          \"kind\": \"npm\",\n          \"module\": \"puppeteer-core\",\n          \"label\": \"安装 puppeteer-core\"\n        }\n      ]\n    }\n  }\n---\n\n# 小红书竞品监控系统 (xhs-monitor)\n\n自动采集小红书竞品账号的笔记，解析有价值内容，推送到飞书。\n\n## 功能\n\n- ✅ 自动采集多个竞品账号的笔记\n- ✅ 本地去重（避免重复推送）\n- ✅ 智能解析（提取标题、正文、商品、直播时间）\n- ✅ 飞书卡片推送\n- ✅ 定时自动运行（14:06 / 18:06 / 21:06）\n- ✅ 支持手动触发\n\n## 安装\n\n### 方式一：使用 ClawHub 安装（推荐）\n\n```bash\n# 安装 Skill\nnpx clawhub@latest install xhs-monitor\n\n# 或使用 clawhub CLI\nclawhub install xhs-monitor\n```\n\n### 方式二：手动安装\n\n```bash\n# 克隆项目\ngit clone https://github.com/你的用户名/xhs-monitor.git\ncd xhs-monitor\n\n# 安装依赖\nnpm install puppeteer-core\n```\n\n### 3. 配置\n\n```bash\n# 复制配置模板\ncp config.example.js config.js\ncp notify.example.js notify.js\n```\n\n### 4. 配置账号\n\n编辑 `config.js`：\n\n```javascript\n// 竞品账号列表（必填）\n// 从小红书用户主页URL获取：xiaohongshu.com/user/profile/用户ID\nconst ACCOUNTS = [\n  { name: '账号名1', id: '用户ID1' },\n  { name: '账号名2', id: '用户ID2' },\n];\n\n// 账号主页URL映射（用于跳转链接）\nconst ACCOUNT_URLS = {\n  '账号名1': 'https://www.xiaohongshu.com/user/profile/用户ID1',\n  '账号名2': 'https://www.xiaohongshu.com/user/profile/用户ID2',\n};\n```\n\n### 5. 启动浏览器（调试模式）\n\n首次需要手动启动浏览器并扫码登录：\n\n```bash\n# Mac\nexport CHROMIUM_PATH=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\n\"$CHROMIUM_PATH\" \\\n  --remote-debugging-port=9223 \\\n  --user-data-dir=\"$HOME/xhs-monitor/data/browser\" \\\n  \"https://www.xiaohongshu.com/\"\n\n# 或使用 run.sh（自动检测）\nbash run.sh\n```\n\n扫码登录后，浏览器保持打开状态即可。\n\n### 6. 运行\n\n```bash\ncd xhs-monitor/src\nnode main.js\n```\n\n## 配置说明\n\n### config.js\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| ACCOUNTS | 监控的账号列表 | `{ name: '账号名', id: '用户ID' }` |\n| ACCOUNT_URLS | 账号主页URL映射 | 用于跳转链接 |\n\n### notify.js（可选）\n\n如需使用飞书通知，需要：\n1. 配置飞书应用权限：`im:message.send_as_user`\n2. 如需写入多维表格，配置 BITABLE_CONFIG\n\n## 项目结构\n\n```\nxhs-monitor/\n├── src/\n│   ├── main.js         # 主程序入口\n│   ├── config.js      # 账号配置 ⚠️ 需复制 config.example.js\n│   ├── config.example.js  # 配置模板\n│   ├── notify.js      # 飞书推送 ⚠️ 需复制 notify.example.js\n│   ├── notify.example.js  # 推送模板\n│   ├── parser.js      # 内容解析\n│   ├── dedupe.js      # 去重模块\n│   └── scraper.js     # 浏览器采集\n├── data/\n│   └── history.csv    # 历史记录（自动生成）\n└── README.md\n```\n\n## 使用方式\n\n### 手动运行\n\n```bash\nnode src/main.js\n```\n\n### 定时任务（Mac）\n\n编辑 crontab：\n\n```bash\ncrontab -e\n\n# 添加以下行：\n6 14 * * * /usr/bin/node /path/to/xhs-monitor/src/main.js\n6 18 * * * /usr/bin/node /path/to/xhs-monitor/src/main.js\n6 21 * * * /usr/bin/node /path/to/xhs-monitor/src/main.js\n```\n\n## 常见问题\n\n### Q: 浏览器需要一直开着吗？\nA: 是的，首次登录后保持浏览器打开，程序会复用会话。\n\n### Q: 为什么抓不到内容？\nA: 检查浏览器是否以调试模式运行（--remote-debugging-port=9222）。\n\n### Q: 如何添加新账号？\nA: 编辑 config.js 中的 ACCOUNTS 数组。\n\n## 待优化\n\n- [ ] 多维表格自动写入\n- [ ] LLM智能解析\n- [ ] 笔记详情链接获取\n- [ ] 登录状态自动检测\n","topics":["小红书","笔记","飞书"],"tags":{"feishu":"1.0.1","latest":"1.0.1","monitoring":"1.0.1","social-media":"1.0.1","xiaohongshu":"1.0.1","automation":"1.0.0"},"stats":{"comments":0,"downloads":746,"installsAllTime":28,"installsCurrent":1,"stars":1,"versions":2},"createdAt":1773318317965,"updatedAt":1779078110218},"latestVersion":{"version":"1.0.1","createdAt":1773318609507,"changelog":"- 文档新增了 ClawHub 一键安装方式，提升安装便捷性\n- 安装、配置流程更清晰，分步说明优化\n- 其余核心功能与用法保持不变","license":"MIT-0"},"metadata":{"setup":[{"key":"PATH","required":true}],"os":null,"systems":null},"owner":{"handle":"cstdr","userId":"s1741wajvssx0m2550d896z63n876xgq","displayName":"Roy","image":"https://avatars.githubusercontent.com/u/2403716?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089857854}}