ClawHub — YouTube 视频剪辑与下载工具

基于精确时间戳，从 YouTube 视频中提取指定片段。这是 ClawHub 的一项强大能力，让视频剪辑变得轻而易举——只需提供视频 URL 和时间范围即可。

概述

ClawHub 主要面向视频剪辑场景——即从 YouTube 视频中提取特定时间段的内容。无论是 30 秒的精彩高光、5 分钟的教学片段，还是任意自定义时长，ClawHub 均可精准完成。此外，在需要时，它也支持完整视频下载、音频提取及画质选择。

核心功能

主要功能：视频剪辑

• 基于时间戳的精确剪辑：支持任意时间段（格式为 MM:SS 或 HH:MM:SS）
• 画质选择：支持 720p、1080p 或最佳可用画质进行剪辑
• 音频剪辑：将音频片段导出为 MP3 格式
• 快速处理：专为高效剪辑优化

次要功能：完整下载

• 以多种画质下载完整视频
• 提取完整音频轨道
• 自定义输出文件名与格式

使用方法

基本语法

/clawhub  [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

以 1080p 画质提取从第 1 分钟至第 3 分 30 秒的视频片段。

仅提取音频

/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

可用选项

剪辑时间格式

该技能支持灵活的时间戳格式：

• 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. 该技能通过优化方式提取对应片段：
   • 方式一：使用 yt-dlp 原生剪辑（最快）
   • 方式二：使用 ffmpeg 精确切片（备用方案）
4. 剪辑结果保存至当前工作目录

典型应用场景

内容创作者

• 提取精彩片段用于 Shorts 或 Reels
• 剪辑反应类内容
• 制作合集片段
• 提取 B-roll 素材

教育工作者

• 剪辑特定教学步骤
• 提取课程讲座片段
• 制作学习资料
• 分享特定讲解内容

音乐人

• 提取歌曲段落
• 为 Remix 提取音频素材
• 获取特定主歌或副歌部分
• 创建练习循环片段

研究人员

• 提取相关视频片段
• 生成带时间戳的参考引用
• 归档特定内容
• 分析特定区段

输出位置

所有剪辑片段和下载文件均保存至当前工作目录。您可通过 --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 提交反馈。