yt-fts CLI

Установка

npx skillfoxx add cli/yt-fts

Что делает

`yt-fts` — программа командной строки на Python, которая собирает субтитры YouTube и делает по ним поиск. Команда `download` принимает адрес канала или плейлиста (ключ `--playlist`), скачивает субтитры через `yt-dlp` в несколько потоков (по умолчанию 8, язык по умолчанию en, меняется ключом `--language`) и складывает их в локальную базу `SQLite`. Команда `update` дозагружает новые видео, `delete` удаляет канал со всеми данными после подтверждения, `export` выгружает расшифровки в файлы txt или vtt. Команда `search` ищет по тексту в сохраненных субтитрах: в одном канале, в одном видео или во всей базе. Строка запроса не длиннее 40 знаков, поддерживает операторы `AND` и `OR`, подстановки со звездочкой и префиксы из расширенного синтаксиса `SQLite`. Каждый результат выводится с адресом YouTube, который открывает видео на нужной секунде; результаты можно выгрузить в CSV ключом `--export`. Для смыслового поиска команда `embeddings` режет расшифровки каналов на отрезки (по умолчанию по 30 секунд) и получает векторы через API OpenAI или Gemini, а хранит их в `chromadb`. После этого работает `vsearch`: результаты упорядочены по близости к запросу. Команда `llm` открывает чат, где ответы строятся по найденным отрезкам, а при нехватке контекста запрос уточняется. `summarize` выдает краткое изложение видео по ссылке или идентификатору с таймкодами; если расшифровки нет в базе, команда пытается ее скачать. Вспомогательные команды: `list` показывает каналы, видео и текст расшифровки, `config` выводит пути к базам, `diagnose` проверяет соединение с YouTube.

Для кого. Для исследователей, маркетологов, редакторов и разработчиков, которым нужно искать цитаты и темы по всем выпускам канала или плейлиста и собирать корпус расшифровок для своих агентов и скриптов.

Пример запроса к агенту

Скачай субтитры канала 3Blue1Brown и найди все места, где он говорит про обратное распространение ошибки, со ссылками на секунды

Ограничения

• Лицензия Unlicense, передача в общественное достояние. В первых строках описания автор пишет, что проект заброшен и вернется к нему, только когда снова останется без работы, поэтому исправлений при изменениях на стороне YouTube ждать не стоит.
• Нужен Python 3.10 или новее. Версии зависимостей закреплены (`yt-dlp` 2025.6.30, openai 1.93.0, `chromadb` 1.0.15), а YouTube меняется, поэтому загрузка может выдавать ошибки 403. Для их разбора есть команда `diagnose` и файл docs/TROUBLESHOOTING_403.md.
• Команда `update` обновляет только полнотекстовый поиск, векторы для смыслового поиска она не пересчитывает. Их получают заново командой `embeddings`.
• Для `embeddings`, `vsearch`, `llm` и `summarize` нужен ключ OpenAI или Gemini, текст расшифровок уходит в эти сервисы, а API OpenAI из России недоступен. По умолчанию язык субтитров en, для других языков указывайте `--language`.
• Инструмент собирает данные с YouTube в большом объеме: применять его можно только к каналам и данным, на сбор и использование которых у вас есть разрешение и которые допускают правила площадки.

Как отключить. Удалите программу командой `pip uninstall yt-fts`. Данные остаются на диске: пути к базе `SQLite` и к хранилищу `chromadb` показывает `yt-fts config`, а канал со всеми расшифровками удаляет `yt-fts delete --channel`.

Коротко о README

В репозитории есть описание всех команд с ключами и примерами, журнал изменений, отдельный разбор ошибок 403 при загрузке и пакет тестов на pytest для загрузки, экспорта, обычного и смыслового поиска. Описание начинается с пометки о том, что проект заброшен, и со ссылок на запись в блоге автора, чат с моделью, краткие изложения и смысловой поиск.