---
name: xhs
description: "小红书笔记搜索、创作者分析和内容趋势研究。当用户需要搜索小红书笔记（小红书/红书/XHS/种草/笔记）、查看小红书博主（博主/达人/KOL/创作者）、分析小红书内容（内容分析/爆款笔记）、或研究小红书市场趋势（小红书选品/什么好卖/种草趋势）时使用此技能。"
---

# 小红书 (XHS) - 笔记搜索与创作者分析

所有命令使用 `scout xhs` 前缀。

---

## 快速选择：我该用哪个命令？

| 你的目标 | 命令 | 说明 |
|---------|------|------|
| **搜产品/找灵感** | `search-notes "关键词"` | 搜索笔记，支持中英文关键词 |
| **分析某篇笔记** | `note-detail <noteId>` | 获取笔记详情（互动数据、标签等） |
| **看博主主页** | `user-profile <userId>` | 粉丝数、笔记数、获赞数 |
| **看博主作品** | `user-notes <userId>` | 博主发布的笔记列表 |

---

## 典型场景

当用户说：
- "小红书上搜一下XX" / "小红书什么火" → `scout xhs search-notes "XX"`
- "看看这个笔记" + noteId → `scout xhs note-detail <noteId>`
- "看看这个博主" + userId → `scout xhs user-profile <userId>`
- "这个博主发了什么" → `scout xhs user-notes <userId>`
- "小红书上XX好不好卖" → `scout xhs search-notes "XX"` 分析互动数据
- "找小红书达人" → `scout xhs search-notes "品类关键词"` 从高赞笔记找创作者

---

## URL 解析 - 小红书链接处理

用户可能贴小红书链接。**不要用 WebFetch**（会被登录墙拦截），按以下规则提取 ID：

| URL 特征 | 提取内容 | 调用命令 |
|----------|---------|---------|
| `xiaohongshu.com/explore/笔记ID` | note_id（末尾的十六进制字符串） | `scout xhs note-detail <noteId>` |
| `xiaohongshu.com/user/profile/用户ID` | user_id | `scout xhs user-profile <userId>` |
| `xhslink.com/短链接` | 无法直接提取，告知用户提供 note_id | — |

---

## 命令详情

### 搜索笔记 — `scout xhs search-notes`

```bash
scout xhs search-notes "瑜伽裤" --page 1 --page-size 20
```

**参数**：
- `关键词`（必填）：支持中英文
- `--page`：页码（默认 1）
- `--page-size`：每页数量（默认 20）
- `-f, --format`：`json`（默认）| `text`

**返回数据**：
- `id` — 笔记 ID
- `title` — 标题
- `description` — 正文
- `type` — `image` 或 `video`
- `creator` — 作者（uid, username）
- `likes`, `comments`, `collects`, `shares` — 互动数据
- `url` — 笔记链接
- `hashtags` — 标签列表

### 笔记详情 — `scout xhs note-detail`

```bash
scout xhs note-detail 6489a2b0000000001e012345
```

### 用户主页 — `scout xhs user-profile`

```bash
scout xhs user-profile 5a1234567890abcdef012345
```

**返回数据**：
- `uid`, `username` — 用户基本信息
- `followers`, `following`, `totalNotes`, `totalLikes` — 数据概览
- `bio` — 简介
- `verified`, `verifyContent` — 认证状态
- `ipLocation` — IP 属地

### 用户笔记 — `scout xhs user-notes`

```bash
scout xhs user-notes 5a1234567890abcdef012345 --num 30
```

**参数**：
- `--num`：数量（默认 30）
- `--cursor`：分页游标（翻页用）

---

## 数据解读

### 互动数据指标

| 指标 | 爆款 | 优质 | 普通 | 低迷 |
|------|------|------|------|------|
| likes | >1万 | 1000-1万 | 100-1000 | <100 |
| collects | >5000 | 500-5000 | 50-500 | <50 |
| comments | >500 | 100-500 | 10-100 | <10 |

- **高赞 + 高收藏** = 内容有价值，用户想留存
- **高赞 + 低收藏** = 娱乐性内容，不够实用
- **低赞 + 高收藏** = 实用干货，用户默默收藏
- **收藏/点赞比 > 0.5** = 强购买意向信号（选品关键指标）

### 创作者评估

| 指标 | 头部达人 | 腰部达人 | 尾部达人 |
|------|---------|---------|---------|
| followers | >50万 | 1万-50万 | <1万 |
| totalNotes | >200 | 50-200 | <50 |

---

## 使用场景

### 场景 1：选品调研

```bash
# 搜索品类，分析爆款笔记的互动数据
scout xhs search-notes "瑜伽裤测评" --page-size 20

# 分析：
# - 高收藏/点赞比的笔记 = 有购买意向的品类
# - 多篇爆款笔记提到的品牌/功能 = 市场验证的卖点
```

### 场景 2：达人分析

```bash
# 从热门笔记找到达人 → 看主页 → 看作品
scout xhs search-notes "护肤推荐"
scout xhs user-profile <从笔记中获取的userId>
scout xhs user-notes <userId>
```

### 场景 3：跨平台验证

```bash
# 1. 小红书发现趋势
scout xhs search-notes "防晒霜推荐"

# 2. Amazon 验证海外市场需求
scout search "sunscreen"

# 3. 1688 找供应商
scout supplier-search "防晒霜"
```

---

## 重要提醒

1. **中文关键词效果更好**：小红书是中文平台，用中文搜索更精准
2. **收藏数是核心选品指标**：收藏 = 购买意向，比点赞更有参考价值
3. **笔记 ID 是十六进制字符串**：类似 `6489a2b0000000001e012345`
4. **用户 ID 也是十六进制字符串**：类似 `5a1234567890abcdef012345`
5. **不要用 WebFetch 访问小红书**：会被登录墙拦截，只能通过 API
6. **跨平台联动**：小红书发现趋势 → Amazon/TikTok 验证需求 → 1688 找供应商
