核心用法
YouTube Research Pro 是一款面向 AI Agent 的综合性 YouTube 数据处理工具，通过命令行接口实现以下核心功能：
零成本字幕提取：采用 youtube-transcript-api 直接抓取 YouTube 前端字幕数据，绕过 YouTube Data API 的 100 配额单位/请求限制，实现无限量免费字幕获取。支持纯文本、带时间戳、多语言选择及 JSON 输出格式。
多媒体下载：基于 yt-dlp 引擎支持 4K 视频与 FLAC/MP3 音频下载，可指定分辨率、嵌入字幕，满足离线学习与研究需求。
智能搜索与过滤：支持日期范围、视频时长（短/中/长）、排序方式（相关性/日期/观看量）等多维度过滤，精准定位目标内容。
批量处理能力：单次可处理最多 50 个视频的元数据获取，大幅提升研究效率；支持频道统计、评论抓取（含回复）、用户数据（订阅、播放列表、点赞）等深度功能。
显著优点
- 成本优势突出：字幕提取零 API 配额消耗，相比传统方案（每日约 100 条限制）实现数量级突破
- 功能整合度高：统一覆盖字幕、搜索、下载、批量操作四大场景，避免多工具切换
- 输出格式灵活：支持纯文本、JSON、带时间戳等多种格式，便于接入 LLM 分析流水线
- 扩展性强：多账户切换、命令别名系统、OAuth2 认证机制满足专业用户需求
潜在局限
- 下载功能依赖外部工具 yt-dlp，需单独安装且受 YouTube 反爬策略影响
- 搜索与用户数据功能仍消耗 API 配额，需配置 Google Cloud OAuth 凭证
- 字幕可用性依赖视频上传者是否开启，部分视频可能无法提取
- 多账户配置需手动管理凭证文件，学习成本高于纯 API Key 方案
适合人群
- AI 研究人员：需批量获取视频内容进行模型训练或数据分析
- 内容创作者与分析师：竞品监测、趋势追踪、受众反馈研究
- 教育工作者：构建课程资料库、提取讲座字幕生成学习笔记
- 播客听众：批量下载音频实现离线收听
常规风险
- 服务条款合规：大规模抓取可能触发 YouTube 反滥用机制，建议控制请求频率
- OAuth 凭证安全：
~/.config/youtube-skill/credentials.json需妥善保管，避免泄露 - 下载内容版权：需遵守 YouTube 服务条款及当地版权法规，仅限个人合理使用
- 依赖维护风险：yt-dlp 需持续更新以应对 YouTube 格式变更