Args:
    video_url_or_id: Full YouTube URL (watch/youtu.be/embed/shorts) or bare 11-char video ID.
    languages: Preferred language codes in priority order, e.g. ["en", "en-GB"]. Defaults to ["en"].
    include_timestamps: If true, prefix each line with a [mm:ss] timestamp.

Note: oEmbed does not expose upload date or full description (those require the official
Data API + an API key). This returns what's available without one.

Args:
    video_url_or_id: Full YouTube URL or bare 11-char video ID.

Args:
    video_url_or_id: Full YouTube URL or bare 11-char video ID.
    query: Keyword or phrase to search for (case-insensitive substring match).
    languages: Preferred language codes in priority order. Defaults to ["en"].

This is a heuristic, not real chapter data: it splits wherever the gap between two consecutive
caption snippets exceeds `gap_seconds`, then merges any resulting chunk shorter than
`min_chunk_seconds` into its neighbor so chunks stay summarizable.

Args:
    video_url_or_id: Full YouTube URL or bare 11-char video ID.
    gap_seconds: Silence gap (seconds) between captions that triggers a new chunk boundary.
    min_chunk_seconds: Minimum chunk duration; shorter chunks get merged forward.
    languages: Preferred language codes in priority order. Defaults to ["en"].