youtube_search_videos
按搜索词搜索 YouTube 公开视频,只返回视频结果。用户需要按搜索词查找视频时使用;已有视频、Shorts 或 youtu.be 链接时使用视频详情或评论工具;已有频道主页链接时使用频道资料或频道发布视频工具;不支持播放列表链接作为搜索输入;支持筛选和 page_token 翻页。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keyword": "<keyword>"
},
"name": "youtube_search_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | YouTube 视频搜索词,可传关键词或短语,例如品牌名、话题、人物名或内容需求;不要传 YouTube 视频链接、Shorts 链接、频道链接、播放列表链接、video_id 或 page_token。 | |
| sort_type | No | 排序方式:general=相关性,time_descending=最新上传,view_count_descending=观看次数最多,rating=评分较高。如无明确排序需求,保持 general。 | general |
| page_token | No | YouTube 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回;page_token 是不透明分页令牌;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。只能用于同一关键词、排序和筛选链路;更换关键词、排序、视频类型、发布时间或时长筛选时,请清空 page_token 后从第一页重新搜索。 | |
| video_type | No | 视频类型筛选:all=不限类型,video=普通视频,movie=电影。all 会保留视频类搜索结果,输出项用 video_type 标记可明确识别的类型。可明确识别的 Shorts 会标为 short,其余视频结果标为 video。当前不支持 channel、short 或 playlist 作为筛选项;频道信息只作为视频作者信息返回。movie 是筛选条件,返回项使用同一搜索结果字段,并以 video_type=movie 标记。如无明确类型需求,保持 all。 | all |
| duration_range | No | 视频时长筛选:all=不限,under_4_min=4 分钟以内,between_4_and_20_min=4 到 20 分钟,over_20_min=20 分钟以上。只对视频类搜索结果有意义;如无明确时长需求,保持 all。 | all |
| publish_time_range | No | 发布时间筛选:all=不限,last_hour=过去 1 小时,today=今天,this_week=本周,this_month=本月,this_year=今年。如无明确发布时间需求,保持 all。 | all |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 当前页 YouTube 搜索结果列表;当前页可能为空,是否可继续翻页以 next_page_token 是否为空为准。 | |
| points | Yes | 本次成功调用的积分消耗与账户积分余额。 | |
| next_page_token | Yes | 下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回;只用于当前 YouTube 搜索续页;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。 |