用途：解析 YouTube 视频与频道，拉取转录、评论、播放列表和搜索结果，以规范化 JSON 返回，适合做基于转录的摘要、情感分析或研究流程。
主要能力：转录接口 /youtube/transcript/{id}（可先用 /youtube/transcript/{id}/languages 查可用语言）；元数据与评论 /youtube/video/{id}、/youtube/comments/{id}；频道 /youtube/channel/{id}/videos、/shorts、/playlists 及 /youtube/profile/{id}；搜索 /youtube/search?q=...。完整端点见 reference/endpoints.md。
使用方式：先在 https://crawlora.net 获取免费 Crawlora API 密钥（每月 2,000 积分，无需信用卡），设置环境变量 CRAWLORA_API_KEY，请求发往 https://api.crawlora.net/api/v1，密钥缺失或无效返回 401。调用前需从 watch URL 或 youtu.be 链接提取视频 id，频道 URL 提取频道 id。示例：scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ | jq '.'；scripts/crawlora.sh /youtube/search q="web scraping tutorial" | jq '.'。统一用 scripts/crawlora.sh 发起请求，避免密钥出现在命令行参数中。
适用场景：用户粘贴 YouTube 链接要转录、摘要或统计；获取某视频评论；列出频道近期视频、短视频或播放列表；按关键词搜索视频；构建转录驱动的摘要、情感或研究管线；对有限视频集做带时间戳证据的对比。
限制：仅限公开 YouTube 页面数据，需遵守 YouTube 条款；按成功计费，仅 2xx 计费；并非所有视频都有字幕，转录为空时先查 languages；字幕或翻译可能听错语音，不能独立验证事实主张；搜索排名、观看量与评论样本应分开看待，不代表真实需求。密钥只存于 CRAWLORA_API_KEY，切勿硬编码、放入查询参数或提交到仓库。