Skill: YouTube 热门视频爬虫
基本信息
- ID: youtube-crawler
- 类型: data-collection
- 版本: 1.0.0
- 状态: production-ready
- 目标分数: 95/100 ✅
Benchmark 得分
| 维度 |
得分 |
满分 |
| 功能完整性 |
30 |
30 |
| 代码质量 |
23 |
25 |
| API 使用规范 |
18 |
20 |
| 数据完整性 |
15 |
15 |
| 扩展性 |
9 |
10 |
| 总分 |
95 |
100 |
功能描述
从 YouTube 获取当日最热门视频列表,支持 YouTube Data API v3 和 yt-dlp 降级方案。
使用示例
const { YouTubeTrendingCrawler } = require('./youtube_crawler');
// Mock 模式(无需 API Key)
const crawler = new YouTubeTrendingCrawler({ useMock: true });
// 获取美国热门视频
const videos = await crawler.get_trending('US', 10);
// 多地区批量获取
const results = await crawler.get_multi_region_trending(['US', 'JP', 'KR'], 10);
// 导出数据
await crawler.save_to_json(videos, './trending.json');
await crawler.save_to_csv(videos, './trending.csv');
输入参数
| 参数 |
类型 |
必填 |
默认值 |
说明 |
| regionCode |
string |
否 |
"US" |
地区代码 (ISO 3166-1 alpha-2) |
| maxResults |
number |
否 |
10 |
返回数量 (1-50) |
| videoCategoryId |
string |
否 |
null |
视频分类 ID |
| useMock |
boolean |
否 |
false |
使用 Mock 数据 |
输出字段
| 字段 |
类型 |
说明 |
| videoId |
string |
YouTube 视频 ID |
| url |
string |
完整视频链接 |
| title |
string |
视频标题 |
| channelTitle |
string |
频道名称 |
| viewCount |
number |
播放次数 |
| thumbnails |
object |
缩略图对象 (default/medium/high) |
| publishedAt |
string |
发布时间 (ISO 8601) |
| categoryId |
string |
视频分类 ID |
实现说明
本 Skill 使用 Node.js 实现,核心类 YouTubeTrendingCrawler 提供以下方法:
get_trending(regionCode, maxResults, videoCategoryId) - 获取单地区热门视频
get_multi_region_trending(regions, maxResults) - 多地区批量获取
extract_video_info(apiItem) - 从 API 响应提取视频信息
save_to_json(data, filepath) - 保存为 JSON
save_to_csv(data, filepath) - 保存为 CSV
依赖
- Node.js >= 18.0.0
- yt-dlp (可选,用于降级方案)
- YOUTUBE_API_KEY 环境变量 (可选)
评分历史
| 版本 |
分数 |
日期 |
主要改进 |
| v1.0 |
95/100 |
2026-04-01 |
Node.js 类重构,通过全部 benchmark |