universal-video-downloader

TotalClaw 作者 totalclaw

使用 yt-dlp 从 YouTube、Instagram、TikTok、Twitter/X 和 1000 多个其他网站下载视频。支持质量选择和自动清理。当用户提供来自任何平台的视频链接并想要下载时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~itzsubhadip-universal-video-downloader

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~itzsubhadip-universal-video-downloader/file -o itzsubhadip-universal-video-downloader.md

# Universal Video Downloader

Download videos from almost any platform using the powerful `yt-dlp` tool.

## Features
-   **Platform Support:** YouTube, Instagram, TikTok, Twitter/X, Facebook, and many more.
-   **Quality Selection:** Choose from 144p up to 4K/8K resolutions.
-   **Automatic Cleanup:** Files are deleted from the server immediately after successful upload to the chat.
-   **Smart Merging:** Automatically merges high-quality video and audio streams into a single MP4 file.

## Workflow
1.  **Trigger:** User sends a video link (e.g., YouTube, Instagram).
2.  **Information Gathering:** The agent uses `scripts/download.py info` to fetch available qualities and the video title.
3.  **User Choice:** The agent presents resolutions to the user and asks which one they prefer.
4.  **Download:** Once selected, the agent runs `scripts/download.py download` with the specific Format ID.
5.  **Delivery:** The agent sends the resulting file using the `message` tool with `filePath`.
6.  **Cleanup:** The agent **must** delete the file from disk using `rm` immediately after the message is successfully sent to save disk space.

## Usage for Agents

### 1. Fetch Video Info
```bash
python3 scripts/download.py info "URL"
```

### 2. Download Specific Format
```bash
python3 scripts/download.py download "URL" "FORMAT_ID"
```

## Safety & Storage
-   This skill is intended for temporary processing.
-   **CRITICAL:** Always delete the downloaded file after the user receives it to maintain disk space.

---

## 中文说明

# 通用视频下载器

使用强大的 `yt-dlp` 工具从几乎任何平台下载视频。

## 功能
-   **平台支持：** YouTube、Instagram、TikTok、Twitter/X、Facebook 等众多平台。
-   **质量选择：** 可从 144p 到 4K/8K 分辨率中选择。
-   **自动清理：** 文件成功上传到聊天后会立即从服务器删除。
-   **智能合并：** 自动将高质量视频流和音频流合并为单个 MP4 文件。

## 工作流程
1.  **触发：** 用户发送视频链接（例如 YouTube、Instagram）。
2.  **信息收集：** 代理使用 `scripts/download.py info` 获取可用质量和视频标题。
3.  **用户选择：** 代理向用户展示可用分辨率，并询问其偏好哪一种。
4.  **下载：** 选定后，代理使用特定的 Format ID 运行 `scripts/download.py download`。
5.  **交付：** 代理使用带 `filePath` 的 `message` 工具发送生成的文件。
6.  **清理：** 消息成功发送后，代理**必须**立即使用 `rm` 从磁盘删除文件，以节省磁盘空间。

## 代理使用方式

### 1. 获取视频信息
```bash
python3 scripts/download.py info "URL"
```

### 2. 下载特定格式
```bash
python3 scripts/download.py download "URL" "FORMAT_ID"
```

## 安全与存储
-   此技能用于临时处理。
-   **关键：** 始终在用户收到文件后删除已下载的文件，以维护磁盘空间。