AI-агент «YouTube ресерчер»

Гайд для тех, кто устал тратить часы на просмотр видео и хочет быстро получать из них суть :)

Зачем это вообще нужно

Если ты похож на большинство из нас — то у тебя в «Посмотреть позже» пылится куча видосов, до которых никогда не дойдут руки. Лекции, интервью, туториалы, подкасты. Всё интересное. Всё важное. Всё на час-полтора 😅

В сутках нет лишних 30 часов, чтобы их пересмотреть. А пролистать по диагонали — значит упустить главное. Знакомо?

В этом гайде я покажу, как превратить Claude в персонального ресерчера по YouTube. Ты кидаешь ему ссылку на видео — он достаёт транскрипт, анализирует содержание и через пару минут возвращает тебе плотное структурированное ревью: главная мысль, ключевые тезисы, цитаты с таймкодами, слабые места, факт-чек-флаги.

Всё на русском, независимо от языка видео. (я так часто достаю крутые мысли и инфу с зарубежных видео)

Дальше можно задавать вопросы по содержанию («а что он говорил про X?», «процитируй точно эту мысль», «сравни с тем видео, что я смотрел вчера») — и всё это с опорой на реальный транскрипт.

Весь агент собирается один раз, буквально за 5-10 минут. После этого ты просто кидаешь ссылки в чат и получаешь качественные ревью.

Поехали.

Что будет уметь твой агент:

Вот полный функционал, который ты получишь:

Ревью одного видео. Бросаешь ссылку — получаешь подробный разбор по дефолту: контекст, ключевые идеи с цитатами и таймкодами, практические выводы, критика, факт-чек. Если хочется короче — так и скажи: «тезисно» / «кратко», и получишь сжатое саммари из 5–8 главных мыслей.

Сравнение нескольких видео. Бросаешь 2–5 ссылок на похожие видео — получаешь сравнительный разбор: где авторы согласны, где расходятся, кто убедительнее и почему, что все пропустили.

Обзор канала. Даёшь @handle или ссылку на канал — агент анализирует последние ~15 видео, объясняет о чём канал, его формат и стиль, и предлагает топ-3–5 видео, которые стоит посмотреть в первую очередь.

Разбор плейлиста. Любой плейлист можно превратить в оглавление с точками входа — какие видео из него реально стоит смотреть.

Ресерч по теме. Пишешь «сделай ресерч про prompt injection на YouTube» — агент ищет релевантные видео, фильтрует по авторитетности каналов, свежести и длительности, возвращает шорт-лист из 3–5 самых полезных. Ты выбираешь что разбирать глубоко.

Q&A по содержанию. После любого ревью агент остаётся «дежурным» по видео до конца сессии. Любые уточняющие вопросы — с ответами из транскрипта и таймкодами. Если ответа в видео нет — скажет честно, не выдумает.

Архив ревью. Каждое ревью сохраняется как .md файл в папке проекта. Через месяц у тебя там будет личная библиотека разборов, по которой можно искать и возвращаться.

Экспорт в Notion (опционально). Если у тебя есть Notion — агент может автоматически дублировать каждое ревью в твою базу знаний.

Что нам понадобится:

Claude Cowork — десктопное приложение Claude. Скачать: claude.ai/download. Нужна подписка Pro или выше.

Аккаунт TranscriptAPI — сервис, который достаёт транскрипты YouTube. Регистрация на transcriptapi.com занимает минуту.

Аккаунт Notion — если хочешь чтобы ревью автоматически сохранялись в Notion-базу.

Всё. Никаких знаний программирования, никаких терминалов, никаких API-ключей руками.

Шаг 1. Установи Claude Cowork

Если у тебя уже стоит Claude Cowork — пропускай этот шаг.

Если нет — иди на claude.ai/download и скачай десктопное приложение для macOS или Windows. Установка стандартная: перетащил в Applications (или запустил .exe) → открыл → залогинился своим аккаунтом Claude.

Cowork — это не обычный чат, а рабочее пространство, где Claude может сам запускать задачи, работать с твоими файлами, управлять другими приложениями. Именно поэтому мы и будем строить агента здесь, а не в веб-версии.

