介绍
# ClawHub - YouTube Video Clipper & Downloader
使用精确的时间戳从 YouTube 视频中提取特定片段。这是一个强大的 ClawHub 技能，让视频剪辑变得轻松自如 - 只需提供 URL 和时间范围即可。
## 概述
ClawHub 主要设计用于**视频剪辑** - 即从 YouTube 视频中提取特定的时间范围。无论您需要 30 秒的精彩集锦、5 分钟的教程片段，还是任何自定义时间范围，ClawHub 都能精准处理。它还支持全视频下载、音频提取以及质量选择。
## 主要功能
### 核心功能：视频剪辑 - **基于精确时间戳的剪辑**：提取任意时间范围（MM:SS 或 HH:MM:SS） - **质量选择**：支持 720p、1080p 或最佳质量剪辑 - **音频剪辑**：将音频片段提取为 MP3 - **快速处理**：针对快速剪辑进行了优化
### 辅助功能：全视频下载 - 下载各种质量的完整视频 - 提取完整音轨 - 自定义输出文件名和格式
## 使用方法
### 基本语法 ``` /clawhub <youtube-url> [options] ```
## 剪辑示例（核心用法）
### 剪辑特定片段 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --clip 00:30-02:15 ``` 从 30 秒提取到 2 分 15 秒。
### 带质量选择的剪辑 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --clip 01:00-03:30 --quality 1080p ``` 提取从 1 分钟到 3 分 30 秒的 1080p 片段。
### 仅剪辑音频 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --clip 00:10-01:00 --audio-only ``` 将 10 秒到 1 分钟的音频提取为 MP3。
### 自定义文件名剪辑 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --clip 02:00-04:30 --output highlight.mp4 ```
### 剪辑教程片段 ``` /clawhub https://youtube.com/watch?v=tutorial123 --clip 05:20-12:45 --quality 720p ``` 非常适合提取特定的教程步骤。
### 剪辑音乐片段 ``` /clawhub https://youtube.com/watch?v=music456 --clip 01:15-02:30 --audio-only --output chorus.mp3 ```
## 下载示例（辅助用法）
### 下载完整视频 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ ```
### 下载特定质量 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --quality 720p ```
### 提取完整音频 ``` /clawhub https://youtube.com/watch?v=dQw4w9WgXcQ --audio-only ```
## 可用选项
| 选项 | 描述 | 示例 | |--------|-------------|---------| | `--clip <start>-<end>` | **核心功能** - 从开始时间剪辑到结束时间 | `--clip 00:30-02:15` | | `--quality <resolution>` | 指定质量 (720p, 1080p, best) | `--quality 1080p` | | `--audio-only` | 将音频提取为 MP3 | `--audio-only` | | `--output <filename>` | 自定义输出文件名 | `--output my_clip.mp4` | | `--format <format>` | 输出格式 (mp4, mkv, webm, mp3) | `--format mkv` |
## 剪辑的时间格式
该技能接受灵活的时间戳格式： - **MM:SS**：`01:30`（1 分 30 秒） - **HH:MM:SS**：`01:15:30`（1 小时 15 分 30 秒） - **M:SS**：`1:30`（与 01:30 相同） - **SS**：`90`（转换为 01:30）
## 剪辑工作原理
1. 您提供一个 YouTube URL 和时间范围 2. Claude 解析您的时间戳 3. 该技能使用优化方法提取该片段： - **方法 1**：yt-dlp 的原生剪辑（最快） - **方法 2**：ffmpeg 精确剪辑（备用方案） 4. 您的片段将保存到当前目录
## 使用场景
### 内容创作者 - 提取精彩瞬间用于 Shorts 或 Reels - 剪辑反应片段 - 创建合集片段 - 提取 B-roll 素材
### 教育工作者 - 剪辑特定教程步骤 - 提取讲座片段 - 创建学习资料 - 分享特定讲解内容
### 音乐人 - 提取歌曲片段 - 剪辑音频用于混音 - 获取特定的主歌或副歌 - 创建练习循环
### 研究人员 - 提取相关的视频片段 - 创建带时间戳的参考 - 归档特定内容 - 分析特定片段
## 输出位置
所有剪辑和下载内容都将保存到您当前的工作目录。您可以使用 `--output` 标志指定自定义路径。
## 重要提示
- **纯 Python 解决方案** - 无二进制依赖，仅需 Python - **自动安装依赖** - 如有需要，会自动安装 yt-dlp Python 模块 - **剪辑经过优化且快速** - 无需先下载完整视频 - **质量得以保持** - 剪辑片段保留原始视频质量 - **请注意版权** - 仅剪辑您有权访问的内容 - **灵活的时间戳** - 使用任何您觉得自然的格式 - **极简设置** - Python 通常预装，其他一切自动完成
## 技术细节
- **语言**：纯 Python 实现 - **主要库**：yt-dlp Python 模块（通过 pip 自动安装） - **音频处理**：ffmpeg（音频提取所需，通常预装） - **支持格式**：所有标准视频和音频格式 - **URL 支持**：youtube.com、youtu.be 及所有 YouTube URL 变体 - **安装**：全自动 - 按需检查并安装 yt-dlp 模块
## 故障排除
### 剪辑提取不正确 如果第一种方法失败，该技能将自动尝试替代方法。
### 无效的时间戳 使用格式：MM:SS 或 HH:MM:SS（例如 `01:30` 或 `01:15:30`）
### 视频不可用 请验证 YouTube URL 是否正确且视频可公开访问。
## 许可证
MIT License
## 支持
如有问题或疑问，请访问项目仓库或通过 ClawHub 提交反馈。