youtube-transcript-apilisted
Install: claude install-skill TranscriptDock/youtube-transcript-api
# YouTube transcripts with Transcript Dock
Every transcript is an asynchronous job: submit, wait, then read or export. Full reference: https://www.transcriptdock.com/docs/api-reference
## When to use
- A YouTube link (`watch?v=`, `youtu.be/`, `/shorts/`, `/live/`) and a request for its transcript, captions, subtitles, quotes or a summary.
- "Which languages does this video have captions in?"
- "Find videos about X" or "transcribe the latest videos on this channel or playlist".
Not for private, members only or age gated videos (they fail), translation (not offered) or speaker labels (not offered).
## Setup
- Base URL `https://www.transcriptdock.com`. Always `www`: the apex redirects and drops the `Authorization` header.
- Header `Authorization: Bearer $TRANSCRIPTDOCK_API_KEY` from the environment. Never print the key, put it in a URL or ask for it in chat. If it is missing, tell the user to create one at https://www.transcriptdock.com/dashboard.
- POST bodies are JSON with `Content-Type: application/json`.
## Step 1. Check the plan (free)
`GET /v1/capabilities` (with the key) shows `youtube.captions_only`, `youtube.auto` and `youtube.transcribe` for this plan. `GET /v1/usage` shows `plan` and `credits_remaining`. The free plan has captions only.
## Step 2. Submit captions first
```bash
KEY_ID="$(uuidgen 2>/dev/null || date +%s%N)" # generate ONCE per intended job and remember it
curl -sS -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer $