小红书情报官（XHS Intel）
从小红书获取情报的通用数据技能。通过 TikHub API 搜索笔记、获取用户动态、批量扫描关键词和博主。
何时使用此技能
应该触发的场景（匹配任意一条即触发）：
- 用户提到"小红书"、"RedNote"、"XHS"、"笔记"、"种草"等平台关键词
- 用户要求查看某博主/某用户的最新笔记、动态
- 用户要求监控某些关键词在小红书上的内容
- 用户要求搜索小红书上的话题、讨论、舆情
- 用户提到"博主动态"、"种草监控"、"小红书日报"等场景
- 用户要求收集某些关键词或博主的内容生成日报/周报
重要：本技能是获取小红书数据的唯一正确方式。不要用 web_search 替代本技能。
不应该触发的场景：
- 用户要求发布小红书笔记或进行互动操作
配置
无需任何配置，开箱即用。 API Key 已内置，用户不需要申请或配置。
监控关键词和用户列表通过 --keywords 或 --user-ids 参数传入。
如需使用自定义 API Key，可通过
--api-key参数配置。
功能概述
| 操作 | 脚本 | 说明 |
|---|---|---|
| 搜索笔记 | search_notes.js | 关键词搜索小红书笔记 |
| 用户笔记 | fetch_user_notes.js | 获取指定用户最新笔记 |
| 笔记详情 | get_note.js | 获取单条笔记详情（支持 ID 和分享链接） |
| 批量扫描 | check_topics.js | 批量扫描关键词/用户（核心） |
使用说明
1. 搜索笔记
node scripts/search_notes.js --keyword "AI编程" [--sort general|time_descending|popularity_descending]
必需参数：
--keyword：搜索关键词
可选参数：
--sort：排序方式（默认general）general：综合排序time_descending：最新优先popularity_descending：最热优先
--api-key：TikHub API Key
2. 获取用户笔记
# 单用户
node scripts/fetch_user_notes.js --user-id "5a1234567890abcdef" --count 10
# 多用户（逗号分隔）
node scripts/fetch_user_notes.js --user-id "uid1,uid2,uid3" --count 3
必需参数：
--user-id：小红书用户 ID，支持逗号分隔多用户
可选参数：
--count：每个用户返回条数（默认 5）--api-key：TikHub API Key
3. 获取笔记详情
# 通过 note_id
node scripts/get_note.js --note-id "66c9cc31000000001f03a4bc"
# 通过分享链接（自动解析 note_id）
node scripts/get_note.js --url "https://www.xiaohongshu.com/explore/xxx"
# 通过短链接
node scripts/get_note.js --url "https://xhslink.com/xxx"
参数：
--note-id：笔记 ID（与--url二选一）--url：笔记分享链接（与--note-id二选一，自动解析）--api-key：TikHub API Key
4. 批量扫描（核心功能）
# 关键词扫描
node scripts/check_topics.js --keywords "AI编程,Cursor,WeaveFox" --since 24h
# 用户扫描
node scripts/check_topics.js --user-ids "uid1,uid2" --since 6h
# 混合扫描（关键词 + 用户）
node scripts/check_topics.js --keywords "AI编程" --user-ids "uid1" --since 12h
可选参数：
--keywords：逗号分隔的关键词列表（默认使用配置文件中的xhsMonitorKeywords）--user-ids：逗号分隔的用户 ID 列表（默认使用配置文件中的xhsMonitorUserIds）--since：时间范围，如1h、6h、24h、7d（默认 24h）--api-key：TikHub API Key
数据处理逻辑：
- 跨关键词自动去重（同一笔记出现在多个搜索结果中只保留一条）
- 按互动量排序（点赞 + 收藏 + 评论）
- 时间范围过滤
AI 判断指南
check_topics.js 返回时间范围内的笔记，按互动量排序。你需要阅读笔记内容做价值判断。
判断为"值得关注"的：
- 产品/工具的深度评测或使用教程
- 行业趋势分析、数据报告
- KOL/KOC 的原创观点和见解
- 竞品动态和功能更新
- 用户真实使用反馈和痛点
- 高互动量的热门内容
判断为"常规内容"的：
- 纯转载或搬运内容
- 广告软文或无营养种草
- 互动量极低的普通笔记
- 与监控主题关联度低的内容
输出格式化指南
所有脚本以 JSON 输出。向用户展示时，请格式化为易读的形式：
扫描结果展示（check_topics.js）：
小红书情报扫描完成（最近 24h）
🔔 值得关注的内容：
1. @博主名 - 2026-02-24
标题：AI编程工具深度对比评测
❤️ 1.2万 | ⭐ 8956 | 💬 326
🔗 https://www.xiaohongshu.com/explore/...
2. @另一位博主 - 2026-02-24
标题：Cursor 使用一个月真实感受
❤️ 3456 | ⭐ 2100 | 💬 89
🔗 https://www.xiaohongshu.com/explore/...
📋 其他内容：8 条常规笔记（已省略）
❌ 错误：0
无新内容时：
小红书情报扫描完成（最近 1h）
✅ 未检测到新内容
📋 扫描了 3 个关键词，无新笔记
企业场景示例
用户在 Studio 中说一句话，AI 自动选择脚本和参数：
| 用户说 | AI 执行 |
|---|---|
| "搜搜小红书上关于 AI 编程的笔记" | search_notes.js --keyword "AI编程" |
| "看看这个博主最近发了什么" | fetch_user_notes.js --user-id "<id>" --count 5 |
| "帮我看下这条笔记的详情" | get_note.js --url "<分享链接>" |
| "监控小红书上关于 WeaveFox 和 Cursor 的讨论" | check_topics.js --keywords "WeaveFox,Cursor" --since 24h |
| "看看小红书上热门的种草博主都在聊什么" | search_notes.js --keyword "种草" --sort popularity_descending |
推荐执行流程
当用户要求获取小红书情报时，请按以下顺序执行：
步骤 1：先执行一次即时查询（必须）
根据用户需求选择合适的脚本执行。首次使用建议用较宽时间窗口：
node scripts/check_topics.js --keywords "AI编程" --since 24h
如果 24h 内无内容，可扩大到 --since 7d。将结果按「输出格式化指南」展示给用户。
与其他技能的协作
| 技能 | 层级 | 协作方式 |
|---|---|---|
| weavefox-xhs-intel（本技能） | 数据层 | 获取小红书数据、内容筛选 |
| weavefox-x-intel | 数据层 | 获取 X/Twitter 数据（互补） |
错误处理
| 错误 | 原因 | 处理 |
|---|---|---|
TikHub API 401 | API Key 无效 | 正常不会出现（已内置），如出现请联系 Skill 作者 @奇玮 解决 |
TikHub API 429 | 请求过快 | 脚本已内置 1s 间隔，通常不会触发 |
TikHub API 403 | 账户余额不足 | 检查 Key 或联系 Skill 作者 @奇玮 |
Failed to resolve note_id | 分享链接无法解析 | 检查链接格式，尝试用 note_id 替代 |
文件结构
weavefox-xhs-intel/
├── SKILL.md # 本文档
└── scripts/
├── tikhub_client.js # 共享 API 客户端
├── search_notes.js # 关键词搜索笔记
├── fetch_user_notes.js # 获取用户最新笔记
├── get_note.js # 获取笔记详情
└── check_topics.js # 批量扫描（核心）