extract-youtube-auto

Overview

Non-interactive YouTube extraction for scripts and CI pipelines. Extracts video metadata, description, and transcript into structured markdown files and updates a video registry CSV. Uses explicit --category and --tags flags instead of interactive prompts.

Usage

python main.py extract-youtube-auto URL [OPTIONS]

Options

Option	Description	Default
URL	YouTube video URL (positional, required)	--
--category	Primary category	technical-development
--tags	Comma-separated secondary tags	--
--output, -o	Output directory	./docs/youtube-videos
--skip-existing / --no-skip-existing	Skip if video already in registry	true
--update-index / --no-update-index	Update INDEX.md with video entry	true

Prerequisites

• Repo: content-conductor
• Install: pip install -r requirements.txt from repo root
• Dependencies: yt-dlp, youtube-transcript-api

Examples

Extract with category and tags

python main.py extract-youtube-auto https://youtu.be/VIDEO_ID --category ai-tools --tags "tutorials,claude-code"

Reprocess an existing video

python main.py extract-youtube-auto https://youtu.be/VIDEO_ID --no-skip-existing

Output

Creates metadata.md, description.md, and transcript.md in a video-slug subdirectory. Updates registry.csv and optionally INDEX.md.

Related Commands

• cc extract-web -- extract web pages to markdown
• cc extract-pdf -- extract PDF files to markdown