Download de Vídeos Xiaohongshu (RedNote)
YijiaDuan/download-xhs-videos
Baixe todos os vídeos de um criador RedNote para seu computador, offline
Ver no GitHubSkill do Claude Code para baixar em lote todos os vídeos de um criador da Xiaohongshu/RedNote para visualização offline. Contorna muros de assinatura e limitações do navegador usando cliques reais e curl, funcionando apenas em macOS com a extensão Claude-in-Chrome.
Instalação
npx convez-ai YijiaDuan/download-xhs-videos1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Arquivar conteúdo de criadores favoritos para visualização offline
- Fazer backup de vídeos educacionais ou de referência
- Análise local de conteúdo sem dependência de conexão
Veredito

Solução criativa que contorna limitações técnicas reais (assinatura, SPA routing, bloqueios de download) com engenharia prática. Escopo bem definido (macOS + Claude-in-Chrome), código transparente sobre limitações éticas e legais. Requer participação do usuário mas automatiza o trabalho pesado; mais ferramenta de nicho do que uso geral.
README
A tradução para o português deste README ainda está na fila.
download-xhs-videos.skill
"想把喜欢的小红书博主的视频存下来离线看,结果 yt-dlp 不灵、写脚本被签名墙挡、用浏览器下又被静默吞掉。"
用你已登录的 Chrome,把一个小红书博主的视频一条不落地下到本地——绕开签名墙、绕开浏览器下载限制,真实地存成 MP4。
这是一个写给 Claude Code 的 skill。你丢给它一个小红书博主主页链接说一句"把这个博主的视频都下下来",Claude 会照着 recipe 一步步:打开主页 → 滚动统计视频总数 → 逐条用真实点击打开笔记 → 从页面里抽出视频真实地址 → 用 curl 下到你指定的文件夹,并在每一步主动规避那些会让你白忙一小时的坑。
⚠️ 这个 skill 是逆着平台的反爬和浏览器的下载限制设计的。小红书的笔记只认真实鼠标点击打开,网页请求有签名墙,Chrome 还会静默拦掉自动化触发的下载,视频地址里的 token 又不能进 AI 的上下文——这四道坎都绕过去了,代价是它只能在 macOS + Claude-in-Chrome 扩展下跑。仅供个人离线观看与学习参考;很多博主主页明确写了「禁止搬运和商用」,skill 会先读 bio 提醒你,别拿去二次发布或商用。
安装 · 使用 · 它做什么 · 为什么要这么绕 · 能干啥不能干啥 · 踩坑预警 · English
安装
Claude Code
提示:Claude Code 从
~/.claude/skills/(全局)或当前 git 仓库根目录的.claude/skills/(项目级)自动加载 skill。克隆到哪个位置,它就在哪个范围生效。
# 全局安装(所有项目都能用)—— 推荐
git clone https://github.com/YijiaDuan/download-xhs-videos \
~/.claude/skills/download-xhs-videos
# 或只装到当前项目
mkdir -p .claude/skills
git clone https://github.com/YijiaDuan/download-xhs-videos \
.claude/skills/download-xhs-videos
装完什么都不用改,直接去跟 Claude Code 说话就行。
运行时依赖
- macOS(用到系统自带的
pbpaste和curl) - Claude in Chrome 扩展,已连接到当前会话
- 在那个 Chrome 里已登录你的小红书账号
- 一个小红书博主主页链接(形如
…/user/profile/<id>?xsec_token=…)
不需要 yt-dlp、不需要逆向签名、不需要任何第三方下载站。
使用
在 Claude Code 对话框里贴上博主主页链接,随便说一句:
把这个小红书博主的视频都下下来:<主页链接>
或者任意等价的自然语言:
- "帮我存一下这个博主的所有小红书视频"
- "把 @某某 的小红书视频镜像到本地"
- "download all videos from this RedNote creator"
- "archive this xiaohongshu profile's video notes for offline viewing"
Claude 会自动匹配到这个 skill 并开始执行。你需要参与的只有:
- 确认浏览器已连接、小红书已登录(skill 会先检查)
- 确认用途是个人观看(skill 读到 bio 里的版权声明时会跟你确认)
其余全自动:统计总数 → 逐条解析 → 下载 → 校验 → 给你一份清单。
它做什么
连接浏览器 ─► 打开主页 + 读 bio(版权/伦理确认)
│
▼
滚动到底,统计视频笔记总数
│
▼
┌────────── 每条笔记循环 ──────────┐
│ scrollIntoView 定位封面 + 算坐标 │
│ 真实点击打开笔记(SPA 才会加载) │
│ 从 __INITIAL_STATE__ 抽视频地址 │
│ 可信点击把地址写进剪贴板 │
│ curl 从剪贴板下载(地址不进上下文)│
│ 返回主页,下一条 │
└────────────────────────────────────┘
│
▼
校验:数量对、非空、都是有效 MP4
交付给你的最终产物:
| 产物 | 位置 |
|---|---|
| 全部视频 | ~/Documents/xhs-<博主>/(可在对话里改) |
| 文件命名 | 01_<标题>.mp4 … 按主页顺序编号 |
| 校验报告 | 总条数 / 总大小 / 有无损坏文件 |
为什么要这么绕
直接的法子全都不行,这张表是这个 skill 存在的理由:
| 你可能会想到的做法 | 为什么挂 | 这个 skill 怎么做 |
|---|---|---|
yt-dlp <链接> | 小红书支持时好时坏,经常失效 | 驱动真实浏览器,不依赖第三方解析 |
| 写脚本调网页 API | 请求要 x-s/x-t 签名,逆向脆弱易碎 | 不碰 API,从页面 __INITIAL_STATE__ 读地址 |
location.href 跳到笔记 URL | 被 SPA 路由弹回 /explore | 只用真实鼠标点击封面卡片打开 |
浏览器里 a.click() 下载 blob | 缺"用户手势激活",被 Chrome 静默丢弃 | 不走浏览器下载,改用 curl |
| 把视频地址返回给 AI 再拼 curl 命令 | 带 token 的地址被护栏拦截,进不了上下文 | 地址只走剪贴板 → curl,全程不进上下文 |
在页面里 fetch() 视频 | 几条之后连接池耗尽,永久挂起 | 一律交给 curl,不在页面里抓流 |
能干啥不能干啥
| 适合 ✅ | 不适合 ❌ |
|---|---|
| 把喜欢的博主视频存下来自己离线看 | 二次发布 / 搬运 / 商用(尊重创作者声明) |
| 学习参考别人的拍法、运镜、AI 工作流 | 批量爬全站 / 大规模采集 |
| 备份自己关注的创作者的作品 | 绕过付费墙、私密内容 |
| 一次几十条以内的博主全量镜像 | Windows / Linux(依赖 macOS 的 pbpaste) |
下载他人原创视频供个人留存属于可接受的灰区;重新发布或商用他人明确声明禁止搬运的作品则不是。skill 会先读博主 bio 并和你确认用途。
踩坑预警
这些都是真金白银踩出来的(SKILL.md 里有给 AI 的完整版):
- 笔记只认真实点击打开。 构造
<a>或location.href跳转都会被路由弹回/explore,必须点封面卡片。 - 带 token 的视频地址不能进 AI 上下文,一返回就被
[BLOCKED]。只能走剪贴板传给curl,绝不打印。 - 浏览器下载会"无声失败":开了"每次询问保存位置"会卡在原生对话框,关了又因缺少用户手势被丢弃。别和它较劲,直接
curl。 - 别在页面里
fetch视频,几条之后连接池耗尽,所有请求永久挂起。 - 主页是瀑布流布局,DOM 顺序 ≠ 视觉列号,坐标要靠
getBoundingClientRect()算,不能猜列。 - CDN 地址是
http://且需要Referer: https://www.xiaohongshu.com/,curl 要带上。 - 画质:取的是所选编码的最高码流(
masterUrl),小红书源码率本就不高,个别短视频只有 1–2MB 是正常的。
项目结构
download-xhs-videos/
├── SKILL.md # 给 AI 的执行手册(根目录,Claude Code 自动加载)
├── README.md # 你正在看的这份(给人看)
├── README_EN.md # English
├── LICENSE # MIT
└── scripts/
├── 01-load-and-count.js # 滚动主页,统计视频笔记总数
├── 02-locate-card.js # 重建有序卡片列表,定位第 N 条并返回点击坐标
├── 03-extract-and-copy.js # 读笔记视频地址,建剪贴板复制按钮
└── download.sh # 剪贴板 → curl 下载(带 CDN 地址校验)
没有
tools/、prompts/这类目录——这个 skill 的逻辑就是"浏览器步骤 + 4 个小脚本",刻意保持精简,不为了好看堆空目录。
FAQ
能在 Windows / Linux 上用吗?
暂时不能。它依赖 macOS 的 pbpaste 做剪贴板中转,以及 Claude-in-Chrome 扩展的可信点击。换平台需要改 download.sh 的剪贴板读取方式。
会不会被封号? 这是用你自己登录的浏览器、模拟正常浏览节奏逐条打开,不是高频爬虫。但任何自动化都有风险,量大请放慢、适可而止。
为什么不直接给我一个一键脚本? 因为打开笔记必须是真实点击、地址不能进上下文——这些都得由能驱动浏览器的 agent 来编排,纯脚本做不到。这正是把它做成 Claude Code skill 的原因。
下下来的视频有水印吗? 取的是笔记的视频流地址,通常无平台叠加水印;但画面内创作者自带的水印/字幕会保留。
License
MIT © Yijia Duan