Субтитры YouTube / YouTube transcripts
yt_srtЗабирает текстовую дорожку ролика YouTube - ручные субтитры или авто - по ссылке или 11-символьному id. Видео и звук не скачиваются: это дешёвый способ получить содержание ролика в контекст агента.
Когда: нужен текст видео - конспект, цитата, проверка сказанного, поиск по содержанию лекции; ролик уже известен или найден через web_search. Для поиска видео используйте web_search (например, site:youtube.com), а не этот тул. Когда не: нужен текст страницы - read_url; нужна картинка/вёрстка - fetch_page; не YouTube (VK, Rutube, Дзен) - не работает. Плейлист не разбирается, нужен ролик. Возвращает по каждому ролику: название, канал, длительность, дату, язык, вид дорожки (ручные/авто), текст и ссылки на ролик и канал. Если дорожки нет - статус и список доступных языков: повторите с существующим. Длинный текст приходит окном maxChars; в конце указано from, с которым надо вызвать тул, чтобы получить продолжение без повторной оплаты. Цена: 1 кредит за ролик, у которого субтитры получены; неудачи (нет дорожки, ограничение частоты, недоступный ролик) не списываются. До 5 роликов за вызов.
Fetches a YouTube video's text track - manual captions or auto - by URL or 11-char id. No video or audio is downloaded: this is the cheap way to bring video content into the agent's context.
Use when: you need the text of a video - a summary, a quote, checking what was said, searching a lecture; the video is known or was found via web_search. To find videos use web_search (e.g. site:youtube.com), not this tool. Do not use when: you need page text - read_url; you need layout or a screenshot - fetch_page; the video is not on YouTube. Playlists are not expanded, pass a video. Returns per video: title, channel, duration, date, language, track kind (manual/auto), the text and links to the video and channel. If no track exists - a status plus the list of available languages, so you can retry with a real one. Long text arrives in windows of maxChars; the end states the from value for the continuation call, already-read text is not charged again. Cost: 1 credit per video whose captions were fetched; failures (no track, rate limiting, unavailable video) are not charged. Up to 5 videos per call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Конец окна в секундах. / Window end in seconds. | |
| from | No | Начало окна в секундах (для продолжения используйте next_from из ответа). / Window start in seconds (use next_from from the response for continuation). | |
| videos | Yes | Ссылки на ролики YouTube или их id (до 5 за вызов). Формы: watch?v=, youtu.be/, shorts, embed, live, голый 11-символьный id. / YouTube video URLs or ids (up to 5 per call). | |
| maxChars | No | Сколько символов текста вернуть на ролик (200-50000, по умолчанию 12000). / Characters of text per video (200-50000, default 12000). | |
| languages | No | Языки в порядке предпочтения, по умолчанию ["ru", "en"]. Ручная дорожка предпочтительнее авто. Если нужного языка нет - вернём доступные. / Languages in preference order, default ["ru", "en"]. Manual tracks are preferred over auto; if the requested one is missing, available ones are returned. | |
| timestamps | No | true - вернуть фрагменты с таймкодами вместо сплошного текста (дороже по контексту; для навигации по длинному ролику). / true - return timestamped fragments instead of continuous text. |