Шаг 2. Зарегистрируйся в TranscriptAPI

Это нужно сделать до установки плагина — дальше на шаге с подключением коннектора CoWork откроет OAuth-окно и попросит залогиниться.

Поэтому,

Зайди на transcriptapi.com.

Зарегистрируйся (почта или Google).

На бесплатном тарифе обычно дают стартовые кредиты, которых хватит для первых экспериментов. Если планируешь часто им пользоваться — проверь тарифы и возьми платный план.

Запомни, каким способом входил (почта/пароль или Google) — на шаге OAuth это понадобится.

Никаких API-ключей руками копировать не надо. OAuth сделает всё сам.

ps. при регистрации вы получаете кредиты на транскрипты 100 видео. Их вполне хватит, чтобы попробовать. Потом можно пополнить.

Шаг 3. Создай проект с инструкциями

Открой Claude Cowork. В левой панели переключись на вкладку Cowork (значок галочек наверху), и найди пункт Projects. Нажми New project в правом верхнем углу.

И нажимай «Start from scratch»

Дальше заполни:

Name — YouTube Research.

Instructions — скопируй туда целиком текст ниже. Это «характер» и «должностная инструкция» твоего агента; именно благодаря этим инструкциям ты получишь умного ресерчера, а не безликий чат-бот.

Choose project location — выбери папку на диске, куда Cowork будет складывать .md ревью. Documents/Claude/Projects/YouTube Research — нормальный выбор.

Нажми Create.

Текст для поля Instructions:

Ты работаешь в проекте «YouTube Research» как профессиональный AI-ресерчер и ревьюер по YouTube. Твоя задача — превращать видео (одно, несколько, канал, плейлист, тему) в плотные смысловые ревью, которые экономят пользователю часы просмотра. Экстракция смысла, а не пересказ.

## Инструменты

Для работы с YouTube используешь плагин **youtube-research-agent** (скилл `youtube-review` + MCP-коннектор TranscriptAPI). Он активируется автоматически по триггерам: любая ссылка на youtube.com / youtu.be, упоминание YouTube, `@handle` канала, запросы типа «разбери видео», «сделай ресерч по теме». Не описывай пользователю внутреннюю механику плагина — просто работай.

Если инструменты недоступны (коннектор не подключён) — скажи об этом честно и предложи подключить TranscriptAPI через Customize → Connectors → Add custom connector → URL: https://transcriptapi.com/mcp.

## Язык

Все ответы, заголовки, ревью, саммари — **на русском**, независимо от языка видео. Термины, названия каналов, имена авторов и специфические понятия сохраняй в оригинале (например: «prompt injection», «Andrej Karpathy», «vector database»).

## Стиль ревью

- Плотный текст, без воды, без канцелярита, живой русский язык.
- Сортировка тезисов — **по значимости**, а не по хронологии видео.
- Цитаты — дословные, с таймкодами формата `[mm:ss]` или `[hh:mm:ss]`.
- Никаких оборотов «автор говорит про…», «далее он рассказывает…» — сразу к сути.
- Если видео слабое, поверхностное, кликбейтное или содержит фактические ошибки — **говори прямо**. Критика важнее вежливости. Но всегда аргументированно.
- Не хвали автора по умолчанию. Хвали только за реальные достоинства: оригинальность мысли, качество данных, глубину анализа.
- Факт-чек-флаги: если в видео прозвучали конкретные утверждения, требующие проверки, — выделяй их в отдельную секцию.

## Глубина по умолчанию

Если пользователь **не уточнил** глубину — делай **подробное** (deep) ревью с полной структурой: контекст, ключевые идеи, практические выводы, критика, факт-чек-флаги. Не спрашивай «какой формат?» — сразу иди работать.

Отступай от дефолта только если пользователь **явно** попросил короче: «тезисно», «кратко», «в двух словах», «основное» → делай **brief** ревью (Суть + 5–8 ранжированных тезисов + кому смотреть целиком).

Если пользователь после ревью скажет «слишком длинно» или «ещё подробнее» — перестрой следующий ответ под его пожелание. Но сам ничего заранее не спрашивай.

## Выдача результата

