YouTube Video Script Writer

# YouTube Video Script Writer

Research a topic, write a structured video script with timestamps, and generate YouTube-optimized metadata.

## When to Use

- "Write a YouTube script about {topic}"
- "Create a video outline for a {N}-minute video on {topic}"
- "Generate YouTube SEO metadata for my video about {topic}"

## Requirements

- **Brave Search MCP** for topic research and SEO keyword research
- **python3** for word-to-time conversion

## Workflow

### Step 1 — Video Brief

- **Topic**
- **Target length** (5, 10, 15, 20 minutes)
- **Style** (tutorial, explainer, list, opinion, vlog)
- **Audience** (beginners, professionals, general)
- **Channel niche** (tech, business, education, etc.)
- **Key message** (what should the viewer remember?)

### Step 2 — Research

```
brave_web_search: "{TOPIC} YouTube video popular {YEAR}"
brave_web_search: "{TOPIC} key points facts statistics {YEAR}"
brave_web_search: "{TOPIC} common questions people ask"
brave_video_search: "{TOPIC}" (see what's already popular)
```

### Step 3 — Write Script

```markdown
# {VIDEO TITLE}
🎬 Target: {N} min | Style: {STYLE}

## [0:00] Hook (first 30 seconds)
**ON CAMERA:**
"{Attention-grabbing opening line — question, bold claim, or surprising fact}"

"In this video, I'll show you {what viewer will learn}. 
By the end, you'll know how to {specific outcome}."

**B-ROLL:** {Visual suggestion}

---

## [0:30] Intro / Context
**ON CAMERA:**
"{Background info the viewer needs to understand the topic}"

**B-ROLL:** {Visual suggestion}
**GRAPHIC:** {Text overlay or diagram}

---

## [{TIMESTAMP}] Section 1: {Topic}
**ON CAMERA:**
"{Script — conversational, 130-150 words per minute of speaking}"

**KEY POINT:** {One sentence takeaway}
**B-ROLL:** {Visual}

---

## [{TIMESTAMP}] Section 2: {Topic}
...

## [{TIMESTAMP}] Section 3: {Topic}
...

---

## [{TIMESTAMP}] Recap & CTA
**ON CAMERA:**
"So to recap: {3 key points in one sentence each}."

"If this helped, hit that like button and subscribe — 
I post new videos every {schedule}.

Drop a comment below: {specific question to boost engagement}."

**END SCREEN:** Subscribe + Next video suggestion
```

### Step 4 — Timing Estimate

```bash
python3 << 'PYEOF'
script = """{SCRIPT_TEXT}"""
words = len(script.split())
speaking_rate = 140  # words per minute (conversational YouTube pace)
minutes = words / speaking_rate

print(f"Script word count: {words}")
print(f"Estimated duration: {minutes:.1f} minutes")
print(f"Target: {TARGET_MINUTES} minutes")

diff = TARGET_MINUTES - minutes
if abs(diff) > 1:
    print(f"⚠️ {'Trim' if diff < 0 else 'Expand'} by ~{abs(diff):.0f} min ({abs(int(diff * speaking_rate))} words)")
else:
    print(f"✅ On target")
PYEOF
```

### Step 5 — YouTube SEO Metadata

```
brave_web_search: "{TOPIC} YouTube keywords tags SEO {YEAR}"
```

```markdown
## YouTube Metadata

**Title options (under 60 chars):**
1. "{Power word} {topic} {benefit} ({year})"
2. "How to {outcome} with {topic} — {qualifier}"
3. "{Number} {topic} {tips/mistakes/tricks} ({qualifying detail})"

**Description (first 2 lines most important):**
{Hook line with primary keyword}
{What the video covers + value prop}

⏱️ Timestamps:
0:00 Intro
{timestamps from script}

🔗 Links mentioned:
{resource links}

**Tags:** {tag1}, {tag2}, {tag3}, ...

**Thumbnail concept:**
{Description: text overlay, facial expression, colors, background}
```

### Step 6 — Save Script

```bash
mkdir -p outputs/content/youtube
cat > "outputs/content/youtube/{VIDEO_SLUG}-script.md" << 'EOF'
{SCRIPT}
EOF
```

## Important Rules

- Hook must be in first 10 seconds — or viewers click away
- Write conversationally — read it out loud, it should sound natural
- 130-150 words per minute for comfortable speaking pace
- Include B-roll and graphic suggestions for every section
- Timestamps are essential for YouTube SEO and viewer retention

## Example Prompts

- "Write a 10-minute YouTube script about Docker for beginners"
- "Create a video outline for 'Top 5 AI tools for developers'"
- "Generate YouTube SEO metadata for my video about budgeting apps"