核心用法
xiaohongshu-downloader 是一款专为小红书（RedNote）平台设计的视频下载与内容提取工具，基于 yt-dlp + ffmpeg + Whisper 技术栈构建。用户只需提供视频链接，即可通过多级指令获取从基础视频到完整资源包的多层次输出：
- 基础模式：下载原始 MP4 视频
- 完整资源包（
--full）：同步输出视频、音频 MP3、WebVTT 字幕、纯文本转录稿 - 智能总结模式（
--summary）：在完整资源包基础上，自动生成结构化 AI 摘要（Markdown 格式）
工具采用 3-Tier 字幕获取策略：优先抓取平台官方字幕 → 自动识别字幕 → 本地 Whisper 语音转录兜底，确保多语言内容可访问性。支持 Chrome/Firefox/Safari 浏览器 Cookie 认证，可绕过登录限制获取高清资源。
显著优点
1. 全流程自动化：从 URL 解析、格式探测、下载、音视频分离到 AI 总结，6 步标准化工作流无需人工干预
2. 多模态输出：单条视频可产出 5 类文件（视频/音频/字幕/转录/总结），满足学术研究、内容存档、二次创作等多场景需求
3. 智能容错机制：字幕获取失败自动降级至 Whisper 本地转录；依赖缺失时提供明确安装指引
4. 平台深度适配：针对小红书 xsec_token 鉴权机制优化，支持标准链接/短链/发现页链接三种格式
潜在局限与风险
| 限制类型 | 具体说明 |
|---------|---------|
| 平台依赖 | 高度依赖 `yt-dlp` 对小红书的解析能力，平台反爬升级可能导致功能失效 |
| 认证门槛 | 需预登录浏览器获取 Cookie，CAPTCHA 触发时需人工介入 |
| 质量上限 | 小红书平台本身限制，最高仅 1080p，无 4K 选项 |
| 版权合规 | 下载行为需遵守《小红书用户协议》及当地著作权法规，商用需获得授权 |
| 本地资源 | Whisper 转录对 GPU/内存有一定要求，大视频处理耗时较长 |
适合人群
- 内容研究者：需要批量归档、分析小红书视频素材的学术或市场研究人员
- 知识管理用户：希望将视频信息转化为可读文本并纳入个人知识库的笔记爱好者
- 多平台创作者：需跨平台引用小红书内容片段的自媒体运营者（需确保合法授权）
- 语言学习者：依赖双语字幕和纯文本转录进行听力训练的学习者
常规风险提示
- 账户安全：Cookie 认证方式存在令牌过期风险，不建议在公共设备留存登录状态
- 链接失效：
xsec_token有效期有限，建议获取分享链接后立即使用 - 存储管理：
--full模式单条视频可产生 50-200MB 数据，批量下载需预留充足磁盘空间 - 隐私边界：AI 总结功能会读取完整转录文本，含敏感个人信息的视频需谨慎处理