用途：该技能用于按关键词获取 YouTube 搜索结果，支持本地化与过滤、分页。
主要能力：接收必填的 search_query，可选 sp（过滤或分页令牌）、hl（语言）、gl（地区）；调用 Frevana 的 YouTube Search 端点，校验响应为 JSON 后原样返回，不做改写。
使用方式：依赖 curl、bash、python3，并需在环境变量中提供 FREVANA_TOKEN，或在单次运行时用 --token 覆盖。优先使用脚本而非临时 curl 命令。基本用法：bash <skill-path>/scripts/search_youtube.sh --search-query "mrbeast"；--query 是 --search-query 的别名。可加 --gl us --hl en 指定地区语言，加 --sp 传入过滤或分页令牌，用 --output ./out/youtube-search-result.json 保存结果。请求体仅含 search_query 及已提供的可选字段，不要自行编造 sp、hl、gl，也不要传入 engine、api_key、output、no_cache、async、zero_trace 等不支持的字段。
适用场景：需要按关键词检索 YouTube 视频、按国家或语言本地化结果、用 sp 令牌过滤或翻页，以及需要保存原始 JSON 时。
限制：缺少 search_query 无法运行；非交互或智能体流程中若缺少令牌会快速失败，需设置 FREVANA_TOKEN 或显式传 --token；缺少 curl 或 python3 需先安装；不要回显 Bearer 令牌；除非用户要求完整数据，否则应汇总相关视频而非直接输出原始 JSON。