К основному содержанию
скилл CX Codex

youtube-research · manojbajaj95 — скилл для Claude Code: исследование YouTube

Скилл youtube-research для Claude Code, Codex, Cursor и других агентов: ищет видео по теме, тянет статистику каналов через YouTube Data API v3, разбирает транскрипты на крючки и паттерны удержания.

MIT 200 установок ★ 114 обновлён 2026-09-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-research -a claude-code
Открыть на GitHub

Что делает youtube-research

Внутри три режима: исследование темы перед съёмкой, разбор транскрипта на вирусные формулы и прямые запросы к YouTube Data API v3 через Bash, WebSearch и WebFetch.

Для API-режима нужен ключ YOUTUBE_API_KEY из Google Cloud Console — там же включается YouTube Data API v3. Квота фиксирована: 10 000 единиц в сутки, один поисковый запрос стоит 100 единиц, большинство остальных — 1 единицу. Поэтому при активном исследовании лимит можно исчерпать за несколько десятков поисковых запросов.

Режим исследования темы сохраняет результаты в ./youtube/episode/[номер]_[тема]/research.md и читает контекст проекта из strategy/brand.md, about/me.md и content/ideas.md. Для разбора транскрипта есть скрипт skills/youtube-research/scripts/fetch_transcript.py, которому передаётся ссылка или ID видео.

Какие задачи решает

  • найти топ-видео по теме и выгрузить их статистику через YouTube Data API v3
  • разобрать транскрипт конкурентного видео на крючки и механики удержания
  • выявить незакрытые углы темы среди уже опубликованного контента
  • получить статистику канала по хэндлу или список комментариев к видео
  • сохранить итоги исследования в структурированный файл для следующего скилла

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

  • Проведи исследование темы «автоматизация тестирования» на YouTube и сохрани результаты в файл эпизода
  • Разбери транскрипт видео VIDEO_ID и выдели крючки из первых 30 секунд
  • Подтяни статистику канала @HANDLE и последние 10 видео с числом просмотров

Как установить youtube-research

1Через Skills CLI (Vercel)

npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-research -a claude-code

2Вручную: положить файлы

~/.claude/skills/youtube-research/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/youtube-research/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о youtube-research

Как установить youtube-research в Claude Code?

Выполни команду npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-research -a claude-code. После этого скилл будет доступен по пути ~/.claude/skills/youtube-research/SKILL.md.

Что делает скилл youtube-research?

Исследует YouTube через три режима: поиск и анализ конкурентных видео, разбор транскриптов на вирусные паттерны и прямые запросы к YouTube Data API v3 для получения статистики видео, каналов и комментариев.

Что нужно для работы с YouTube Data API v3?

Нужен API-ключ из Google Cloud Console с включённым YouTube Data API v3. Ключ экспортируется как переменная окружения YOUTUBE_API_KEY. Квота — 10 000 единиц в сутки.

Исходный текст

SKILL.md · MIT
---
name: youtube-research
description: Research YouTube topics, analyze competitor videos, deconstruct viral content, and query the YouTube Data API. Use when researching a video topic before planning, analyzing video transcripts for viral patterns, searching competitor channels, or fetching video and channel stats via the YouTube Data API v3.
allowed-tools: Bash, WebSearch, WebFetch
---

# YouTube Research

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.



Three modes in one skill:

1. **Topic Research** — competitive landscape, content gaps, strategic insights before planning a video
2. **Video Analysis** — forensic deconstruction of transcripts to extract viral formulas and retention mechanics
3. **API Queries** — direct YouTube Data API v3 access for search, stats, comments, and channel info

---

## When to Use

- Researching a video topic before planning production
- Analyzing a competitor video to extract what makes it work
- Fetching channel stats, video metrics, or comments via the API
- Identifying content gaps and opportunities in a niche

---

## YouTube Data API Setup

### 1. Get an API Key

