# YouTube Trending Crawler Benchmark v2.0 **版本**: v2.0 **更新日期**: 2026-04-04 **任务编号**: T-mnj3nimu --- ## 1. 评分维度 | 维度 | 权重 | 说明 | |------|------|------| | API 调用准确性 | 25% | API 端点、参数、认证正确性 | | 数据字段完整性 | 20% | 输出字段覆盖度 | | 多地区/多分类支持 | 15% | 地区代码、分类 ID 支持 | | 错误处理健壮性 | 15% | 错误检测、降级方案 | | 输出格式正确性 | 15% | JSON 格式规范性 | | 配额管理合理性 | 10% | 配额成本控制 | --- ## 2. 评分标准 ### 2.1 API 调用准确性 (权重 25%) | 分数 | 标准 | |------|------| | 90-100 | 正确调用 `videos?chart=mostPopular`,参数完全正确,包含必需的 part/chart 参数 | | 70-89 | API 端点正确,参数基本完整,小遗漏 | | 50-69 | 端点或参数有明显错误,但能返回数据 | | 0-49 | 端点错误或参数完全错误,无法获取数据 | **检查项**: - [ ] 使用 `videos` 端点 (非 search) - [ ] `chart=mostPopular` 参数存在 - [ ] `part=snippet,statistics` 或包含 contentDetails ### 2.2 数据字段完整性 (权重 20%) | 分数 | 标准 | |------|------| | 90-100 | 包含全部 17 个目标字段 | | 70-89 | 包含 12-16 个字段 | | 50-69 | 包含 8-11 个字段 | | 0-49 | 字段严重缺失 (<8 个) | **目标字段**: `videoId`, `title`, `channelTitle`, `channelId`, `subscriberCount`, `viewCount`, `likeCount`, `commentCount`, `publishedAt`, `description`, `url`, `thumbnail`, `categoryId`, `categoryName`, `tags`, `duration`, `crawlTime`, `regionCode` ### 2.3 多地区/多分类支持 (权重 15%) | 分数 | 标准 | |------|------| | 90-100 | 支持 ≥5 个地区代码和 ≥5 个分类 ID | | 70-89 | 支持 3-4 个地区,支持 3-4 个分类 | | 50-69 | 支持 1-2 个地区或分类 | | 0-49 | 不支持多地区或多分类 | **检查项**: - [ ] 支持 ISO 3166-1 alpha-2 地区代码 (US, JP, KR, GB, DE, FR, IN, BR) - [ ] 支持视频分类 ID (1-44) ### 2.4 错误处理健壮性 (权重 15%) | 分数 | 标准 | |------|------| | 90-100 | 完整错误处理 + yt-dlp 降级方案 | | 70-89 | 错误处理完整,无降级 | | 50-69 | 基础错误处理 | | 0-49 | 无错误处理 | **检查项**: - [ ] 403 处理 (配额耗尽) - [ ] 404 处理 (视频不存在) - [ ] 500 错误重试 - [ ] yt-dlp 降级方案 ### 2.5 输出格式正确性 (权重 15%) | 分数 | 标准 | |------|------| | 90-100 | JSON 完全符合规范,含必要元数据 | | 70-89 | JSON 格式正确,轻微问题 | | 50-69 | JSON 可解析但有问题 | | 0-49 | JSON 格式错误无法解析 | **检查项**: - [ ] 有效 JSON (可 JSON.parse) - [ ] 包含 `regionCode` 字段 - [ ] 时间格式符合 ISO 8601 - [ ] URL 格式正确 ### 2.6 配额管理合理性 (权重 10%) | 分数 | 标准 | |------|------| | 90-100 | 优先使用 videos(1 unit) + 批量合并请求 | | 70-89 | 只使用 videos 端点 | | 50-69 | 混用 search 端点但控制频率 | | 0-49 | 大量使用 search 端点 (100 unit/次) | --- ## 3. 通过阈值 | 等级 | 分数 | |------|------| | 优秀 | ≥ 90 | | 良好 | ≥ 75 | | 及格 | ≥ 60 | | 不及格 | < 60 | --- ## 4. 测试用例 ### 4.1 基础功能测试 ``` 输入: regionCode=US, maxResults=10 期望: 返回 10 条热门视频,包含 viewCount, likeCount, commentCount ``` ### 4.2 多地区测试 ``` 输入: regionCode=JP, videoCategoryId=10 期望: 返回日本地区音乐分类热门视频 ``` ### 4.3 错误处理测试 ``` 输入: API Key 无效 期望: 返回错误信息,或启用 yt-dlp 降级 ``` ### 4.4 配额测试 ``` 输入: 批量请求多个地区 期望: 使用 videos 端点 (1 unit),非 search (100 unit) ``` --- ## 5. 检查清单 - [ ] API 端点使用 `videos?chart=mostPopular` - [ ] 必需参数: part, chart, maxResults - [ ] 输出包含至少 12 个字段 - [ ] 支持多地区代码 - [ ] 支持视频分类过滤 - [ ] 错误处理: 403, 404, 500 - [ ] 降级方案: yt-dlp - [ ] JSON 格式正确 - [ ] 配额成本优化