youtube

# YouTube Research & Transcription

Search YouTube, get video/channel info, and fetch transcripts using YouTube Data API v3.

## Features

- 📹 Video details (title, description, stats, publish date)
- 📝 Transcripts with timestamps
- 📺 Channel info and recent videos
- 🔍 Search within YouTube
- 🎬 Playlist info

## Setup

### 1. Install dependencies

**MCP Server (primary method):**
```bash
npm install -g zubeid-youtube-mcp-server
```

**Fallback tool (if MCP fails):**
```bash
# yt-dlp for transcript extraction
pip install yt-dlp
```

### 2. Get YouTube API Key

1. Go to [Google Cloud Console](https://console.cloud.google.com)
2. Create/select a project (e.g., "YouTube Research")
3. Enable the API:
   - Menu → "APIs & Services" → "Library"
   - Search: "YouTube Data API v3"
   - Click "Enable"
4. Create credentials:
   - "APIs & Services" → "Credentials"
   - "Create Credentials" → "API Key"
   - Copy the key
5. Optional - Restrict:
   - Click the created key
   - "API restrictions" → Select only "YouTube Data API v3"
   - Save

### 3. Configure API Key

**Option A: Clawdbot config** (recommended)
Add to `~/.clawdbot/clawdbot.json`:
```json
{
  "skills": {
    "entries": {
      "youtube": {
        "apiKey": "AIzaSy..."
      }
    }
  }
}
```

**Option B: Environment variable**
```bash
export YOUTUBE_API_KEY="AIzaSy..."
```

### 4. Setup MCP Server

The skill will use `mcporter` to call the YouTube MCP server:

```bash
# Build from source (if installed package has issues)
cd /tmp
git clone https://github.com/ZubeidHendricks/youtube-mcp-server
cd youtube-mcp-server
npm install
npm run build
```

## Usage

### Search Videos

```bash
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" \
  search_videos query="ClawdBot AI" maxResults:5
```

Returns video IDs, titles, descriptions, channel info.

### Get Channel Info

```bash
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" \
  channels_info channelId="UCSHZKyawb77ixDdsGog4iWA"
```

### L...

# YouTube 📹

YouTube research and transcription skill for [Clawdbot](https://clawdbot.com).

## Features

- 📹 **Video Details** - Get title, description, stats, publish date
- 📝 **Transcripts** - Extract transcripts with timestamps
- 📺 **Channel Info** - Get channel details and recent videos
- 🔍 **Search** - Find videos by keywords
- 🎬 **Playlist Info** - Get playlist details

## Installation

```bash
clawdhub install youtube
```

## Configuration

Get a YouTube API key from [Google Cloud Console](https://console.cloud.google.com):
1. Create a project
2. Enable YouTube Data API v3
3. Create credentials → API Key

```bash
export YOUTUBE_API_KEY="your-api-key"
```

Or add to `~/.clawdbot/clawdbot.json`:
```json
{
  "skills": {
    "entries": {
      "youtube": {
        "apiKey": "AIzaSy..."
      }
    }
  }
}
```

## Usage Examples

```
"Find the latest Lex Fridman podcast episode"
"Get the transcript for this video: https://youtube.com/watch?v=Z-FRe5AKmCU"
"Search YouTube for Laravel tutorials"
"Show me recent videos from channel UCSHZKyawb77ixDdsGog4iWA"
"Get video details for Z-FRe5AKmCU"
```

## Credits

This skill uses the [youtube-mcp-server](https://github.com/ZubeidHendricks/youtube-mcp-server) by Zubeid Hendricks for YouTube Data API integration.

## License

MIT