小红书采集 Skill

按关键词搜索小红书笔记，批量采集结构化数据。

前置检查

1. WebBridge 状态

   ~/.kimi-webbridge/bin/kimi-webbridge status
   

   必须 running: true 且 extension_connected: true。

2. 浏览器已登录小红书

   • 在 Chrome/Edge 访问 https://www.xiaohongshu.com 并登录

3. 项目依赖

   cd /Users/mao/vibe/zion-xhs-catch-skill && npm install
   

执行采集

cd /Users/mao/vibe/zion-xhs-catch-skill

# 基础用法
npx ts-node webbridge-crawl.ts --keyword="关键词" --limit=20

# 不采评论
npx ts-node webbridge-crawl.ts --keyword="关键词" --limit=20 --no-comments

# 限制评论数
npx ts-node webbridge-crawl.ts --keyword="关键词" --limit=20 --max-comments=10

输出

• output/关键词_YYYYMMDD.md — Markdown 格式采集结果
• output/index.html — 可视化报告（可选）

数据结构

interface XHSNote {
  xhs_note_id: string;
  title: string;
  content: string;
  author_name: string;
  images: string[];
  likes: number;
  collects: number;
  comments_count: number;
  comments: { author: string; content: string; likes: number }[];
  comments_extracted: number;
  keyword: string;
  source_url: string;
  crawl_time: string;
}

故障处理

• WebBridge 未运行：~/.kimi-webbridge/bin/kimi-webbridge start
• 数据为空：检查浏览器登录状态，或减少 limit
• 弹窗未弹出：笔记未加载完，增大 limit 让预加载更充分