- name
- xhs-to-obsidian
- description
- Extract Xiaohongshu (小红书) posts into Obsidian notes. Use when user shares a Xiaohongshu link and wants to save it as a markdown note. Supports single posts, batch extraction, and video transcription via whisper. Activates on: 小红书链接, xhs链接, 小红书帖子, RedNote links, or any URL from xiaohongshu.com.
xhs-to-obsidian
把小红书帖子一键提取为 Obsidian Markdown 笔记。
核心流程
- 检查 Cookies → 2. 提取内容 → 3. 视频转录（如有） → 4. 保存笔记
常量定义
| 常量 | 默认值 |
|---|---|
| Cookies | ~/.openclaw/xhs-cookies.json |
| Obsidian 目录 | ~/Documents/Obsidian Vault/xhs |
Step 0: 检查并设置 Cookies
Cookie 文件不存在时，引导用户从 Chrome 导出：
- 在 Chrome 打开 xiaohongshu.com 并登录
- 打开 DevTools (F12) → Console
- 运行以下代码复制 cookies：
copy(JSON.stringify(document.cookie.split('; ').map(c => {
const [name, ...rest] = c.split('=');
return { name, value: rest.join('='), domain: '.xiaohongshu.com', path: '/',
expires: Date.now()/1000 + 86400*30, size: name.length + rest.join('=').length,
httpOnly: false, secure: false, session: false, priority: 'Medium',
sameParty: false, sourceScheme: 'Secure', sourcePort: 443 };
})))- 保存到
~/.openclaw/xhs-cookies.json
Step 1: 提取帖子
python3 {baseDir}/scripts/extract_post.py "<小红书URL>" --cookies ~/.openclaw/xhs-cookies.json --output ~/Documents/Obsidian\ Vault/xhs输出为 JSON，包含 success、filepath、type（image/video）、video_url 等字段。
错误处理：
COOKIES_NOT_FOUND→ 引导用户导出 cookies（见 Step 0）POST_NOT_AVAILABLE→ 帖子不可见（可能需要重新登录）COOKIES_EXPIRED→ cookies 过期，重新导出
Step 2: 视频转录（如帖子为视频）
如果返回 type: video 且包含 video_url，执行转录：
bash {baseDir}/scripts/video_transcribe.sh "<video_url>" "<post_id>" "<output_dir>"转录完成后，将文本追加到笔记的 ## 视频转录 段落。
依赖（可选）：
ffmpeg— 音频提取mlx-whisper或whisper— 语音识别
安装：brew install ffmpeg && pip install mlx-whisper
Step 3: 保存笔记
extract_post.py 已自动保存。如需手动整理，格式如下：
# 标题（一句话洞察，非描述）
内容...
---
> **来源**: 小红书 · 作者名
> **日期**: YYYY-MM-DD
> **互动**: N赞 / N收藏 / N评论
> **标签**: tag1, tag2
> **链接**: https://www.xiaohongshu.com/explore/...批量提取
多链接用换行分隔：
while read -r url; do
python3 {baseDir}/scripts/extract_post.py "$url"
done <<EOF
https://www.xiaohongshu.com/explore/...
https://www.xiaohongshu.com/explore/...
EOF