YouTube video transcript
youtube_transcriptGet what is said in a YouTube video: its transcript in any language the video has captions in (human-made captions before auto-generated ones), with its title, channel, length, the language returned and every available language. format=text (default) gives the plain text; format=segments gives timed lines with start and duration in seconds. A very long transcript is cut at a line to keep the answer small, and the answer then names the start_seconds to call again with to read on. Videos without captions have no transcript.
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": {
"url": "<url>"
},
"name": "youtube_transcript"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | A YouTube video link (watch, youtu.be, Shorts, live or embed link) or its 11-character id (_T8cn2J13-4). | |
| lang | No | A language code (en, es, pt-BR, zh-Hans). Leave it out for the default captions, usually the spoken language. Without captions in that language, the default ones are returned. | |
| format | No | text: the plain transcript. segments: timed lines (start and duration in seconds). | text |
| start_seconds | No | Read from this point of the video, in seconds. Used to continue a transcript that was cut. |