n8n-nodes-ytube-transcript-wlang

🔧 A powerful n8n custom node to extract and parse YouTube subtitles using yt-dlp, with multi-language support and structured JSON output.

🇻🇳 Mô tả

Node tùy chỉnh cho n8n, giúp trích xuất phụ đề video YouTube bằng công cụ yt-dlp. Hỗ trợ lựa chọn ngôn ngữ phụ đề (ví dụ: vi, en, ja, ...), xác thực bằng cookie, và chuyển phụ đề định dạng .vtt sang JSON có cấu trúc, sẵn sàng để xử lý hoặc lưu trữ.

✨ Tính năng

• 📼 Nhận cả URL YouTube và video ID
• 🌐 Lựa chọn ngôn ngữ phụ đề (lang: vi, en, ja,...)
• 🔐 Hỗ trợ xác thực bằng cookie (dạng chuỗi hoặc file .txt)
• 📄 Phân tích .vtt thành JSON chi tiết (text, start, duration)
• 🧹 Tự động dọn dẹp file tạm sau xử lý

📦 Cài đặt

1. Cài qua npm

npm install @minproducer/n8n-nodes-ytube-transcript-wlang

2. Đặt vào thư mục custom node:

~/.n8n/nodes/

3. Hoặc mount vào Docker:

volumes:
  - ./nodes:/home/node/.n8n/nodes

🧪 Ví dụ input

{
	"videoId": "5rJbGqNyPn4",
	"lang": "vi"
}

📤 Ví dụ output

{
	"youtubeId": "5rJbGqNyPn4",
	"transcript": [
		{
			"text": "Xin chào các bạn",
			"start": 0,
			"duration": 2.5
		}
	],
	"metadata": {
		"title": "Mỹ phát ‘cảnh báo thép’...",
		"duration": 499,
		"uploader": "VIETNAM NEWS AGENCY MEDIA...",
		"uploadDate": "20250622",
		"view_count": 15000,
		"description": "..."
	}
}

🧪 Kiểm thử (Testing)

Tool test đi kèm tại tools/test-runner.js:

Chạy test toàn bộ:

npm run test

Test 1 video cụ thể:

node tools/test-runner.js --url "https://www.youtube.com/watch?v=5rJbGqNyPn4" --lang vi --format both --savefile

Test hàng loạt:

node tools/test-runner.js --file tools/video-list.json --output-dir ./results --save

Tuỳ chọn khác:

📁 File kết quả sẽ được lưu trong test-results/ hoặc thư mục chỉ định.

🇬🇧 English

Custom node for n8n to extract YouTube subtitles via yt-dlp, with support for subtitle language selection (vi, en, ja, etc.), cookie authentication, and full .vtt parsing into structured JSON.

✨ Features

• 📼 Accepts both YouTube URL and video ID
• 🌍 Select subtitle language (lang: vi, en, ja,...)
• 🔐 Supports cookie-based authentication (string or file)
• 📄 Parses .vtt subtitle files into structured JSON (text, start, duration)
• 🧹 Auto-cleans temp files after use

📦 Installation

npm install @minproducer/n8n-nodes-ytube-transcript-wlang

Place inside custom node folder:

~/.n8n/nodes/

Or mount in Docker:

volumes:
  - ./nodes:/home/node/.n8n/nodes

🧪 Testing Instructions

Test runner included at tools/test-runner.js.

Run all test cases:

npm run test

Test a specific video:

node tools/test-runner.js --url "https://www.youtube.com/watch?v=5rJbGqNyPn4" --lang en --format both --savefile

Run batch test from file:

node tools/test-runner.js --file tools/video-list.json --save

📝 License

MIT © minproducer