---
name: jamie-youtube-manager
description: |
  Jamie Clinic YouTube channel SEO auditor and content manager.
  Triggers: YouTube SEO, video audit, 제이미 유튜브, channel optimization.
---

# Jamie YouTube Manager Skill

> **Purpose**: YouTube Channel SEO Auditor & Content Manager for Jamie Plastic Surgery Clinic
> **Platform**: Claude Code (CLI) + Claude Desktop
> **Input**: YouTube video URLs, playlist URLs, or channel data
> **Output**: Video info, channel stats, audit checklist + SEO recommendations

---

## CLI Scripts (Claude Code)

### Setup

```bash
cd ~/Project/our-claude-skills/custom-skills/43-jamie-youtube-manager/code/scripts
source venv/bin/activate
```

### Available Scripts

| Script | Purpose | Usage |
|--------|---------|-------|
| `jamie_channel_status.py` | Channel stats overview | `python jamie_channel_status.py` |
| `jamie_video_info.py` | Video details from URL | `python jamie_video_info.py "URL"` |
| `jamie_youtube_api_test.py` | API connectivity test | `python jamie_youtube_api_test.py` |
| `jamie_youtube_batch_update.py` | Batch metadata update | `python jamie_youtube_batch_update.py` |

### Channel Stats Example
```bash
python jamie_channel_status.py
# Output: Channel name, subscribers, views, recent videos with status
```

### Video Info from URL
```bash
python jamie_video_info.py "https://youtu.be/VIDEO_ID"
# Output: Title, description, duration, views, likes, tags, timestamps, privacy status
```

### Integration with Notion Writer
```bash
# Save video info to Notion
python jamie_video_info.py "URL" > ../output/video_status.md
cd ~/Project/our-claude-skills/custom-skills/02-notion-writer/code/scripts
source venv/bin/activate
python notion_writer.py -p NOTION_PAGE_URL -f ../../43-jamie-youtube-manager/code/output/video_status.md
```

---

## Workflow Overview

```
[Input: YouTube URL]
    ↓
[1. Fetch Video/Playlist Data]
    ↓
[2. Metadata Audit]
    ↓
[3. Chapter/Timestamp Check]
    ↓
[4. Transcript Review]
    ↓
[5. Schema Validation]
    ↓
[6. i18n Assessment]
    ↓
[Output: Audit Report + Recommendations]
```

---

## Content Types

| Type | Characteristics | Audit Focus |
|------|-----------------|-------------|
| **Long-form Video** | 5-30+ min, educational | Chapters, transcript, schema |
| **Shorts** | < 60 sec, vertical | Hook, hashtags, thumbnail |
| **Playlist** | Grouped videos | Naming, ordering, descriptions |

---

## Audit Checklist

### 1. Metadata Audit (메타데이터 감사)

#### Title (제목)

| Criteria | Standard | Check |
|----------|----------|-------|
| Length | 60-70 characters (Korean ~30자) | [ ] |
| Primary keyword | First 40 characters | [ ] |
| Brand mention | "제이미성형외과" included | [ ] |
| Click appeal | Clear benefit/curiosity | [ ] |
| No clickbait | Accurate to content | [ ] |

**Title Formula for Jamie**:
```
[시술명] + [핵심 베네핏] + 제이미성형외과
예: "내시경 이마거상술 | 자연스러운 동안 효과의 비밀 | 제이미성형외과"
```

#### Description (설명)

| Section | Required Content | Position |
|---------|------------------|----------|
| Hook | 핵심 내용 요약 (2-3줄) | 첫 150자 |
| Timestamps | 챕터 목차 | 상단 |
| Main content | 상세 설명, 키워드 자연 배치 | 중간 |
| CTA | 상담 예약 링크, 채널 구독 | 하단 |
| Links | 웹사이트, SNS, 관련 영상 | 하단 |
| Hashtags | 3-5개 관련 해시태그 | 최하단 |

**Description Template**:
```
[첫 2줄 - 영상 핵심 내용]
[시술명]에 대해 알아보세요. 제이미성형외과 정기호 원장이 설명합니다.

⏱️ 타임스탬프
00:00 인트로
01:23 [주제1]
03:45 [주제2]
...

📋 영상 내용
[상세 설명 - 키워드 자연 포함]

🏥 제이미성형외과
📍 주소: 서울시 강남구 압구정로...
📞 상담예약: 02-XXX-XXXX
🔗 홈페이지: https://...
📱 카카오톡: ...

#제이미성형외과 #[시술명] #압구정성형외과
```

#### Tags (태그)