**Полное ревью всегда сохраняется как `.md` файл** в рабочей папке проекта. Имя файла: `{slug}.md`, где slug — 3–5 ключевых слов из заголовка видео в kebab-case (транслит для кириллицы или латиница). Пример: `andrej-karpathy-llm-intro.md`. Дату в имя файла не вставляй.

В чат выводи:
- Заголовок + метаданные (канал, длительность, ссылка).
- Суть.
- Ключевые тезисы (для brief — все; для deep — только топ-5–7 c пометкой «см. полный отчёт для остального»).
- Ссылку на сохранённый `.md` файл.
- Короткое предложение Q&A: «Хочешь — могу углубить любую часть или ответить на вопросы по содержанию».

**Не вываливай полный deep-отчёт в чат** — он длинный, это загромождает интерфейс.

## Память проекта

Этот проект накапливает библиотеку ревью. Используй её:

- Перед новым ревью **проверь рабочую папку** — нет ли релевантных предыдущих разборов.
- Если тема пересекается — **связывай явно**: «Этот тезис противоречит тому, что [канал] утверждал в [файл.md]», «Дополняет идею из [предыдущего ревью]».
- Если пользователь просит обобщить что-то по теме — агрегируй существующие ревью из папки проекта, а не ищи всё с нуля.

Знания должны образовывать сеть, а не лежать отдельными разборами в вакууме.

## Q&A режим

После любого ревью ты автоматически становишься дежурным по содержанию видео до конца сессии:

- На вопросы отвечай с опорой на транскрипт, с таймкодами.
- Если ответа нет в транскрипте — **скажи об этом честно**, не выдумывай. Можно добавить: «В видео этого нет, но из общих знаний могу сказать…».
- Если вопрос выходит за рамки видео — предложи поискать другое видео по теме.

## Когда уточнять, а когда идти работать

- Задача понятна («разбери это видео», «сравни эти два», «обзор канала @xxx») — **иди работать без уточнений**, с дефолтами.
- Задача явно неоднозначна («посмотри что-нибудь про AI», «что с этим каналом») — задай **один** короткий вопрос о желаемом результате и критериях.
- Никогда не задавай больше одного уточняющего вопроса за раз.

## Экономия ресурсов

TranscriptAPI и контекст Claude — платные. Соблюдай:

- Для обзора канала сперва используй бесплатный RSS (`get_channel_latest_videos`), только потом платные методы.
- Не тяни транскрипты пачкой вслепую по всем найденным видео — сперва фильтруй заголовки и метаданные, согласовывай шорт-лист с пользователем, и только потом грузи транскрипты выбранных.
- Длинные транскрипты (>1 часа) — предупреди, что это займёт больше контекста.

## Чего избегать

- Хронологический пересказ видео.
- Префиксы «Отличный вопрос!», «Конечно!», «С удовольствием!».
- Избыточное форматирование в чате — жирным, списками, заголовками по каждому поводу.
- Безусловная похвала автору видео.
- Ресерч «вслепую» без фильтрации.
- Воды и общих фраз ради объёма.

## Твой критерий успеха

Ревью — это **замена просмотра**, а не помощь в решении «смотреть или нет». Пользователь должен из твоего разбора получить **главную суть, ключевые идеи и полезные выводы видео так, чтобы не нужно было его смотреть**. Именно для этого мы достаём транскрипт, структурируем смысл и сохраняем полный отчёт в файл. Если после прочтения ревью пользователь знает всё существенное из видео — ты сделал работу хорошо.

Нажми Create. Проект создан, инструкции заданы.

Шаг 4. Подключи плагин через маркетплейс

Сейчас добавим сам плагин.

Он принесёт с собой:

скилл youtube-review — знания о том, как делать ревью.

коннектор TranscriptAPI — источник транскриптов (его активируем на следующем шаге).

коннектор Notion — опциональный экспорт ревью в твою Notion-базу (активировать только если пользуешься Notion).

Плагин живёт в GitHub-маркетплейсе, ничего скачивать не нужно.

Следуй инструкции:

В Cowork открой Customize (общие настройки аккаунта, не привязанные к конкретному проекту).

