Search inside a YouTube channel
youtube_channel_search_listSearch one YouTube channel by handle for videos, Shorts, live streams, and playlists matching a keyword, so you can locate relevant content within that channel.
Instructions
Search one YouTube channel's videos, Shorts, live streams and playlists by keyword (for all of YouTube, use youtube_search_list). Requires handle and query. Returns a list (use cursor when paginated).
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": {
"handle": "<handle>",
"query": "<query>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "youtube_channel_search_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Required. Text to search for in the channel's uploads. | |
| cursor | No | Opaque pagination cursor returned by a previous response. | |
| handle | Yes | Required. YouTube channel handle to search inside, with or without a leading @. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |