用途：在指定细分领域内查找近期表现强劲的 YouTube 视频，作为起号选题、结构参考和钩子参考。不以低订阅数为默认逻辑。
主要能力：把用户领域转成查询簇，调用 YouTube search.list（type=video、order=viewCount、publishedAfter）搜索，跨查询去重视频 id，再通过 videos.list 补充统计与元数据、channels.list 补充公开订阅数。仅按爆款强度过滤：view_count >= --min-views；仅当用户设置 --min-engagement 时，才用 like_count + comment_count * 2 >= --min-engagement。排序依次为 viral_score、view_count、like_view_rate。输出 JSON 供自动化，或 Markdown 供人工选题。
使用方式：在技能目录运行 python3 scripts/search_youtube_viral_topic.py --topic "AI agent,Claude Code" --days 30 --min-views 10000 --limit 50 --format markdown。实时 API 调用需设置 export YOUTUBE_API_KEY="..."，也可用 --api-key 单次传入。不要把 API 密钥写入技能文件或输出产物。修改阈值或与其他平台合并前，先阅读 references/scoring.md。
输出契约：每条结果保留来源 URL、视频指标和可选频道上下文，字段包括 platform、content_id、url、title、author_id、author_name、subscriber_count、published_at、view_count、like_count、comment_count、hot_score、viral_score、evidence。跨平台表格中 follower_count 在可用时填入 YouTube 频道订阅数，但不作为默认过滤条件。
限制与注意：不要把默认输出称为“低粉”或“低订阅”结果；subscriberCount 是公开的取整或缩写数据，仅作上下文；若 hiddenSubscriberCount 为 true 或订阅数缺失，只要通过爆款过滤仍保留该视频；优先用 API 采集而非浏览器抓取，仅在用户明确要求时使用浏览器会话；视频仅作选题信号、结构参考和钩子参考，不要整段复制脚本或字幕。