mcpField
V
video-downloader

video-downloader

github.com/redfox-data创意与媒体450293 次安装2 天前更新
代码仓库

关于 video-downloader

通过 redfox.hk API 解析并下载多个主流短视频与社交平台的无水印视频及图文,适合需要保存或整理网络内容的用户。每次处理一个经过格式校验的分享链接。

主要功能

  1. 01支持多个主流内容平台
  2. 02下载无水印视频与图文
  3. 03校验分享链接格式
  4. 04显示下载进度

适用场景

  1. 01保存短视频以供离线观看
  2. 02下载平台图文中的图片
  3. 03获取剪辑创作素材

安装

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

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

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

包含的文件

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

presentation.html
README.en.md
README.md
assets/
downloader.py

详细介绍

来自项目 README

短视频下载器

通过 redfox.hk API 解析并下载主流短视频平台的无水印视频/图文。


能力概述

  • 平台支持:抖音、小红书、快手、视频号、B站、YouTube、Instagram、X(Twitter)、TikTok、Threads、Facebook、Vimeo 等主流平台
  • 内容类型:视频(mp4)、图文(jpg/png,暂不支持小红书图文)
  • 输入方式:粘贴页面分享链接即可(每次仅限一个链接,不支持批量上传)
  • 去水印:API 自动返回无水印直链

链接使用规范

支持的链接格式

本工具仅接受以下平台的页面分享链接,传入前会自动校验链接是否匹配支持的格式:

平台链接格式示例
🎵 抖音https://v.douyin.com/xxxx / douyin.com/video/xxx
📕 小红书http://xhslink.com/xxx / xhslink.cn/xxx
📱 快手https://v.kuaishou.com/xxxx
📺 视频号https://weixin.qq.com/sph/xxxx
📺 B站https://b23.tv/xxxx / bilibili.com/video/xxx
▶️ YouTubehttps://youtu.be/xxx / youtube.com/watch?v=xxx
📷 Instagramhttps://www.instagram.com/p/xxx
🐦 X (Twitter)https://x.com/xxx/status/xxx
🎵 TikTokhttps://www.tiktok.com/@xxx/video/xxx
🧵 Threadshttps://www.threads.net/@xxx/post/xxx
📘 Facebookhttps://www.facebook.com/xxx/videos/xxx
🎬 Vimeohttps://vimeo.com/xxxxx

❌ 非上述格式的链接(如直接视频地址、未知平台链接等)会被拦截,不会调用 API,避免浪费。


使用方式

示例命令

下载抖音视频:

python3 "$SKILL_PATH/assets/downloader.py" "https://www.douyin.com/jingxuan?modal_id=7597329042169220398"

其他平台类似:

python3 "$SKILL_PATH/assets/downloader.py" "https://youtu.be/xxxxxx"
python3 "$SKILL_PATH/assets/downloader.py" "https://www.instagram.com/p/xxxxxx"
首次使用

使用前需配置 REDFOX_API_KEY(前往 redfox.hk 注册获取,格式 ak_xxxxxxxx)。

配置方式(任选其一):

方式命令
环境变量(推荐)export REDFOX_API_KEY=ak_你的密钥
命令行参数python3 "$SKILL_PATH/assets/downloader.py" "<链接>" --api-key ak_你的密钥
配置文件echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json

特色功能

功能说明
无水印下载API 自动返回无水印直链,无需手动处理
图文下载支持图文类型下载所有图片(暂不支持小红书图文)
跨平台支持覆盖抖音、小红书、快手、视频号、B站、YouTube、Instagram 等十多主流平台
链接自适应支持短链、分享链、网页链接等多种格式
进度显示下载过程实时显示进度条和百分比
多端兼容支持手机端分享链接和 PC 端网页链接

常见使用场景

场景示例链接说明
抖音视频去水印保存https://v.douyin.com/xxxxxx/下载无水印视频到本地
小红书视频下载http://xhslink.com/o/xxxxxx下载无水印视频
快手视频收藏https://v.kuaishou.com/xxxxxx保存喜欢的视频作品
B站高画质下载https://b23.tv/xxxxxx下载最佳画质+音质视频
YouTube 视频下载https://youtu.be/xxxxxx下载 YouTube 视频
Instagram 视频/图文https://www.instagram.com/p/xxxxxx下载 Instagram 内容
内容二次创作任意支持平台下载素材用于剪辑创作
离线备份任意支持平台备份收藏的作品到本地
支持的作品链接格式
平台链接格式说明
抖音(Douyin)https://v.douyin.com/xxxxxx/手机分享链接 / PC 网页链接
小红书(Xiaohongshu)http://xhslink.com/o/xxxxxx短链分享链接
快手(Kuaishou)https://v.kuaishou.com/xxxxxx手机分享链接
视频号(WeChat Channels)微信内分享链接需复制微信内的链接
B站(Bilibili)https://b23.tv/xxxxxx短链分享链接
YouTubehttps://youtu.be/xxxxxx短链 / 网页链接
Instagramhttps://www.instagram.com/p/xxxxxx帖子 / Reels 链接
X(Twitter)https://x.com/xxx/status/xxx推文视频链接
TikTokhttps://www.tiktok.com/@xxx/video/xxxTikTok 视频链接
Facebookhttps://www.facebook.com/xxx/videos/xxxFacebook 视频链接
Threadshttps://www.threads.net/@xxx/post/xxxThreads 链接
Vimeohttps://vimeo.com/xxxxxxVimeo 视频链接

常见问题

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

Q:下载的视频有水印吗? A:没有。API 返回的是无水印直链。

Q:支持图文下载吗? A:支持图文类型下载(暂不支持小红书图文)。图文内容会自动下载所有图片,并按序号命名。

Q:可以批量上传多个链接吗? A:不支持。每次只能输入一个链接,批量上传会导致解析失败。

Q:链接提示解析失败怎么办? A:确认链接是否完整、是否已过期。短链有时效性,建议重新复制分享链接。


了解更多

本工具基于 redfox.hk 的 parseWork/parse 接口构建。前往官网查看更多 API 能力和使用文档。

评论

支持 Markdown