mcpField
X
xiaohongshu-video-downloader

xiaohongshu-video-downloader

github.com/redfox-dataCreative & media45068 installsUpdated 1d ago
Repository

About xiaohongshu-video-downloader

A skill for creators, collectors, and social media operators to resolve Xiaohongshu video links. It uses redfox.hk to return watermark-free download URLs and handles one or multiple links.

Key features

  1. 01Get watermark-free video URLs
  2. 02Parse links in batches
  3. 03Validate domain and xsec_token
  4. 04Accept web and xhslink.com URLs
  5. 05Return video and cover URLs

Use cases

  1. 01Collect clips for editing
  2. 02Back up public video posts
  3. 03Review videos offline for trend analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/redfox-data/redfox-community --skill xiaohongshu-video-downloader

After installing, type/xiaohongshu-video-downloaderin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.en.md
README.md
references/
core_workflow.md
scripts/
downloader.py

Details

From the project README

小红书视频下载

粘贴带 xsec_token 参数的小红书视频链接，一键获取无水印视频下载直链。通过 redfox.hk 服务解析，支持单个或批量链接处理，自动识别并校验小红书视频链接。

⚠️ 链接必须携带 xsec_token 参数，否则小红书接口会返回链接格式错误。官方示例链接： https://www.xiaohongshu.com/explore/6a3c7aa6000000001003e071?xsec_token=AB-U4vc8DJUJoY9w-ebP_DvuxgiSNYmx8n35V4zvPo__M=&xsec_source=pc_feed

简介

适用对象：需要下载小红书视频的用户，包括内容创作者、视频收藏者、运营分析人员。

核心能力：

  • 📹 粘贴带 xsec_token 参数的小红书链接即可获取无水印 mp4 下载直链
  • 📦 支持批量链接解析（空格分隔多个链接）
  • 🔍 自动校验域名与 xsec_token 参数，不合规链接会提示重新输入并附上官方示例
  • 🎬 返回视频下载链接、封面链接，复制到浏览器或下载工具即可保存

功能特性

功能说明
无水印直链自动返回无水印视频下载链接，无需手动处理
即贴即解析粘贴带 xsec_token 的视频链接即可，无需额外操作
批量解析支持一次粘贴多个链接，逐个解析并在最后汇总成功和失败数量
智能校验自动识别小红书视频链接并校验 xsec_token 参数，不合规链接提示重新输入
链接自适应支持 www.xiaohongshu.com 网页链接与 xhslink.com 短链两种格式
接口错误兜底接口返回链接格式错误时自动附上官方示例链接，引导用户重新传入
结果直出解析完成直接返回下载链接，复制即可用

一键安装

  1. 前往 redfox.hk 注册获取 API Key
  2. 配置环境变量：export REDFOX_API_KEY=ark_你的密钥
  3. 粘贴带 xsec_token 参数的小红书视频链接即可使用

使用指南

核心执行流程详见 references/core_workflow.md

直接用自然语言描述需求，无需记忆命令。提供正确的小红书视频链接时，直接执行解析并返回结果。

常用说法速查
意图示例话术效果
下载单个视频「下载这个视频 https://www.xiaohongshu.com/explore/6a3c7aa6000000001003e071?xsec_token=AB-U4vc8DJUJoY9w-ebP_DvuxgiSNYmx8n35V4zvPo__M=&xsec_source=pc_feed」解析链接并返回无水印下载直链
批量下载「下载这几个视频 链接1 链接2 链接3」（每个链接均需携带 xsec_token）逐个解析每个链接，最后汇总结果
保存视频「帮我把这条小红书视频存下来」引导贴上带 xsec_token 的链接，解析后返回下载链接
支持的作品链接格式
平台链接格式示例
小红书https://www.xiaohongshu.com/explore/<笔记ID>?xsec_token=<token>&xsec_source=<source>https://www.xiaohongshu.com/explore/6a3c7aa6000000001003e071?xsec_token=AB-U4vc8DJUJoY9w-ebP_DvuxgiSNYmx8n35V4zvPo__M=&xsec_source=pc_feed
小红书http://xhslink.com/a/<短码>?xsec_token=<token>手机分享短链，同样需携带 xsec_token

🔑 如何获取带 xsec_token 的链接：在小红书 PC 网页打开笔记后，直接复制浏览器地址栏 URL；或在 App 内点“分享 → 复制链接”，得到的链接默认已携带 xsec_token。

使用场景

场景角色示例问法收益
素材收集剪辑师「下载这条小红书视频」快速拿到无水印素材，直接进剪辑流程
内容备份收藏者「保存这个小红书视频」原笔记删除也不怕，本地永久留存
热点分析运营「把这个爆款视频下下来」离线反复观看，拆解爆款逻辑

常见问答

Q：如何获取自己的 API Key？ A：前往 redfox.hk 注册即可获取 Token。

Q：下载的视频有水印吗？ A：没有。返回的是无水印视频直链。

Q：可以批量解析多个链接吗？ A：可以。多个链接用空格分隔即可，会逐个解析并在最后汇总成功和失败数量（每个链接均需携带 xsec_token）。

Q：为什么我的链接提示“缺少 xsec_token 参数”？ A：小红书接口要求链接必须携带 xsec_token 参数，否则无法解析。请在 PC 网页地址栏或 App 分享面板重新复制完整链接，例如： https://www.xiaohongshu.com/explore/6a3c7aa6000000001003e071?xsec_token=AB-U4vc8DJUJoY9w-ebP_DvuxgiSNYmx8n35V4zvPo__M=&xsec_source=pc_feed

Q：输入了非小红书链接会怎样？ A：会提示「该链接不是小红书视频链接」，附上官方示例链接并终止解析。请重新输入正确的小红书视频链接（支持 www.xiaohongshu.com 网页链接或 xhslink.com 短链，均需携带 xsec_token）。

Q：链接提示解析失败怎么办？ A：依次排查：① 链接是否携带 xsec_token；② 链接是否完整；③ 视频是否仍然存在、笔记内容是否公开。私密笔记或已删除笔记无法解析。

了解更多

本工具基于 redfox.hk 的视频解析服务构建。前往官网查看更多功能和使用文档。

Comments

Markdown supported