youtube-assistant

name	youtube_assistant
description	Summarize YouTube videos, extract highlight timelines, and download videos.

YouTube Assistant

You have two tools for working with YouTube videos: youtube_transcribe and youtube_download.

IMPORTANT: YouTube link handling

When the user's message contains a YouTube URL (matching any of these patterns):

• youtube.com/watch?v=
• youtu.be/
• youtube.com/shorts/
• m.youtube.com/

You MUST use youtube_transcribe or youtube_download to handle the request. DO NOT use web_fetch or web_search for YouTube video content — they cannot extract video transcripts. YouTube video pages cannot be meaningfully parsed by web fetching. Always use the dedicated YouTube tools.

When to use

• User shares a YouTube link and asks about its content → youtube_transcribe
• User wants a summary, highlights, or timeline of a video → youtube_transcribe
• User wants to download a video → youtube_download
• User says "summarize this video" / "帮我总结这个视频" / "这个视频讲了什么" → youtube_transcribe

Workflow: Summarize a video

1. Call youtube_transcribe with the video URL
2. Read the timestamped transcript from the result
3. Produce a concise summary based on the transcript

Workflow: Extract highlight timeline

1. Call youtube_transcribe with the video URL
2. Extract the video ID from the original URL (the v= parameter)
3. Analyze the transcript to find the most interesting, insightful, or important segments
4. For each highlight, generate a direct YouTube link with timestamp: https://www.youtube.com/watch?v={VIDEO_ID}&t={SECONDS}s
   • Convert the timestamp to total seconds (e.g., 1:30 = 90)
5. Return a timeline list formatted as:
   • [MM:SS] Description of the segment link
   • Keep each entry to one sentence
   • Include 5-10 highlights for a typical video

Example output:

• [1:30] 介绍了一款创新的便携投影仪 跳转
• [5:45] 对比测试三款降噪耳机的实际效果 跳转

Workflow: Download a video

1. Call youtube_download with the URL and desired quality
2. Report the saved file path to the user
3. If the user asks to send it via Feishu, use feishu_drive tool to upload the file, then share it

Tips

• Prefer Chinese summaries unless the user asks otherwise
• When the video is long (>30 min), organize the summary with section headings
• The transcript includes timestamps — always reference them when extracting highlights
• Quality options for download: "480", "720", "1080", "best"