xiaohongshu-downloaderlisted

# 小红书视频下载器 + 口播文案转录 将小红书视频下载到本地，自动用 Whisper 转录口播内容，生成 Markdown 逐字稿。中文视频直接保存中文，英文视频翻译成中文后保存。 ## 触发条件 - 用户发送 `xiaohongshu.com/discovery/item/xxx` 或 `xhslink.com/xxx` 链接 - 用户说"下载这个小红书视频"、"扒一下这个文案"、"存下来"且链接是小红书的 ## 前置依赖 | 工具 | 用途 | 安装检查 | |------|------|---------| | yt-dlp | 视频下载 | `which yt-dlp` | | whisper (openai-whisper) | 语音转文字 | `which whisper` | | ffmpeg | 音频处理 | `which ffmpeg` | ## 工作流程 ### 阶段 A：下载视频 #### 第 1 步：用脚本下载视频 ```bash SKILL_DIR="$(cd "$(dirname "$0")" && pwd)" bash "${SKILL_DIR}/scripts/download_xiaohongshu.sh" '<XIAOHONGSHU_URL>' '<OUTPUT_DIR>' ``` 脚本会输出下载的文件路径。 #### 第 2 步：确认下载成功 验证文件存在且大小 > 0。记录文件路径和视频标题（如果 yt-dlp 能提取到）。 ### 阶段 B：视频转录 #### 第 3 步：创建目录结构 ``` <OUTPUT_DIR>/小红书-{视频标题或简短描述}/ ├── transcript.md ← 格式化的逐字稿 Markdown ├── videos/ │ └── video.mp4 ← 原始视频 └── transcripts/ ├── audio.srt ← SRT 字幕文件 └── audio.txt ← 纯文本逐字稿 ``` 标题来源优先级： 1. yt-dlp 提取的标题 2. 视频前几句口播内容的概括 3. 默认用 `小红书-视频` #### 第 4 步：移动视频到目录结构中 ```bash mv {下载的mp4} {output_dir}/videos/video.mp4 ``` #### 第 5 步：Whisper 转录 ```bash whisper "{output_dir}/videos/video.mp4" \ --model medium \ --output_format srt \ --output_dir /tmp/xhs_transcribe ``` **语言检测策略**： - 先不指定 `--language`，让 Whisper 自动检测 - 如果自动检测为中文 → 中文视频，直接保存 - 如果自动检测为英文 → 英文视频，转录后翻译成中文 **模型选择**： - `base`：快速但准确率差，不推荐 - `medium`：平衡选择，中文效果好（推荐） - `large`：最佳效果但很慢，长视频慎用 **注意**： - ~8 分钟视频用 medium 模型约需 15-20 分钟 - 用 `background=true` + `notify_on_complete=true` 后台运行 -