| name | blog-audio |
| description | Generate audio narration of blog posts using Google Gemini TTS. Supports summary narration, full article read-aloud, and two-speaker podcast/dialogue mode with 30 voice options. Outputs MP3 with HTML5 audio embed code. Works standalone via /blog audio or internally from blog-write. Falls back gracefully when API key is not configured. Use when user says "blog audio", "narrate blog", "audio version", "text to speech", "tts", "podcast mode", "read aloud", "audio narration", "voice", "narration", "generate audio".
|
| user-invokable | true |
| argument-hint | [generate|voices|setup] [file-or-text] [--mode summary|full|dialogue] [--voice name] |
| license | MIT |
| metadata | {"author":"dotusmanali","version":"2.0.0"} |
| id | blog-audio |
| domain | content |
| invoked_by | ["blog-seo"] |
| depends_on | [] |
Blog Audio: Gemini TTS Narration for Blog Posts
Generate professional audio narration of blog content using Google's Gemini TTS.
Three modes: summary (200-300 word spoken overview), full article read-aloud,
or two-speaker podcast dialogue. 30 voices, 80+ languages, HTML5 embed output.
Quick Reference
| Command | What it does |
|---|
/blog audio generate <file> | Generate audio narration of a blog post |
/blog audio voices | Show available voices with characteristics |
/blog audio setup | Check/configure API key for Gemini TTS |
Prerequisites
- Python 3.11+ (venv managed automatically by
run.py)
GOOGLE_AI_API_KEY environment variable (same key used by seo-image-gen)- FFmpeg (for WAV-to-MP3 conversion; falls back to WAV if missing)
Always Use run.py Wrapper
python3 scripts/run.py generate_audio.py --text "..." --voice Charon --json
python3 scripts/generate_audio.py --text "..."
API Key Check (Gate Pattern)
Before generating audio, check for the API key:
echo $GOOGLE_AI_API_KEY
- If set: proceed with generation
- If not set: guide the user:
"Audio generation requires a Google AI API key. Get one free at https://aistudio.google.com/apikey
Then set it:
export GOOGLE_AI_API_KEY=your-key
This is the same key used by /blog image: if image generation works, audio works too."
- When called internally (from blog-write): return silently if key is missing.
Never block the writing workflow.
Setup
For /blog audio setup:
- Check if
GOOGLE_AI_API_KEY is set in environment
- If seo-image-gen is configured (check
.mcp.json), the key is already available
- If not, guide user to
