用途
该技能用于抓取 YouTube 热门视频（Trending）数据，通过 Apify 平台上的 apidojo YouTube Trending Scraper 执行。它是一个原始数据采集工具，不预设具体使用场景，返回完整数据集供后续分析使用。当用户希望获取热门视频列表时触发。
主要能力
- 按热门类别抓取：通过 type 参数指定，可选值为 n（now，即当前热门）、music、movies、gaming。
- 按国家与语言筛选：gl 参数指定国家代码（如 us、gb），hl 参数指定语言代码（如 en）。
- 限制返回数量：maxItems 参数控制最多返回的视频数，默认不限制。
- 数据转换：customMapFunction 可传入 JavaScript 函数，对每个输出对象进行转换。
- 输出多种格式：支持表格、CSV、JSON 等输出形式。
输入参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| type | string | 可选 | n | 热门类别：n（now）、music、movies、gaming |
| gl | string | 可选 | us | 国家代码（如 US、GB） |
| hl | string | 可选 | en | 语言代码（如 en） |
| maxItems | number | 可选 | 无限制 | 最多返回的视频数量 |
| customMapFunction | string | 可选 | — | 用于转换每个输出对象的 JavaScript 函数 |
使用方式
使用 run_actor.js（推荐）
快速回答（表格）：
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'
保存为 CSV：
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.csv --format csv
保存为 JSON：
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.json --format json
REST API 备用方式
curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-trending-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'
使用 Apify MCP
如果 Apify MCP 可用，使用 Apify MCP 的 call_actor 工具，actor 为 apidojo~youtube-trending-scraper，并传入上述输入。
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| type | string | 固定为 video |
| id | string | 视频 ID |
| title | string | 视频标题 |
| url | string | 视频 URL |
| description | string | 视频描述 |
| duration | number | 时长（秒） |
| views | number | 播放量 |
| likes | number | 点赞数 |
| status | string | 可用状态 |
| channel.id | string | 频道 ID |
| channel.name | string | 频道名称 |
| channel.url | string | 频道 URL |
| keywords | array | 视频标签/关键词 |
| isLive | boolean | 是否直播 |
| thumbnails | array | 缩略图对象 |
适用场景
- 需要按地区、类别获取 YouTube 热门视频的原始数据，用于后续分析。
- 将结果导出为 CSV 或 JSON 以便进一步处理。
- 在支持 Apify MCP 的环境中，通过 MCP 工具直接调用。
限制与边界情况
- 类别无结果：部分国家可能没有全部类别页面，可回退到 type=n。
- 结果为空：YouTube 可能因会话不同而显示不同的热门内容，建议重试。
- 地区不匹配：gl 和 hl 必须是有效的 ISO 代码。
- 数据新鲜度：热门内容变化频繁，数据仅代表某一时间点的快照。
暂未提供的信息
该资料未提供价格、收费方式、具体平台兼容性清单、性能指标或效果保证等信息。