用途：在本地命令行模式下处理 YouTube 字幕，无需 MCP 服务器。适用于用户要求获取字幕、列出字幕语言或对字幕做分析时。
主要能力：三种模式。transcript 返回字幕条目或纯文本；languages 列出可用字幕语言；analyze 返回抽取式摘要、关键要点或引用。
使用方式：先安装依赖 python3 -m pip install youtube-transcript-api。从请求中提取 YouTube URL 或 11 位视频 ID，选择模式后运行本目录下的 CLI 工具。示例：python3 youtube_transcript_tool.py --mode transcript --url "VIDEO_ID" --include-timestamps false；python3 youtube_transcript_tool.py --mode languages --url "https://youtu.be/VIDEO_ID"；python3 youtube_transcript_tool.py --mode analyze --url "VIDEO_ID" --analysis-type key_points --max-items 7。
输出契约：默认 --json true，成功返回 ok: true 及 mode、video_id 和对应负载；失败返回 ok: false 及 error.code、error.message、error.hint。用 --json false 获得可读文本。
默认值：--lang en、--include-timestamps true、--analysis-type summary、--max-items 5、--json true。
限制与错误处理：失败时直接展示 hint 并建议一步后续操作。invalid_video_id 检查 URL 格式或改用 11 位 ID；transcripts_disabled 发布者关闭字幕；no_transcript 换语言或尝试自动生成字幕；video_unavailable 视频私有、删除或受限；rate_limited 稍后重试或换网络；dependency_missing 安装 youtube-transcript-api。其他平台、收费与效果信息暂未提供。