🎬 n8n YouTube Transcript Node

Custom n8n node for extracting transcripts and captions from YouTube videos, optimized for both standard workflows and AI agents.

✨ Features

$3

- Get Transcript: Extract transcripts/captions from YouTube videos
- Get Video Info: Retrieve basic video metadata using YouTube oEmbed API
- Multi-format Output: Support for raw text, structured JSON, SRT, and VTT formats

$3

- AI Mode: Optimized output format for AI agents
- Auto Summaries: Ready-to-use video content descriptions
- Structured Data: Simplified JSON for automated processing

$3

- Multi-language transcript support (en, fr, auto)
- Timestamp inclusion options
- Configurable transcript length limits
- Robust error handling with fallback mechanisms
- No API key required for basic functionality

$3

The node supports automatic language detection and manual language selection:

- Auto: Automatically selects the best available language (English → French → first available)
- Manual: Select from 100+ supported languages including English, French, Spanish, German, etc.

🚀 Installation

$3

- No API Key Required: Works with publicly available YouTube videos
- n8n instance: Version 0.190.0 or higher

$3

#### Option 1: From npm (when published)
``bash
npm install @cryptodevops/n8n-nodes-youtube-transcript
`

#### Option 2: From local package
`bash
npm install ./cryptodevops-n8n-nodes-youtube-transcript-1.0.0.tgz
`

#### Option 3: Development Installation
`bash
git clone
cd n8n-youtube-transcript
npm install
npm run build
npm link
`

$3

After installation, restart your n8n instance. The "YouTube Transcript" node will appear in the node palette.

📋 Available Operations

$3

Extract transcript/captions from a YouTube video.

Parameters:
- Video URL (required): YouTube video URL (e.g., "https://www.youtube.com/watch?v=VIDEO_ID")
- Language (optional): Transcript language (fr, en, auto) - Default: auto
- Format Output (optional): Output format (raw, structured, srt, vtt) - Default: structured
- Include Timestamps (optional): Include timing information - Default: true
- AI Mode (optional): Enable AI-optimized output with summary
- Max Length (optional): Maximum transcript length in characters - Default: 10000

$3

Retrieve basic information about a YouTube video.

Parameters:
- Video URL (required): YouTube video URL

📤 Output Formats

$3

`json
{
"video_id": "WAh6paM4GqI",
"language": "fr",
"total_segments": 25,
"transcript_available": true,
"segments": [
{
"start": 0,
"duration": 3.5,
"text": "Salut tout le monde !"
}
],
"full_text": "Salut tout le monde ! Aujourd'hui on va parler...",
"ai_summary": "Cette vidéo présente le concept de Vibe Coding..."
}
`

$3

`json
{
"video_id": "WAh6paM4GqI",
"language": "fr",
"total_segments": 25,
"transcript": "Salut tout le monde ! Aujourd'hui on va parler du Vibe Coding..."
}
`

$3

`json
{
"video_id": "WAh6paM4GqI",
"language": "fr",
"total_segments": 25,
"srt_format": "1\\n00:00:00,000 --> 00:00:03,500\\nSalut tout le monde !\\n\\n2\\n..."
}
`

$3

`json
{
"video_id": "WAh6paM4GqI",
"title": "Qu'est ce que le Vibe Coding ?",
"author_name": "Mike Codeur",
"thumbnail_url": "https://i.ytimg.com/vi/WAh6paM4GqI/hqdefault.jpg",
"width": 200,
"height": 113,
"url": "https://www.youtube.com/watch?v=WAh6paM4GqI"
}
``

🛠️ Error Handling

The node includes robust error handling:
- Invalid URLs: Validates YouTube URL format
- Private/Unavailable Videos: Graceful error messages
- No Transcript Available: Fallback with informative messages
- API Failures: Multiple fallback mechanisms

📚 Documentation

- Installation Guide - Detailed installation instructions
- Example Workflow - Ready-to-import n8n workflow
- Changelog - Version history and updates

🔗 Useful Links

- YouTube oEmbed API
- n8n Documentation
- SRT Format Specification
- WebVTT Format Specification

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🐛 Support

If you encounter issues:
1. Check the Installation Guide
2. Verify your YouTube URL format
3. Ensure the video has captions/transcripts available
4. Open an issue with detailed error information

---

Note: This node works with publicly available YouTube videos that have captions/transcripts enabled. No API key required for basic functionality.