ytdlp__search_videos
Search YouTube videos by keyword using yt-dlp, with options for result count, pagination, upload date filtering, and output as summary or JSON.
Instructions
Search YouTube videos by keyword using yt-dlp and return results as summary or JSON. @remarks Uses ytsearch to query YouTube; supports pagination via offset and date filtering. @param query Search keywords (must not contain newlines). @param maxResults Number of results to return (1-50, default 10). @param offset Pagination offset (default 0). @param response_format Output format: "summary" (default) or "json". @param uploadDateFilter Filter by upload date: "today", "week", "month", or "year". @param cookies Optional path to a Netscape-format cookies file. @param proxy Optional proxy address (e.g. socks5://127.0.0.1:1080). @param maxRetries Optional retry count after failures, capped at 2 (default: 2). @param __mcp_response_mode Optional response mode: content (default) or structuredContent.
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": "ytdlp__search_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| proxy | No | ||
| query | Yes | ||
| offset | No | ||
| cookies | No | ||
| maxResults | No | ||
| maxRetries | No | ||
| response_format | No | ||
| uploadDateFilter | No | ||
| __mcp_response_mode | No | content |