| Category | Examples | Count |
|----------|----------|-------|
| Brand | 제이미성형외과, Jamie Plastic Surgery | 2-3 |
| Procedure | 이마거상술, 내시경이마거상, forehead lift | 5-8 |
| General | 성형외과, 압구정, 동안성형 | 3-5 |
| Long-tail | 이마주름개선, 눈썹처짐교정 | 3-5 |

**Total**: 15-20 tags (max 500 characters)

### 2. Chapter Timestamps (챕터 타임스탬프)

#### Requirements

| Criteria | Standard |
|----------|----------|
| Minimum chapters | 3+ for videos > 5 min |
| First timestamp | Must start at 00:00 |
| Format | MM:SS or HH:MM:SS |
| Placement | Description (visible area) |
| Labels | Clear, descriptive Korean |

#### Chapter Best Practices

```
✅ Good Example:
00:00 인트로
00:45 이마거상술이란?
02:30 수술 과정 설명
05:15 회복 기간 및 주의사항
08:00 자주 묻는 질문
10:30 마무리 및 상담 안내

❌ Bad Example:
00:00 시작
02:00 본론
08:00 끝
```

#### Auto-Chapter Detection

If timestamps missing, suggest based on:
- Topic transitions in transcript
- Visual scene changes (if accessible)
- Standard medical video structure

### 3. Transcript Review (자막/스크립트 검토)

#### Auto-Generated Caption Audit

| Check | Action |
|-------|--------|
| Medical terms accuracy | 의학 용어 오타 수정 |
| Brand name spelling | "제이미성형외과" 정확히 |
| Procedure names | 시술명 정확성 확인 |
| Numbers/dates | 숫자 표기 확인 |
| Speaker labels | 화자 구분 (필요시) |

#### Transcript Enhancement

Priority corrections for Jamie content:
```
Common errors to fix:
- "이마 거상" → "이마거상술"
- "제이미" 누락/오타
- 의학 용어 띄어쓰기
- 영어 의학 용어 정확성
```

### 4. Schema Validation (스키마 검증)

#### VideoObject Schema Requirements

```json
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "[Video Title]",
  "description": "[Video Description]",
  "thumbnailUrl": "[Thumbnail URL]",
  "uploadDate": "YYYY-MM-DD",
  "duration": "PT[X]M[Y]S",
  "contentUrl": "[Video URL]",
  "embedUrl": "[Embed URL]",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "https://schema.org/WatchAction",
    "userInteractionCount": [view count]
  },
  "publisher": {
    "@type": "Organization",
    "name": "제이미성형외과",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}
```

#### Medical Video Extensions

For medical content, recommend adding:
```json
{
  "@type": ["VideoObject", "MedicalWebPage"],
  "specialty": "PlasticSurgery",
  "medicalAudience": {
    "@type": "PatientAudience"
  },
  "lastReviewed": "YYYY-MM-DD"
}
```

#### Schema Checklist

| Property | Required | Jamie Standard |
|----------|----------|----------------|
| name | Yes | Match title exactly |
| description | Yes | First 160 chars meaningful |
| thumbnailUrl | Yes | High-res, branded |
| uploadDate | Yes | ISO 8601 format |
| duration | Yes | ISO 8601 duration |
| publisher | Recommended | 제이미성형외과 info |
| hasPart (Clips) | For chapters | Match timestamps |

### 5. Internationalization (다국어/국제화)

#### Language Settings

| Setting | Recommendation |
|---------|----------------|
| Primary language | Korean (ko) |
| Default audio | Korean |
| Title/Description | Korean primary |
| Subtitles | Korean (manual), English (auto+edit) |

#### Subtitle Priority

| Language | Priority | Target Audience |
|----------|----------|-----------------|
| Korean (ko) | Required | 내국인 |
| English (en) | High | Medical tourism |
| Japanese (ja) | Medium | 일본 의료관광객 |
| Chinese (zh) | Medium | 중국 의료관광객 |

#### Localized Metadata

For key videos, consider:
```
Title (English): Endoscopic Forehead Lift | Natural Rejuvenation | Jamie Plastic Surgery
Title (Japanese): 内視鏡額リフト | 自然な若返り | ジェイミー整形外科
```

#### i18n Checklist

| Item | Check |
|------|-------|
| Korean subtitles (manual) | [ ] |
| English subtitles | [ ] |
| Subtitle timing accuracy | [ ] |
| Localized title (EN) | [ ] |
| Localized description (EN) | [ ] |
| End screen localization | [ ] |

### 6. Shorts-Specific Audit (쇼츠 전용)

| Element | Standard |
|---------|----------|
| Duration | < 60 seconds |
| Aspect ratio | 9:16 vertical |
| Hook | First 1-3 seconds captivating |
| Text overlay | Readable, on-brand |
| Hashtags | #Shorts + 2-3 relevant |
| Music/Sound | Trending or original |
| CTA | Subscribe/Follow prompt |

