media-transcript-search

name	media-transcript-search
description	Extract and search transcripts from multimedia sources (primarily YouTube). Allows finding specific topics within long content without watching the whole video.

Multimedia Transcript Search Skill

This skill turns opaque video content into searchable text data, essential for analyzing speeches, lectures, and news clips.

Capabilities

1. Get Transcript: Download the full transcript of a YouTube video.
2. Keyword Search: Find timestamps where specific keywords or phrases are mentioned.
3. Context Window: Return surrounding text to understand the context of the mention.

Usage

Run the python script get_transcript.py.

Arguments

• video_id (required): The YouTube Video ID (e.g., dQw4w9WgXcQ).
• --search (optional): Keyword to find.
• --lang (optional): Language code (default 'en').

Example

# Get full transcript for a video
python3 get_transcript.py dQw4w9WgXcQ

# Find where "climate change" is discussed
python3 get_transcript.py dQw4w9WgXcQ --search "climate change"

Dependencies

This skill requires the youtube-transcript-api library.

pip install youtube-transcript-api

Output Format

A JSON object containing:

• video_id
• transcript: Full list of segments (if no search) OR
• matches: List of segments matching the search term:
  • text: The text segment.
  • start: Start time (seconds).
  • duration: Duration of segment.
  • url: Direct URL to timestamp (e.g., https://youtu.be/ID?t=123).

Tips for the Agent

• Fuzzy Matching: The search is simple case-insensitive matching.
• Timestamps: Always provide the url with the timestamp so the user can verify the context immediately.