youtube-voice-summarizer

# YouTube Voice Summarizer

Transform any YouTube video into a professional voice summary delivered in under 60 seconds.

## What It Does

When a user sends a YouTube URL, this skill:
1. Extracts the video transcript via Supadata
2. Generates a concise AI summary via OpenRouter/Cerebras
3. Converts the summary to natural speech via ElevenLabs
4. Returns an audio file the user can listen to

## Requirements

This skill requires a running backend server. Deploy the summarizer service:

```bash
git clone https://github.com/Franciscomoney/elevenlabs-moltbot.git
cd elevenlabs-moltbot
npm install
cp .env.example .env
# Add your API keys to .env
npm start
```

### Required API Keys

| Service | Purpose | Get Key |
|---------|---------|---------|
| ElevenLabs | Text-to-speech | https://elevenlabs.io |
| Supadata | YouTube transcripts | https://supadata.ai |
| OpenRouter | AI summarization | https://openrouter.ai |

## How to Use

When user sends a YouTube URL:

### Step 1: Start the voice summary job

```bash
curl -s -X POST http://127.0.0.1:3050/api/summarize \
  -H "Content-Type: application/json" \
  -d '{"url":"YOUTUBE_URL","length":"short","voice":"podcast"}'
```

Returns: `{"jobId": "job_xxx", "status": "processing"}`

### Step 2: Poll for completion (wait 3-5 seconds between checks)

```bash
curl -s http://127.0.0.1:3050/api/status/JOB_ID
```

Keep polling until status is "completed".

### Step 3: Return the audio to user

When complete, the response includes:
- `result.audioUrl` - The MP3 audio URL (send this to the user!)
- `result.teaser` - Short hook text about the content
- `result.summary` - Full text summary
- `result.keyPoints` - Array of key takeaways

Send the user:
1. The teaser text as a message
2. The audio URL so they can listen

## Voice Options

| Voice | Style |
|-------|-------|
| `podcast` | Deep male narrator (default) |
| `news` | British authoritative |
| `casual` | Friendly conversational |
| `female_warm` | Warm female voice |

## Summary Leng...

# YouTube Voice Summarizer

Transform any YouTube video into a podcast-style voice summary in under 60 seconds.

## Features

- **Fast** - Full voice summary in ~60 seconds
- **Natural Voice** - ElevenLabs multilingual v2
- **Any Video Length** - Works with 10 minutes or 10 hours
- **Multiple Voices** - 4 voice styles to choose from
- **Customizable Length** - Short, medium, or detailed summaries

## Quick Start

1. Deploy the backend server from [GitHub](https://github.com/Franciscomoney/elevenlabs-moltbot)
2. Configure your API keys (ElevenLabs, Supadata, OpenRouter)
3. Add this skill to your OpenClaw bot
4. Send YouTube links and receive voice summaries!

## How It Works

```
YouTube URL → Supadata (transcript) → AI (summary) → ElevenLabs (voice) → You
```

## API Keys Required

| Service | Purpose | Link |
|---------|---------|------|
| ElevenLabs | Text-to-speech | https://elevenlabs.io |
| Supadata | YouTube transcripts | https://supadata.ai |
| OpenRouter | AI summarization | https://openrouter.ai |

## License

MIT - Francisco Cordoba