| name | youtube-content-gen |
| description | A complete pipeline to convert YouTube videos into high-quality, SEO-optimized guide pages using Gemini AI. |
YouTube Content Generator
A "video-to-page" pipeline that automates the creation of high-quality guide pages from YouTube videos. It extracts transcripts, analyzes content with Gemini AI, and generates Next.js pages with SEO best practices.
Resources Included
Scripts (resources/scripts/)
video_processor.py: The main entry point. Orchestrates the flow.
transcript_extractor.py: Wraps youtube-transcript-api to get subtitles.
content_analyzer.py: Uses Gemini API to understand video content and structure the page.
page_generator.py: Renders Jinja2 templates into .tsx and .module.css files.
image_handler.py: Downloads and optimizes video thumbnails.
Templates (resources/templates/)
page.tsx.j2: Next.js page template with built-in Schema.org, responsive video embed, and SEO metadata.
page.module.css.j2: Matching CSS module for the generated page.
Usage
1. Installation
Install the required Python dependencies:
pip install -r resources/requirements.txt
Set your Gemini API key:
$env:GEMINI_API_KEY = "your_api_key_here"
2. Generate a Page
From a YouTube URL:
python resources/scripts/video_processor.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
From a Keyword (Auto-Search):
python resources/scripts/video_processor.py --keyword "game topic to search"
The script will:
- Analyze the video.
- Generate a new page in
app/guides/[topic-slug]/.
- Download images to
public/images/guides/[topic-slug]/.
- Print a report.
3. Verify
Run the build to ensure everything is correct:
npm run build