# mdtube

Swap or prefix the domain on any YouTube URL to get the video's metadata and
transcript in a form an agent can use directly.

    https://www.youtube.com/watch?v=VIDEO_ID
    https://mdyoutube.com/watch?v=VIDEO_ID     <- just put "md" in front
    https://mdtube/watch?v=VIDEO_ID

Browsers get a page with a Copy button. Everything else gets raw markdown.
Use ?raw=1 to force raw output, ?dl=1 to download a .md file.

## Options

    ?ts=0          drop timestamps (smallest output)
    ?ts=all        per-segment timestamps instead of per-paragraph
    ?meta=0        omit the YAML frontmatter
    ?desc=0        omit the video description
    ?transcript=0  metadata only
    ?format=       md | json | txt  (overrides the domain default)
    ?lang=es       prefer a caption language
    ?nocache=1     bypass the cache

## URL shapes

    /watch?v=ID   /shorts/ID   /live/ID   /embed/ID   /v/ID   /ID
    /?url=https://youtu.be/ID
    /share?url=…  share-sheet target

Unknown query params are ignored, so mobile share links (?si=…) pass through
harmlessly.

    GET /healthz    service and cache stats