用途：通过 curl 直接调用 YouTube Data API v3，完成视频搜索、视频详情、频道信息、播放列表条目与评论抓取等操作。官方文档见 https://developers.google.com/youtube/v3。
主要能力：按关键词或筛选条件（时间、排序、分类）搜索视频；获取视频标题、描述、统计与时长；获取频道订阅数、视频数与描述，支持按频道 ID、@handle 或用户名查询；列出播放列表条目、频道上传列表与频道播放列表；抓取视频评论并按关键词搜索评论；获取指定地区热门视频与视频分类。
使用方式：需创建 Google Cloud 项目并启用 YouTube Data API v3，创建 API Key 后设置 export YOUTUBE_API_KEY="your-api-key-here"。基础地址为 https://www.googleapis.com/youtube/v3，用 curl 加 part、key 等参数请求，可配合 jq 解析。注意：当命令含 $VAR 且通过管道传给其他命令时，需用 bash -c '...' 包裹，否则环境变量会被清空。示例：bash -c 'curl -s "https://www.googleapis.com/youtube/v3/search?part=snippet&q=kubernetes+tutorial&type=video&maxResults=5&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle}'。常用 part 参数：videos 支持 snippet、statistics、contentDetails、status、player；channels 支持 snippet、statistics、contentDetails、brandingSettings。分页可用 nextPageToken。
适用场景：内容检索与调研、频道与视频数据分析、播放列表整理、评论采集与筛选、热门内容监控。
限制：API 每日配额 10000 单位，搜索消耗 100 单位，多数其他请求消耗 1 单位；遇 403/429 需指数退避；API Key 不应暴露在客户端代码中；建议缓存响应以节省配额。视频 ID 可从 youtube.com/watch?v=VIDEO_ID 或 youtu.be/VIDEO_ID 提取。生产环境建议限制密钥的应用范围与 API 范围。其他如收费、价格、平台支持等信息暂未提供。