1# XHS-Downloader 辅助工具
2 
3配合 [XHS-Downloader](https://github.com/JoeanAmier/XHS-Downloader) 使用的工具脚本，用于下载小红书收藏/点赞笔记并导出为 OpenClaw 记忆库格式。
4 
5## 依赖
6 
7需要先安装 XHS-Downloader：
8 
9```bash
10git clone https://github.com/JoeanAmier/XHS-Downloader.git
11cd XHS-Downloader
12pip install -r requirements.txt
13```
14 
15## 使用流程
16 
17### 1. 获取收藏/点赞链接（使用油猴脚本）
18 
19手动复制链接效率低，推荐使用 XHS-Downloader 提供的油猴脚本批量提取：
20 
21**安装脚本：**
22 
231. 安装 [Tampermonkey](https://www.tampermonkey.net/) 浏览器扩展
242. 安装用户脚本：[XHS-Downloader.js](https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js)
25 
26**提取链接：**
27 
281. 打开 [小红书网页版](https://www.xiaohongshu.com) 并登录
292. 进入个人主页 → **收藏** 或 **点赞** 页面
303. 点击 Tampermonkey 图标，选择：
31   - `提取收藏作品链接`
32   - `提取点赞作品链接`
334. 脚本会自动滚动页面加载全部内容
345. 提取完成后链接自动复制到剪贴板
35 
36**保存链接：**
37 
38将剪贴板内容粘贴到 `links.md` 文件：
39 
40```
41https://www.xiaohongshu.com/explore/xxx?xsec_token=...
42https://www.xiaohongshu.com/explore/yyy?xsec_token=...
43```
44 
45> **注意**：自动滚动功能默认关闭，需在脚本设置中手动开启。开启后可能触发风控，建议适度使用。
46 
47### 2. 批量下载
48 
49```bash
50# 在 XHS-Downloader 目录下运行
51python batch_download.py links.md
52```
53 
54下载的数据会保存到 `Volume/Download/ExploreData.db`。
55 
56### 3. 导出记忆库
57 
58**方式 A：导出为单文件**
59 
60```bash
61python export_memory.py
62# 生成 xhs_memory.md
63```
64 
65**方式 B：导出为多文件（推荐用于 OpenClaw）**
66 
67```bash
68python export_to_workspace.py
69# 生成到 ~/.openclaw/workspace/xhs-memory/
70```
71 
72### 4. 配置 OpenClaw 记忆搜索
73 
74编辑 `~/.openclaw/openclaw.json`，添加：
75 
76```json
77{
78  "memorySearch": {
79    "extraPaths": [
80      "~/.openclaw/workspace/xhs-memory"
81    ]
82  }
83}
84```
85 
86或者如果使用单文件导出，将 `xhs_memory.md` 放到 workspace 目录下。
87 
88## 脚本说明
89 
90| 脚本 | 功能 |
91|------|------|
92| `batch_download.py` | 批量下载笔记并记录到数据库 |
93| `export_memory.py` | 导出为单个 Markdown 文件 |
94| `export_to_workspace.py` | 导出为多个独立文件（按日期+标题命名） |
95 
96## 致谢
97 
98- [XHS-Downloader](https://github.com/JoeanAmier/XHS-Downloader) - GPL-3.0 License
99