YouTube Transcript (Captions-Only)

This skill extracts transcripts from existing YouTube captions.

Primary behavior

• - Prefer manual subtitles when available.
• Fall back to auto-generated captions.
• Output either:

• - Cache results locally in SQLite for speed.

Reliability behavior

• - If YouTube blocks anonymous access (bot-check), provide cookies.txt.
• If yt-dlp reports no captions for a video, the script tries a fallback:

This published version intentionally does not call third-party transcript providers.

Privacy note: This published version only contacts YouTube directly (via yt-dlp and the transcript panel fallback). It does not send video IDs/URLs to third-party transcript providers.

Cookies: Cookies are treated as secrets.

• - The script supports --cookies / YT_TRANSCRIPT_COOKIES, but does not auto-load cookies from inside the skill directory.
• Store cookies under ~/.config/yt-transcript/.

Path safety: This skill restricts --cookies and --cache paths to approved directories.

• - cookies allowed under: INLINECODE9
• cache allowed under: {baseDir}/cache/ and INLINECODE11

How to run

Script path:

• - INLINECODE12

Typical usage:

• - INLINECODE13
• INLINECODE14
• INLINECODE15
• INLINECODE16

Cookies (optional, but often required on VPS IPs):

• - INLINECODE17
• or set env var: INLINECODE18

Publishing safety note: Cookies are optional, so YT_TRANSCRIPT_COOKIES is intentionally not required by skill metadata. Only set it if you need authenticated access.

Best practice: store cookies outside the skill folder (so you never accidentally publish them), e.g. ~/.config/yt-transcript/youtube-cookies.txt, and point to it via --cookies or YT_TRANSCRIPT_COOKIES.

What the script returns

JSON mode (default)

• - video_id: 11-char id
• INLINECODE24: chosen language
• INLINECODE25: manual | auto | INLINECODE28
• INLINECODE29: list of { start, duration, text } (or text-only when --no-ts)

Text mode (--text)

• - By default timestamps are included as [12.34s].
• Use --no-ts to output only the text lines.

Caching

Default cache DB:

• - INLINECODE35

Cache key includes:

• - video_id, lang, source, include_timestamp, INLINECODE40

Cookie handling (important)

• - Cookies must be in Netscape cookies.txt format.
• Treat cookies as secrets.
• Never commit / publish cookies to ClawHub.

Recommended local path (ignored by git/publish):

• - {baseDir}/cache/youtube-cookies.txt (chmod 600)

Notes (safety + reliability)

• - Only accept a YouTube URL or an 11-character video ID.
• Do not forward arbitrary user-provided flags into the command.
• If yt-dlp is missing, instruct the user to install it (recommended):