YouTube Long Video Transcript
by @qingliu1617-art
YouTube long video (>1 hour) full verbatim transcription and translation workflow. Use when user needs to (1) Extract subtitles from YouTube videos, (2) Translate English transcripts to Chinese, (3) Handle long videos that exceed session limits, (4) Process DownSub API responses and generate formatted documents.
clawhub install ytb-transcript-longπ About This Skill
name: youtube-transcript description: YouTube long video (>1 hour) full verbatim transcription and translation workflow. Use when user needs to (1) Extract subtitles from YouTube videos, (2) Translate English transcripts to Chinese, (3) Handle long videos that exceed session limits, (4) Process DownSub API responses and generate formatted documents.
YouTube Long Video Transcript & Translation
Full verbatim transcription and translation workflow for long YouTube videos (>1 hour).
Prerequisites
AIza...)zhiyan tool (optional, for online doc generation)DownSub API Configuration
Endpoint: https://api.downsub.com/download
Method: POST
Headers:
Authorization: Bearer AIzaM9ifctIOxusNAldvGeajHqq4rH6e7MJNfN
Content-Type: application/json
{"url": "https://www.youtube.com/watch?v=VIDEO_ID"}
β οΈ CRITICAL: Always check the lang field in response. Use ONLY en or en-auto. Do NOT use random languages (e.g., lt for Lithuanian).
Pre-flight Check (Run First)
1. Check DownSub API Access
- Verify Authorization header is configured
- Common error: "401 Unauthorized" = missing/invalid API key
2. Check Output Capabilities
- Has zhiyan tool? β Can generate online docs
- No zhiyan? β Output local .md file
3. Check Session Budget - Ensure sub-agent spawn capability for long context processing
Workflow
Step 1: Preparation (Main Session)
1. Environment Check: Confirm DownSub API key present
2. Get video link
3. Verify Language: Use DownSub to check lang
- IF lang="en" or "en-auto" β Proceed
- IF lang="lt" or other β STOP, do not translate
4. Check Length: If >1000 lines, DO NOT process in main session
5. Spawn Sub-Agent:
Task: Translate transcript.txt to Chinese verbatim.
Process in 500-line chunks to separate files (part1.md, etc.).
Merge to full_transcript.md.
Add Executive Summary and Key Metrics Table (Chinese) at top.
Do NOT use zhiyan.
Budget: 30 minutes or $2 cost limit.
Step 2: Execution (Sub-Agent)
1. Read & Slice: Read in chunks (limit=500). Do NOT read full file at once.
2. Translate & Format: Translate verbatim to Chinese. Add headers (e.g., ## εΌεΊ).
3. Stream Write: Write each chunk to separate files or use cat >> to append.
4. Enhance:
- Read first 500 lines to extract Key Metrics (Revenue, Growth, etc.)
- Generate Executive Summary (3-5 bullets, Chinese)
- Create Key Metrics Table (Markdown)
- Prepend to final file
5. Report: Return path to full_transcript.md
Step 3: Delivery (Main Session)
1. Receive file path from sub-agent
2. Upload: Run zhiyan MCP (parse_markdown) if available
3. Send doc link/file to user
Troubleshooting
Q: "What is the DownSub API Key?" β API key missing. Provide Bearer token or configure in secrets.
Q: "Tool zhiyan not found"
β zhiyan MCP not installed. Solution: Skip upload, send .md file directly.
Q: Translates into nonsense/random text
β Downloaded wrong subtitle track (e.g., Lithuanian). Solution: Check lang field, use only en.
Q: Task times out or stops responding β Video too long for single session. Solution: Spawn sub-agent to process in background.
βοΈ Configuration
AIza...)zhiyan tool (optional, for online doc generation)π Tips & Best Practices
Q: "What is the DownSub API Key?" β API key missing. Provide Bearer token or configure in secrets.
Q: "Tool zhiyan not found"
β zhiyan MCP not installed. Solution: Skip upload, send .md file directly.
Q: Translates into nonsense/random text
β Downloaded wrong subtitle track (e.g., Lithuanian). Solution: Check lang field, use only en.
Q: Task times out or stops responding β Video too long for single session. Solution: Spawn sub-agent to process in background.