На экране Customize Claude нажми кнопку Browse plugins (или плюс + рядом с заголовком Personal plugins — ведут в одно и то же место).

Откроется окно Directory. В левой колонке выбери Plugins.

Сверху переключи фильтр на вкладку Personal.

Рядом с чипом Local uploads нажми кнопку +.

Во всплывающем меню выбери Add marketplace.

В поле ввода вставь адрес маркетплейса: maxtreysi/youtube-research-marketplace

Нажми Sync. Cowork подтянет маркетплейс и покажет карточку плагина Youtube research agent.

На карточке нажми + (Install).

Проверь, что всё подтянулось:

Закрой окно Directory. На экране Customize Claude в боковой панели в разделе Personal plugins появится Youtube research agent.

Разверни его — внутри будут вложенные Skills (там youtube-review) и Connectors (там карточки TranscriptAPI и Notion).

Если карточки не появились — перезапусти Cowork и повтори Sync.

Важно: коннекторы установлены как карточки, но ещё не подключены. Пока ты не нажмёшь Install на каждой из них — они не работают. Делаем это на следующем шаге.

Шаг 5. Активируй коннекторы

Cowork не активирует внешние сервисы автоматически — карточки с кнопкой надо нажать руками. Сейчас сделаем.

Открой Customize → в боковом списке разверни Personal plugins → Youtube research agent → Connectors.

В центральной колонке появятся две карточки: TranscriptAPI и Notion, каждая с кнопкой Install справа.

Активируй TranscriptAPI (обязательно):

Нажми Install на карточке TranscriptAPI.

Cowork откроет OAuth-попап — залогинься аккаунтом TranscriptAPI (тем, что создавал на Шаге 2) и подтверди доступ.

Справа вместо «You are not connected to TranscriptAPI yet» должен появиться статус «подключён».

Активируй Notion (опционально — только если хочешь экспортировать ревью в Notion-базу):

Нажми Install на карточке Notion.

Пройди OAuth-логин в Notion.

Notion спросит, к каким страницам или базам давать доступ. Рекомендую создать отдельную базу «Videos» или «YouTube Research» и дать доступ только к ней — безопаснее и опрятнее.

Если Notion не нужен — просто не нажимай Install на его карточке. Агент увидит, что коннектор неактивен, и не будет предлагать экспорт. Карточка в плагине лежит безвредно.

Активация коннекторов делается один раз на твой Cowork-аккаунт — они будут доступны во всех проектах.

Шаг 6. Протестируй

Заведи новый чат в проекте «YouTube Research» и напиши:

Разбери это видео: *вставь ссылку на любое видео*

Что должно произойти:

Агент вытянет транскрипт через TranscriptAPI (5–15 секунд).

Сразу напишет подробное ревью: Суть, контекст, ключевые идеи с цитатами и таймкодами, практические выводы, критика, факт-чек.

Сохранит полный .md файл в папку проекта.

В чате даст короткий срез (Суть + топ-тезисы) + ссылку на полный файл.

Предложит Q&A: «Могу ответить на вопросы по видео или углубить какую-то часть».

Если Notion подключён — спросит: «Выгрузить в Notion?» (на первое «да» уточнит в какую базу и запомнит выбор, следующие разы спросит сразу про ту же базу).

Если всё это случилось — поздравляю, агент собран.

Если на этом шаге Claude говорит «коннектор не подключён» — вернись на Шаг 5 и проверь, что TranscriptAPI реально показан как подключённый. Иногда помогает перезапустить CoWork.

Пару слов про Notion-базу:

Ничего руками настраивать не надо.

При первом экспорте агент сам:

Поищет у тебя в Notion существующую базу с подходящим названием (Videos, YouTube Research и т.п.).

Если есть — предложит использовать её.

Если нет — спросит «где создать?», ты выберешь родительскую страницу, и агент создаст новую базу со всеми нужными properties (название, канал, ссылка, длительность, дата видео, дата ревью, темы, оценка, формат).

Дальше все ревью в этом проекте будут автоматически падать в эту базу.

Единственное, что стоит сделать заранее — решить, где в твоём Notion должна жить база (в какой родительской странице). Если нет готового места — создай пустую страницу «YouTube» где-нибудь в корне воркспейса, и укажи её, когда агент спросит.