### 7. Playlist Audit (재생목록 감사)

| Element | Checklist |
|---------|-----------|
| Playlist title | Descriptive, keyword-rich |
| Playlist description | 200+ characters, links |
| Video order | Logical sequence |
| Thumbnail consistency | Visual brand cohesion |
| Missing videos | Gap analysis |
| Duplicate content | Remove redundancy |

**Recommended Playlists for Jamie**:
```
1. 눈성형 시리즈 (Eye Surgery Series)
2. 이마/리프팅 시리즈 (Forehead/Lifting Series)
3. 자주 묻는 질문 FAQ
4. 원장 토크 (Director's Talk)
5. 수술 후 관리 (Post-Op Care)
```

---

## SEO Enhancement Recommendations

### Quick Wins

1. **Add timestamps** to all videos > 3 min
2. **Optimize first 150 chars** of description
3. **Include brand** in every title
4. **Add Korean captions** (manual review)
5. **Create consistent thumbnails**

### Advanced Optimization

1. **VideoObject schema** on website embeds
2. **Clip schema** for key moments
3. **Playlist** strategic grouping
4. **End screens** linking related videos
5. **Cards** for CTA and related content

### Content Gap Analysis

Compare against competitors:
- Missing procedure topics
- FAQ not addressed
- Trending formats not utilized
- Shorts opportunities

---

## Audit Report Template

### Video Audit Summary

```
📹 Video: [Title]
🔗 URL: [YouTube URL]
📅 Audit Date: YYYY-MM-DD

━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 OVERALL SCORE: [X]/100
━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ PASSED (X items)
- [Item 1]
- [Item 2]

⚠️ NEEDS IMPROVEMENT (X items)
- [Item 1]: [Recommendation]
- [Item 2]: [Recommendation]

❌ MISSING (X items)
- [Item 1]: [How to fix]
- [Item 2]: [How to fix]

━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 DETAILED CHECKLIST
━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Metadata]
☑️ Title optimized
☐ Description needs timestamps
☑️ Tags complete

[Chapters]
☐ No timestamps found
→ Suggested chapters: [list]

[Transcript]
☑️ Auto-captions available
☐ Manual Korean captions missing

[Schema]
☐ VideoObject not detected
→ Provide schema template

[i18n]
☐ English subtitles missing
☐ No localized metadata

━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 TOP 3 PRIORITIES
━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. [Highest impact action]
2. [Second priority]
3. [Third priority]
```

---

## Usage Examples

### Single Video Audit
```
"이 유튜브 영상 SEO 감사해줘: [URL]"
"유튜브 영상 메타데이터 최적화 확인해줘"
```

### Playlist Audit
```
"이 재생목록 검토해줘: [Playlist URL]"
"플레이리스트 구성 개선안 줘"
```

### Shorts Review
```
"쇼츠 영상들 점검해줘"
"Shorts SEO 체크리스트 확인"
```

### Bulk Audit
```
"제이미 유튜브 채널 전체 감사"
"최근 10개 영상 SEO 상태 확인"
```

### Schema Generation
```
"이 영상의 VideoObject 스키마 만들어줘"
"구조화된 데이터 추천해줘"
```

### i18n Setup
```
"영어 자막/메타데이터 추가 가이드"
"다국어 설정 최적화"
```

---

## Medical Advertising Compliance

### YouTube Content Rules (의료광고법)

**Allowed**:
- Educational procedure explanations
- General recovery information
- Doctor credentials and expertise
- Facility tours

**Prohibited**:
- Patient testimonials
- Before/After without disclaimers
- Guaranteed results claims
- Price comparisons

### Required Disclaimer

Include in description:
```
※ 본 영상은 정보 제공 목적이며, 개인에 따라 결과가 다를 수 있습니다.
수술 전 반드시 전문의와 상담하시기 바랍니다.
부작용: 출혈, 감염, 염증 등이 발생할 수 있습니다.
```

---

## Brand Integration

| Element | YouTube Standard |
|---------|------------------|
| Channel name | 제이미성형외과 |
| Handle | @jamie-plasticsurgery (recommended) |
| Logo | Consistent across all videos |
| Thumbnails | Branded template, faces visible |
| Intro/Outro | 3-5 sec branded bumper |
| Tone | Professional yet approachable |

---

## Available Resources

```
references/
├── youtube_seo_checklist.md           # Complete audit checklist
├── video_schema_templates.md          # JSON-LD schema templates
├── description_templates.md           # Description copy templates
└── shorts_optimization_guide.md       # Shorts-specific guidelines
```

---

*Version 1.0.0 | 2025-12-22 | Claude Desktop Skill*
