n8n-nodes-kih-youtube-transcript

n8n-nodes-kih-youtube-transcript

This is an n8n community node that allows you to fetch transcripts from YouTube videos using the KI-H API.

Installation

Install from npm

The easiest way to install this node is through the n8n UI:

• Go to Settings > Community Nodes
• Click Install
• Enter n8n-nodes-kih-youtube-transcript
• Click Install

Install via npm directly

cd ~/.n8n
npm install n8n-nodes-kih-youtube-transcript

Then restart n8n.

Manual Installation

• Navigate to your n8n nodes directory:

  cd ~/.n8n/nodes
  

• Clone or download this repository:

  git clone https://github.com/ki-h/n8n-nodes-kih-youtube-transcript
  

• Install dependencies:

  cd n8n-nodes-kih-youtube-transcript
  npm install
  

• Build the node:

  npm run build
  

• Restart n8n

Usage

The KIH YouTube Transcript node provides the following functionality:

Get Transcript

Fetches the transcript/subtitles from a YouTube video.

Input Parameters

• YouTube URL: The URL of the YouTube video (supports various formats)
  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://www.youtube.com/embed/VIDEO_ID

Options

• Output Format:

  • Full Data: Returns complete transcript with timestamps and metadata
  • Text Only: Returns only the combined text without timestamps
  • Formatted: Returns formatted text with timestamps

• Language: Language code for the transcript (e.g., 'en', 'de', 'fr')

Output

Depending on the selected output format:

Full Data format:

{
  "transcript": [
    {
      "text": "Hello world",
      "start": 0,
      "duration": 2.5
    }
  ],
  "fullText": "Hello world ...",
  "videoId": "VIDEO_ID",
  "url": "https://...",
  "totalItems": 42
}

Text Only format:

{
  "text": "Hello world ...",
  "videoId": "VIDEO_ID",
  "url": "https://..."
}

Formatted format:

{
  "formattedText": "[0:00] Hello world\n[0:05] ...",
  "videoId": "VIDEO_ID",
  "url": "https://..."
}

Error Handling

The node will handle common errors such as:

• Invalid YouTube URL format
• Video not found
• Transcript not available for the video
• Network errors

When "Continue On Fail" is enabled, errors will be returned in the output instead of stopping the workflow.

Development

# Install dependencies
npm install

# Build the node
npm run build

# Development mode (watch for changes)
npm run dev

# Run linter
npm run lint

# Clean build files
npm run clean

License

MIT

API Information

This node uses the KI-H YouTube Transcript API service hosted at https://api.ki-h.net/api/youtube-transcript.

Support

For issues and feature requests, please use the GitHub issues page.

Publishing to npm

To publish this package to npm:

npm login
npm publish