mcpField
X
xiaohongshu-downloader

xiaohongshu-downloader

github.com/smile7up创意与媒体44219 次安装38 周前更新
代码仓库

关于 xiaohongshu-downloader

用于下载小红书视频的命令行技能，也可生成包含音频、字幕、转录文本和摘要准备材料的资源包。字幕按手动、自动和本地 Whisper 转录三种方式依次获取。

主要功能

  1. 01下载视频或仅下载 MP3 音频
  2. 02生成视频、音频、字幕和转录文件
  3. 03依次尝试手动字幕、自动字幕和 Whisper
  4. 04为 AI 摘要准备元数据
  5. 05支持多种小红书链接格式
  6. 06选择输出目录和视频画质

适用场景

  1. 01保存小红书视频以便后续查看
  2. 02字幕不可用时生成转录文本
  3. 03在一个目录收集视频资源和元数据
  4. 04准备视频转录文本以生成 AI 摘要

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/smile7up/xiaohongshu-downloader --skill xiaohongshu-downloader

安装后在 Claude Code 中输入/xiaohongshu-downloader确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
.gitignore
README.md
reference/
summary-prompt.md
scripts/
parallel_transcribe.py
download_xiaohongshu.py

详细介绍

小红书视频下载器与摘要生成器

从小红书（小红书/RedNote）下载视频，并可选择生成完整资源包：视频 + 音频 + 字幕 + 转录文本 + AI 摘要。

工作流

按顺序完成以下 6 个步骤：

步骤 1：检查依赖项

验证所需工具是否已安装：

yt-dlp --version
ffmpeg -version

两者都必须可用。如果缺少，请指引用户安装：

  • brew install yt-dlp（macOS）或 pip install yt-dlp
  • brew install ffmpeg（macOS）
步骤 2：获取视频信息
/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --list-formats

此操作会显示可用格式，并通过 Cookie 身份验证确认 URL 是否可用。

步骤 3：下载视频 + 提取音频

基础下载（仅视频，与 v1.0 向后兼容）：

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL"

完整资源包（视频 + 音频 + 字幕 + 转录文本）：

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --full

完整资源包 + AI 摘要准备：

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --summary

--full 标志会创建文件夹 ~/Downloads/<video title>/，其中包含：

  • video.mp4 — 原始视频
  • audio.mp3 — 提取的音频
  • subtitle.vtt — WebVTT 字幕（采用 3 级策略）
  • transcript.txt — 纯文本转录内容

--summary 标志会隐含启用 --full，并额外保存 .meta.json，用于生成 AI 摘要。

步骤 4：获取字幕（自动 — 3 级策略）

脚本会按顺序自动尝试以下策略：

  1. 人工字幕 — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN
  2. 自动生成的字幕 — yt-dlp --write-auto-subs
  3. Whisper 本地转录 — 使用 faster-whisper 时会回退到 parallel_transcribe.py
步骤 5：生成转录文本（自动）

脚本会自动从 VTT 中移除时间戳，生成 transcript.txt。

步骤 6：生成 AI 摘要（Claude 生成 summary.md）

如果用户请求生成摘要（通过 --summary 标志或提出“总结”请求）：

  1. 读取转录文件：

    ~/Downloads/<video title>/transcript.txt

  2. 读取元数据文件：

    ~/Downloads/<video title>/.meta.json

  3. 读取摘要提示词模板：

    reference/summary-prompt.md

  4. 将模板占位符替换为实际值：

    • {{TITLE}} — 来自 .meta.json
    • {{URL}} — 来自 .meta.json
    • {{DURATION}} — 来自 .meta.json
    • {{PLATFORM}} — “Xiaohongshu (小红书)”
    • {{TRANSCRIPT}} — transcript.txt 的内容

  5. 按照模板结构生成摘要。

  6. 将结果保存到：

    ~/Downloads/<video title>/summary.md

选项参考

选项描述默认值
-o, --output输出目录~/Downloads
-q, --quality视频画质（best、1080p、720p、480p）best
--browser用于读取 Cookie 的浏览器（chrome、firefox、safari、none）chrome
-a, --audio-only仅下载音频并保存为 MP3false
--list-formats列出可用格式false
--full完整资源包模式false
--summaryAI 摘要模式（隐含启用 --full）false

输出结构

基础模式（默认）
~/Downloads/
└── <title> [<id>].mp4
完整资源包模式（--full 或 --summary）
~/Downloads/<video title>/
├── video.mp4          # Original video
├── audio.mp3          # Extracted audio
├── subtitle.vtt       # WebVTT subtitles
├── transcript.txt     # Plain text transcript
├── .meta.json         # Video metadata (--summary only)
└── summary.md         # AI-generated summary (--summary only, written by Claude)

支持的 URL 格式

格式示例
探索页链接https://www.xiaohongshu.com/explore/676a35670000000013002578
发现页链接https://www.xiaohongshu.com/discovery/item/676a35670000000013002578?xsec_token=TOKEN
短链接http://xhslink.com/a/xxxxx

故障排除

问题解决方案
No video formats found先在浏览器中登录 xiaohongshu.com，然后使用 --browser chrome
Unable to extract initial state触发了 CAPTCHA — 在浏览器中打开 URL 并完成验证，然后重试
链接已过期复制新的分享链接（令牌会过期）
未找到字幕脚本会自动回退到 Whisper 转录
Whisper 不可用安装 uv（brew install uv）以自动管理依赖项

重要说明

  • 为获得最佳效果，请始终使用完整的分享 URL（包含 xsec_token）
  • 下载前，请先在浏览器中登录 xiaohongshu.com
  • 视频最高画质通常为 1080p（受平台限制）
  • Whisper 转录需要使用 uv 进行自动依赖项管理，或手动安装 faster-whisper
  • 请尊重版权并遵守小红书的服务条款

评论

支持 Markdown