youtube_search
Search YouTube videos by query and filter results by date, channel, duration, definition, order, or safe search, with pagination and automatic fallback when API quota runs out.
Instructions
Search with date/channel/duration filters — port of tube-bridge youtube_search.
Layer 1/2 (Data API, 100 units) → Layer 3 (yt-dlp, 0 units) on exhaustion.
Returns {query, source, total_results, next_page_token, videos[]}.
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": {
"query": "<query>"
},
"name": "youtube_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| order | No | ||
| query | Yes | ||
| channel_id | No | ||
| safe_search | No | ||
| video_duration | No | ||
| published_after | No | ||
| published_before | No | ||
| video_definition | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||