Субтитры YouTube / YouTube transcripts
yt_srtВозвращает текст ролика YouTube по ссылке: субтитры (ручные или автоматические) с таймкодами, окном from/to и лимитом символов. До 5 роликов за вызов, как map/crawl - текстом, а не JSON.
Когда: нужен текст, конспект или цитата из видео - «о чём ролик», «что сказали на 12-й минуте», «найди в лекции кусок про X». Тогда transcript приходит в контекст целиком: видео не скачивается, распознавание речи идёт не на вашей стороне. Когда не: нужен факт из ролика - verify_claim (проверяет утверждение по источникам); нужен текст статьи - read_url. Язык: languages - порядок приоритета (по умолчанию ru, en). Если ни одного из языков нет, пробуем автоматические субтитры. Ролик без субтитров вообще не читается: он не тарифицируется. Окно: from/to в СЕКУНДАХ от начала ролика - так берут узкий кусок длинной лекции вместо всего текста. maxChars ограничивает объём (от 200 до 200000); обрезка помечена в шапке. Возвращает: на каждый ролик - шапку (название, канал, длительность, язык и источник manual/auto, окно, число сегментов и символов) и текст; с timestamps: true каждая реплика начинается с [mm:ss] (для роликов от часа - [h:mm:ss]). Нечитаемые ролики идут блоками с кодом ошибки и не роняют остальные: частичный успех - норма. Цена: 15 кредитов за каждый успешно отданный ролик. Ролик без субтитров, приватный или прямой эфир не тарифицируется.
Returns the transcript of a YouTube video by link: subtitles (manual or automatic) with timecodes, a from/to window and a character limit. Up to 5 videos per call, as text, not JSON.
Use when: you need the text, summary or quote of a video - "what is this video about", "what was said at minute 12", "find the part about X". The transcript arrives in your context as-is: no video download, no speech recognition on your side. Do not use when: you need to check a fact from the video - verify_claim (it verifies a claim against sources); you need the text of an article - read_url. Language: languages is a priority list (default ru, en). If none of the requested languages exist, automatic subtitles are tried. A video with no subtitles at all cannot be read and is not charged. Window: from/to in SECONDS from the start - this is how a narrow slice of a long lecture is taken instead of the whole text. maxChars caps the volume (200 to 200000); a cut transcript is marked in the header. Returns: for each video - a header (title, channel, duration, language and manual/auto source, window, segment and character counts) and the text; with timestamps: true every line starts with [mm:ss] ([h:mm:ss] for videos of an hour or more). Unreadable videos come as blocks with an error code and do not break the rest: partial success is normal. Cost: 15 credits per transcript actually returned. A video with no subtitles, a private one or a live stream is not charged.
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": {
"videos": "<videos>"
},
"name": "yt_srt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Конец окна, СЕКУНДЫ (до этой секунды). Должен быть больше from. / Window end, SECONDS (exclusive). Must be greater than from. | |
| from | No | Начало окна, СЕКУНДЫ от начала ролика (по умолчанию 0). Для куска лекции укажите и from, и to. / Window start, SECONDS from the video start (default 0). For a slice of a lecture pass both from and to. | |
| videos | Yes | Ссылки на ролики YouTube (1-5): https://youtu.be/ID или https://www.youtube.com/watch?v=ID. Дубликаты отбрасываются. / YouTube video links (1-5): https://youtu.be/ID or https://www.youtube.com/watch?v=ID. Duplicates are dropped. | |
| maxChars | No | Сколько символов текста на ролик (200-200000, по умолчанию 200000). Обрезанный текст помечен в шапке; продолжение берите окном from/to, а не offset - у субтитров окно по времени. / Characters of text per video (200-200000, default 200000). A cut transcript is marked in the header; continue with a from/to window, not an offset - subtitles are windowed by time. | |
| languages | No | Языки субтитров в порядке приоритета (1-5, по умолчанию ru, en). Код вида ru, en, de; регистр и регион не важны (ru-RU станет ru). / Subtitle languages in priority order (1-5, default ru, en). Codes like ru, en, de; case and region do not matter (ru-RU becomes ru). | |
| timestamps | No | true - каждая реплика начинается с таймкода [mm:ss] (для роликов от часа [h:mm:ss]). По умолчанию false: сплошной текст, он короче и дешевле по токенам. / true - every line starts with [mm:ss] ([h:mm:ss] for videos of an hour or more). Default false: plain text, shorter and cheaper in tokens. |