用途:分析某个 YouTube 频道在指定时间范围内播放量最高的视频,输出标题、链接、播放量、点赞、评论、时长和发布日期,并给出频道整体统计(视频数、总播放量、平均播放量)。
主要能力:调用 Apify 的 YouTube Scraper(actor id 为 streamers~youtube-scraper)抓取频道视频,脚本在本地完成时间窗口过滤和按播放量降序排序,只请求普通视频(shorts 和直播设为 0)。支持 --json-output 输出机器可读 JSON,便于进一步分析。
使用方式:需先注册 Apify 账号并获取 Token,设置为环境变量 APIFY_API_KEY(macOS/Linux 用 export APIFY_API_KEY="your_token_here",Windows PowerShell 用 $env:APIFY_API_KEY="your_token_here")。脚本依赖 requests 库,缺失时用 pip install requests --break-system-packages 安装。将脚本保存为 fetch_top_hits.py 后运行:python fetch_top_hits.py "<channel_url>" --years 2 --top 5 --max-results 200。参数包括 channel_url(必填)、--years(默认 2,支持小数)、--top(默认 5)、--max-results(默认 200)、--json-output。
适用场景:需要快速了解某频道近期爆款内容、做内容选题参考或频道表现概览时使用。
限制:需要用户自备 Apify Token,无共享或内置密钥;调用为按结果计费的付费 API,费用从用户自己的 Apify 额度扣除,建议控制 --max-results 以控制花费。脚本会向 api.apify.com 发起外部 HTTP 请求,在限制外网访问的沙箱环境中无法运行。Apify 免费额度有限,actor 运行可能失败或超时。频道 URL 需为公开频道,部分格式需先规范化(如去掉 /videos 后缀)。