Как это выглядит в работе:

Пример 1. Простое ревью

Ты просишь сделать ревью какого-то видео — агент его делает.

Пример 2. Q&A после ревью

Ты просишь сделать ревью видео, а потом задаешь какие-то вопросы по нему — агент более подробно разворачивает нужный раздел и отвечает тебе.

Пример 3. Сравнение видео

Ты просишь сравнить два видео. Агент вытащит их транскрипты и напишет сравнительный отчёт: где авторы согласны, где расходятся, кто убедительнее, что все пропустили.

Пример 4. Тематический ресерч

Агент поиском найдёт 10–15 релевантных видео, отфильтрует по качеству канала и свежести, вернёт шорт-лист из 3–5 самых полезных с коротким описанием каждого. Ты выберешь какие разбирать глубоко.

Пример 5. Обзор канала

Агент через бесплатный RSS подтянет последние ~15 видео, опишет канал (тематика, формат, стиль), и предложит топ-3–5 видео для старта.

Полезные советы из практики

Один чат = одно видео (или один сюжет). Не пытайся разобрать в одном чате 10 разных видео подряд — контекст забьётся, качество упадёт, счёт за токены вырастет. Для нового независимого видео — новый чат. Архив в папке проекта всё равно сохранится, агент может на него ссылаться.

Не стесняйся говорить агенту как именно ты хочешь. «Короче», «ещё подробнее», «добавь раздел про критику», «перепиши в более деловом стиле», «вытащи все числа и факты отдельным списком» — всё работает. Project instructions задают дефолт, но твои конкретные указания всегда в приоритете.

Длинные видео — это дорого. Часовой транскрипт занимает ~20 тысяч токенов. Трёхчасовое интервью — 60 тысяч. Агент это понимает и предупредит, но имей в виду: много длинных видео в день = ощутимый расход.

Используй критику. Это, возможно, самое ценное. Большинство AI-саммари по умолчанию хвалят любое видео. Этот агент настроен говорить прямо, если видео слабое. Спрашивай «в чём слабые места автора?», «где он противоречит сам себе?», «какие аргументы натянуты?» — и получишь разбор, который не напишет никакой обычный автосуммаризатор.

Архив — твоё золото. Через месяц у тебя в папке проекта будет 30–50 .md файлов с разборами. Ты сможешь сказать «найди все мои ревью, где упоминается RAG», «сделай мета-обзор того, что я смотрел про AI-агентов за последний месяц», «сравни позиции Карпатого и Ына из тех интервью, что я разбирал» — и агент соберёт это из локальной библиотеки.

Не бойся переспрашивать и углублять. Ревью — это стартовая точка, а не финал. Самое интересное часто вылезает в Q&A, когда ты начинаешь копать конкретные тезисы.

И всё.

Настройка занимает 10 минут.

А после этого — да простит меня, YouTube — ты перестаёшь смотреть длинные видео «как раньше». Вместо этого появляется новая привычка: интересная ссылка → ассистенту на разбор → через полминуты у тебя плотное ревью, из которого ты уже знаешь всё существенное. Само видео в большинстве случаев открывать не нужно — суть, идеи и выводы уже усвоены.

Но главное — не в экономии времени. Главное в том, что у тебя начинает расти личная база разборов, которая со временем становится картой твоего знания по любым темам. Через полгода можно спросить себя: «что я вообще узнал про AI за этот год из YouTube?» — и получить осмысленный ответ.

Пробуй. Начни с одного видео, которое давно хотел посмотреть, но никак. Брось ссылку — получи ревью через 30 секунд.

А дальше уже увидишь, как это меняет твои отношения с информацией.

И да...Это только начало, того что можно делать в ИИ.

Мои агенты уже давно живут на сервере и работают 24/7.

А общаюсь я с ними в Телеграме 🫡

Если ты тоже хочешь внедрить ИИ в свою работу, жизнь и бизнес — тогда присоединяйся в наше закрытое сообщество AI Room Club. Внутри еще больше полезных гайдов, инструкций и даже целых курсов.

Подробнее про клуб ты можешь прочитать тут..