Youtube Transcript

🚀 YouTube 字幕 API

本項目是一個Python服務，通過API來獲取並轉錄YouTube視頻內容。它提供了REST API（基於Flask）和MCP服務器兩種實現方式，能滿足不同場景下獲取YouTube視頻字幕的需求。

🚀 快速開始

本服務提供了REST API（Flask）和MCP服務器兩種使用方式，你可以根據自己的需求進行選擇。

REST API（Flask）

啟動Flask服務器：

python apps/flask_server.py

可用端點：

• GET /transcript?video_id=<video_id>&language=<lang> - 獲取視頻字幕
• GET /video/info?video_id=<video_id> - 獲取視頻信息
• GET /health - 健康檢查端點

MCP 服務器

啟動MCP服務器：

python apps/mcp_server.py

可用工具：

• get_transcript(video_id, language) - 獲取視頻字幕
• extract_transcript(video_id, language) - 從音頻中提取字幕
• search_youtube_video(query) - 搜索YouTube視頻

✨ 主要特性

• 多語言支持：可獲取多種語言的YouTube視頻字幕，目前支持英語和越南語。
• 自動檢測：自動檢測並使用可用字幕，當沒有字幕時，會fallback到音頻轉錄（使用Whisper）。
• 雙接口實現：支持REST API和MCP服務器接口，滿足不同使用場景。
• 智能語言檢測：具備自動語言檢測功能。
• 文件清理：可進行臨時文件清理。
• 進度報告：長時間操作會有進度報告。

📦 安裝指南

pip install -r requirements.txt

💻 使用示例

基礎用法

REST API（Flask）

啟動服務器：

python apps/flask_server.py

獲取視頻字幕：

curl "http://127.0.0.1:5000/transcript?video_id=your_video_id&language=en"

MCP 服務器

啟動服務器：

python apps/mcp_server.py

在Python代碼中獲取視頻字幕：

from apps.mcp_server import get_transcript
transcript = get_transcript('your_video_id', 'en')
print(transcript)

📚 詳細文檔

語言支持

• 英語（en）
• 越南語（vi）
• 其他語言的自動檢測

依賴項

• youtube-transcript-api
• pytube
• whisper
• torch
• langdetect
• flask（用於REST API）
• mcp（用於MCP服務器）

開發

項目的結構：

apps/
├── __init__.py
├── flask_server.py  # REST API 實現
├── mcp_server.py    # MCP 服務器實現
└── utils.py         # 公共工具

📄 許可證

MIT License