YouTube Videos API 集成

从youtube网址中获取json字幕文件

以及用于查询 YouTube 视频的详情（snippet）、状态（status）、统计（statistics）字段。 支持两种输入方式：

• 通过视频 ID 查询
• 通过主题（topic）先搜索一批视频，再拉取这些视频的详情/状态/统计（便于后续分析）

1) 安装依赖

uv sync

• uv安装参考: uv_install.md

2) 配置密钥

在.env中输入我告诉你的webshare用户名和密码

# 用于在transcript中使用
WEBSHARE_PROXY_USERNAME=你的webshare用户名
WEBSHARE_PROXY_PASSWORD=你的webshare密码
# 可选，在你需要搜索，下载等其他功能时使用
YOUTUBE_API_KEY=你的key

Quick Start

uv run python youtube_transcript_from_url.py "youtube网址" --save

• 生成的字幕文件会保存再本地的json文件

3) 完整使用示例（youtube_transcript_api）

支持直接粘贴 YouTube 地址（也支持直接传视频 ID）：

uv run python youtube_transcript_from_url.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

指定语言优先级（逗号分隔）：

uv run python youtube_transcript_from_url.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --languages en,en-US

保存到本地（JSON 默认输出格式）：

uv run python youtube_transcript_from_url.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --save

保存为指定路径和文本格式：

uv run python youtube_transcript_from_url.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --format txt --output ./subtitle.txt

额外功能

查询视频

通过视频 ID：

uv run python youtube_videos.py --video-ids dQw4w9WgXcQ

多个视频 ID：

uv run python youtube_videos.py --video-ids dQw4w9WgXcQ,9bZkp7q19f0

通过主题搜索视频列表并拉取数据：

uv run python youtube_videos.py --topic "AI tools" --max-results 20

主题搜索排序/地区：

uv run python youtube_videos.py --topic "data science" --max-results 30 --order viewCount --region-code US

输出原始 API 响应：

uv run python youtube_videos.py --video-ids dQw4w9WgXcQ --raw