1. Go to [Google Cloud Console](https://console.cloud.google.com/) → APIs & Services → Library
2. Enable **YouTube Data API v3**
3. Create Credentials → API Key

```bash
export YOUTUBE_API_KEY="your-api-key-here"
```

> **Important:** When piping curl output, wrap the command in `bash -c '...'` to preserve env vars:
> ```bash
> bash -c 'curl -s "https://..." -H "..." | jq .'
> ```

### 2. Key API Commands

**Search Videos:**
```bash
bash -c 'curl -s "https://www.googleapis.com/youtube/v3/search?part=snippet&q=YOUR_QUERY&type=video&maxResults=10&order=viewCount&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle}'
```

**Get Video Details (stats, duration):**
```bash
bash -c 'curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics,contentDetails&id=VIDEO_ID&key=${YOUTUBE_API_KEY}"' | jq '.items[0] | {title: .snippet.title, views: .statistics.viewCount, likes: .statistics.likeCount, duration: .contentDetails.duration}'
```

**Get Channel by Handle:**
```bash
bash -c 'curl -s "https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics&forHandle=@HANDLE&key=${YOUTUBE_API_KEY}"' | jq '.items[0] | {id: .id, title: .snippet.title, subscribers: .statistics.subscriberCount, videos: .statistics.videoCount}'
```

**Get Video Comments:**
```bash
bash -c 'curl -s "https://www.googleapis.com/youtube/v3/commentThreads?part=snippet&videoId=VIDEO_ID&maxResults=20&order=relevance&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {author: .snippet.topLevelComment.snippet.authorDisplayName, text: .snippet.topLevelComment.snippet.textDisplay, likes: .snippet.topLevelComment.snippet.likeCount}'
```

**Get Trending Videos:**
```bash
bash -c 'curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&chart=mostPopular&regionCode=US&maxResults=10&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {title: .snippet.title, channel: .snippet.channelTitle, views: .statistics.viewCount}'
```

**Quota:** 10,000 units/day. Search = 100 units. Most others = 1 unit.

See [YouTube Data API docs](https://developers.google.com/youtube/v3) for full reference.

---

## Mode 1: Topic Research

Conduct research before planning a new video. Focus on insights and big levers — not data dumping.

### Workflow

**Step 0: Create research file**

Save all research to: `./youtube/episode/[episode_number]_[topic_short_name]/research.md`

If it already exists, read it and continue from where it left off.

**Step 1: Understand the topic**
- What problem does this video solve?
- Why would someone click on it?
- What makes it relevant now?

**Step 2: Research your own channel**

Use the API to find related videos you've already published. Document:
- Related videos (title, video ID, URL, key metrics)
- What's already been covered and how to differentiate

**Step 3: Competitor research**

Search for 5–8 top videos on the topic. For each:
- Get video details (views, likes, duration)
- Note the title, angle, and what makes it successful
- Synthesize common patterns and approaches

**Step 4: Content gap analysis**

Document:
- **What's saturated** — 3–5 over-covered angles
- **Gaps (Opportunities)** — rated ⭐⭐⭐ high / ⭐⭐ medium / ⭐ low
- **Recommended focus** — specific angle + unique value proposition

Rating criteria:
- ⭐⭐⭐ High: Significant gap, strong demand, clear differentiation
- ⭐⭐ Medium: Moderate gap, some competition, good potential
- ⭐ Low: Minor gap, heavily competed

### Research File Template

```markdown
# [Episode]: [Topic] - Research

## Episode Overview
**Topic**: [Brief description]
**Target Audience**: [Who this is for]
**Goal**: [What viewers will learn/gain]

## YouTube Research
### Your Previous Videos
[Related videos with metrics]

### Top Competing Videos
[5-8 videos: title, channel, views, angle, what works]

### Key Insights
[Patterns and findings synthesized]

## Content Gap Analysis
### What's Already Well-Covered
[List]

### Content Gaps (Opportunities)
[Rated list with ⭐ ratings]

### Recommended Focus
[Specific angle and unique value proposition]

## Production Notes
**Status**: Research Complete
**Created**: [Date]
```

### Parallel Research

If the host environment supports parallel research, split focused tasks such as competitor search, own-channel review, and comment mining. Otherwise, do them sequentially and synthesize findings after each section.

### Pitfalls

- **Data dumping** — Limit to 5–8 competitors, synthesize patterns instead of listing every video
- **Vague gaps** — "Not much content on this" → identify the specific missing angle
- **Long reports** — Focus on insights and big levers

**Next step:** Use `youtube-content` skill to plan the video based on this research.

---

## Mode 2: Video Analysis

Forensic deconstruction of video transcripts to extract viral formulas, hooks, and retention mechanics.

### Getting the Transcript

**Auto-fetch:**
```bash
python skills/youtube-research/scripts/fetch_transcript.py "YOUTUBE_URL_OR_VIDEO_ID"
```

**Manual paste:** YouTube's built-in transcript (click "..." → "Show transcript") or ytscribe.ai.

### Analysis Framework

Approach the transcript like a crime scene — extract everything systematically. See `reference/analysis-framework.md` for the full checklist and templates.

Analyze these 11 dimensions:

1. **Hook Architecture** — Primary hook (first 3–8s), hook type, secondary hooks, fill-in-blank templates
2. **Structural Blueprint** — Content framework (PAS, Story-Lesson-CTA, List-Depth-Summary), beat map, pacing
3. **Retention Mechanics** — Open loops, pattern interrupts, curiosity gaps, payoff points
4. **Emotional Engineering** — Emotional arc, trigger words, identity hooks, Us vs. Them dynamics
5. **Storytelling Elements** — Narrative framework, character positioning, conflict/stakes, specificity
6. **Linguistic Patterns** — Power phrases, sentence rhythm, repetition, conversational triggers
7. **Algorithm Signals** — Watch time optimizers, engagement bait, share/save triggers
8. **CTA Architecture** — Primary CTA, soft CTAs, timing, value exchange
9. **Viral Coefficient** — Shareability score (1–10), comment bait density, crossover potential
10. **Reusable Templates** — Fill-in-blank opening hooks (3 variations), section templates, transition library
11. **Implementation Playbook** — Top 10 steal-this elements, niche adaptation, A/B test suggestions

### Before Analysis, Collect Context

- Your niche/topic
- Your content style (casual, educational, hype, etc.)
- Target platform and video length goal

### Output Format

Structure output with all 11 sections. End with a **Quick Reference Cheatsheet** — one-page summary of all extracted patterns for rapid implementation.

---

## Tools

- **YouTube API**: `bash -c 'curl ...'` with `$YOUTUBE_API_KEY`
- **MCP (if available)**: `mcp__plugin_yt-content-strategist_youtube-analytics__search_videos`, `get_video_details`, `get_channel_details`
- **Web**: `WebSearch` and `WebFetch` for industry trends and context

© manojbajaj95 · MIT · manojbajaj95/claude-gtm-plugin

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →

Сначала — youtube-research от других авторов.

youtube-research bradautomates Скилл youtube-research для Claude Code ищет вирусные видео через TubeLab API и формирует отчёт с крючковыми формулами для исследования трендов YouTube. CX Codex +1 428установок youtube-research PostPlusAI Скилл youtube-research для Claude Code собирает публичные данные YouTube: метрики видео, сводки каналов и примеры комментариев — для проверки контента и аудитории фактами. CX Codex +1 1 100установок youtube-search ZeroPointRepo Скилл youtube-search для Claude Code, который ищет видео, каналы и плейлисты на YouTube через TranscriptAPI, а затем вытягивает расшифровки. Запускается, когда нужно собрать материалы по теме, найти авторов или разобрать содержание ролика. CX Codex +1 1 100установок pp-youtube Justin Скилл pp-youtube для Claude Code, Cursor, Codex и других агентов: ведёт локальную SQLite-базу по отслеживаемым YouTube-каналам и вытягивает свежие данные через YouTube Data API v3. CX Codex +1 423установок search-youtube Samarth Gupta Скилл search-youtube ищет видео на YouTube, достаёт субтитры и метаданные, качает звук и обходит каналы — всё через один CLI, который агент вызывает сам. CX Codex +1 ★ 276звёзд репо youtube-api fetcher-sh Скилл youtube-api даёт агенту доступ к поиску и данным YouTube через API fetcher.sh. Подходит для мониторинга каналов, анализа видео и поиска трендов. CX Codex +1 4 700установок youtube-channel-analytics-dashboard reason-machines Скилл youtube-channel-analytics-dashboard для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который следит за метриками YouTube-канала через дашборд. CX Codex +1 613установок Arcmira: YouTube Transcript Search arcmira Arcmira: YouTube Transcript Search — MCP-сервер для Claude Code, который ищет в расшифровках YouTube и подкастов цитаты, упоминания, рекламу и появления спикеров для исследований через ИИ-агента. CX Codex +1 ★ 33звёзд репо

Из того же набора41

Весь набор →
free-tool-strategy Скилл free-tool-strategy помогает спроектировать бесплатный калькулятор, генератор или другой инструмент для привлечения лидов и органического трафика. Пригодится от проверки идеи до плана запуска. CX Codex +1 217установок referral-program Скилл referral-program для Claude Code помогает спроектировать и оптимизировать реферальную или партнёрскую программу: от выбора механики и вознаграждений до метрик и A/B-тестов. Превращает клиентов в канал роста. CX Codex +1 215установок crm-integration Скилл crm-integration для Claude Code содержит шаблоны интеграции Close CRM, HubSpot и Salesforce для синхронизации лидов, сделок и вебхуков. CX Codex +1 211установок ph-content-recycling Скилл ph-content-recycling перерабатывает материалы запуска на Product Hunt для блогов, соцсетей, рассылок и документации. Скилл сохраняет готовые черновики прямо в репозиторий. CX Codex +1 208установок content-strategy-and-planning Скилл content-strategy-and-planning структурирует контент-стратегию, сетку публикаций и поисковую оптимизацию под AI-поисковики. Помогает связать позиционирование бренда с этапами воронки продаж. CX Codex +1 157установок linkedin Проверяет профиль LinkedIn и помогает писать посты. Оценивает видимость и SSI, составляет контент-план. CX Codex +1 145установок marketing-strategy Скилл marketing-strategy для Claude Code прорабатывает позиционирование B2B SaaS, оценивает рынок и готовит материалы для продаж. Связывает продуктовую стратегию с клиентами и конкурентами. CX Codex +1 144установок bootstrap Скилл bootstrap для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который проводит агентское интервью и создаёт файловую структуру нового GTM-проекта. CX Codex +1 127установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой