convez.ai
SkillAutomaçãoAvançado
YijiaDuan

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-videos

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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。

License: MIT macOS Claude in Chrome Claude Code

 

这是一个写给 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 并开始执行。你需要参与的只有:

  1. 确认浏览器已连接、小红书已登录(skill 会先检查)
  2. 确认用途是个人观看(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

Ver o original no GitHub

Bom para

Relacionados