短视频下载器（红狐数据）

SKILL.md

---
name: video-downloader
description: 短视频下载器 — 支持抖音、小红书、快手、B站无水印视频下载，开箱即用。
---

# 短视频下载器

通过 [redfox.hk](https://www.redfox.hk) API 解析并下载抖音、小红书、快手、B站的无水印视频。支持手机端和 PC 端的分享链接，开箱即用。

---

## 能力概述

支持从主流短视频平台解析作品链接，获取无水印的原始视频。

- **平台支持**：抖音、小红书、快手、B站
- **内容类型**：视频（mp4）、图文（jpg/png，暂不支持小红书图文）
- **输入方式**：粘贴分享链接即可（每次仅限一个链接，不支持批量上传）
- **去水印**：API 自动返回无水印直链
- **开箱即用**：内置公共 API Key，无需任何配置即可使用

---

## 配置安装

### API Key 配置

| 配置方式 | 说明 | 命令 |
|----------|------|------|
| **内置公共 Key**（开箱即用） | 免费约 10000 次，超出后需自行配置 | `python3 "$SKILL_PATH/assets/downloader.py" "<分享链接>"` |
| **环境变量**（推荐） | 设置一次，全局生效 | `export X_API_KEY=ark_你的密钥` |
| **命令行参数** | 临时使用，单次生效 | `python3 "$SKILL_PATH/assets/downloader.py" "<链接>" --api-key ark_你的密钥` |
| **配置文件** | 持久化存储，跨会话保留 | `mkdir -p ~/.qoder/apis && echo '{"api_key":"ark_你的密钥"}' > ~/.qoder/apis/redfox.json` |

> API Key 绑定用户身份（vid），需要用户身份的接口会自动注入，无需手动传 vid。Key 获取地址：[www.redfox.hk](https://www.redfox.hk)

### 依赖安装

| 依赖 | 安装命令 |
|------|----------|
| `requests` | `pip3 install requests` |

---

## 特色功能

| 功能 | 说明 |
|------|------|
| **无水印下载** | API 自动返回无水印直链，无需手动处理 |
| **图文下载** | 支持图文类型下载所有图片（暂不支持小红书图文） |
| **跨平台支持** | 一个工具覆盖四个主流平台 |
| **链接自适应** | 支持短链、分享链、网页链接等多种格式 |
| **进度显示** | 下载过程实时显示进度条和百分比 |
| **多端兼容** | 支持手机端分享链接和 PC 端网页链接 |

---

## 常见使用场景

| 场景 | 示例链接 | 说明 |
|------|----------|------|
| 抖音视频去水印保存 | `https://v.douyin.com/xxxxxx/` | 下载无水印视频到本地 |
| 小红书视频下载 | `http://xhslink.com/o/xxxxxx` | 下载无水印视频 |
| 快手视频收藏 | `https://v.kuaishou.com/xxxxxx` | 保存喜欢的视频作品 |
| B站高画质下载 | `https://b23.tv/xxxxxx` | 下载最佳画质+音质视频 |
| 内容二次创作 | 任意支持平台 | 下载素材用于剪辑创作 |
| 离线备份 | 任意支持平台 | 备份收藏的作品到本地 |

### 支持的作品链接格式

| 平台 | 链接格式 | 示例 |
|------|----------|------|
| 抖音（Douyin） | `https://v.douyin.com/xxxxxx/` | 手机分享链接 / PC 网页链接 |
| 小红书（Xiaohongshu） | `http://xhslink.com/o/xxxxxx` | 短链分享链接 |
| 快手（Kuaishou） | `https://v.kuaishou.com/xxxxxx` | 手机分享链接 |
| B站（Bilibili） | `https://b23.tv/xxxxxx` | 短链分享链接 |

---

## 为什么选择短视频下载器

- **无需抓包**：不需要分析网页源码或抓取接口，只需粘贴链接
- **持续可用**：基于稳定 API，不依赖爬虫反爬对抗
- **开箱即用**：内置公共 Key，拿到就能用
- **隐私安全**：API Key 本地存储，不会泄露

---

## 平台支持

| 平台 | 链接 |
|------|------|
| **SkillHub** | https://skillhub.ai/... |
| **ClawHub** | https://www.clawhub.com/... |
| **GitHub** | https://github.com/... |

---

## 常见问题

**Q：公共 Key 有多少次免费额度？**
A：约 10000 次。超出后 API 会返回 3107 错误，请配置自己的 Key。

**Q：如何获取自己的 API Key？**
A：前往 [www.redfox.hk](https://www.redfox.hk) 注册即可获取，格式为 `ark_xxx`。

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

**Q：支持图文下载吗？**
A：支持图文类型下载（暂不支持小红书图文）。图文内容会自动下载所有图片，并按序号命名。

**Q：可以批量上传多个链接吗？**
A：不支持。每次只能输入一个链接，批量上传会导致解析失败。如需下载多个视频，请逐个粘贴链接。

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

**Q：下载速度慢怎么办？**
A：大文件下载需要稳定的网络连接，可尝试更换网络环境。

---

## 了解更多

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