Scraping Youtube Playlist 是一个用于从 YouTube 播放列表提取视频数据的技能，底层使用 apidojo 提供的 YouTube Playlist Scraper（托管在 Apify 平台）。其定位是原始数据采集，不预设具体使用场景，直接返回完整数据集供下游分析。
主要能力：从指定的 YouTube 播放列表 URL 中提取全部视频；也可通过搜索关键词查找播放列表。支持对输出结果进行自定义转换。
输入参数：startUrls（数组，可选，默认空，YouTube 播放列表 URL）；keywords（数组，可选，默认空，用于查找播放列表的搜索关键词）；gl（字符串，可选，默认 us，国家代码）；hl（字符串，可选，默认 en，语言代码）；sort（字符串，可选，默认 r，排序顺序）；maxItems（数字，可选，默认无限制，返回视频的最大数量）；customMapFunction（字符串，可选，用于转换每个输出对象的 JavaScript 函数）。
使用方式：推荐通过 run_actor.js 脚本运行，例如 node scripts/run_actor.js --actor "apidojo~youtube-playlist-scraper" --input '{"startUrls": ["https://www.youtube.com/playlist?list=PLABCDE12345"], "maxItems": 50}'；可通过 --output 与 --format 参数保存为 CSV 或 JSON。也可使用 REST API：向 https://api.apify.com/v2/acts/apidojo~youtube-playlist-scraper/runs 发送 POST 请求，携带 Authorization Bearer 令牌与 JSON 输入。若 Apify MCP 可用，可使用 Apify MCP 的 call_actor 工具调用 actor apidojo~youtube-playlist-scraper。
输出字段：type（固定为 video）、id（视频 ID）、title（标题）、url（视频 URL）、description（描述）、duration（时长，秒）、views（观看数）、likes（点赞数）、status（可用状态）、channel.id（频道 ID）、channel.name（频道名称）、channel.url（频道 URL）、keywords（视频标签/关键词数组）、isLive（是否直播）、isPrivate（是否私密）、thumbnails（缩略图对象数组）。
适用场景：需要批量获取播放列表视频元数据、用于后续数据分析或整理时。
限制与边界情况：私密播放列表返回 0 结果，应告知用户该播放列表为私密；已删除播放列表返回错误或空结果，需检查 URL；超大播放列表应使用 maxItems 限制返回数量，避免运行时间过长；YouTube 自动生成的 Mix 播放列表行为可能与用户创建的播放列表不同。收费、价格、平台等更多事实暂未提供。