| name | tiktok-transcript |
| description | Fetch TikTok transcripts/captions into cached local files, for a single video or all videos of a channel/user, falling back to local mlx-whisper transcription when a video has no native captions. Use when the user provides a TikTok URL, video ID, or @handle and asks to get, fetch, download, search, excerpt, summarize, or otherwise use TikTok transcripts/captions/subtitles. |
TikTok Transcript
Fetch TikTok captions with yt-dlp, save durable transcript artifacts, and keep the full transcript out of context unless the user explicitly asks to inspect it. Videos without native captions are transcribed locally with mlx-whisper (Apple Silicon).
This skill mirrors the workflow shape of the sibling youtube-transcript skill.
Workflow
- Resolve this skill directory and run the bundled script. Always single-quote TikTok URLs in zsh because
? can be treated as a glob.
- Fetch to local artifacts with
fetch (one video) or channel (a user's videos). Do not read transcript.md or transcript.json into context by default.
- Use
transcript.txt for summaries or other content-only work; it removes timestamps and is cheaper to read than transcript.md.
- Use
preview, search, excerpt, or bounded text output when later work needs only a small portion.
- Read the full transcript only when the task truly requires full-document reasoning and no smaller excerpt/search path is enough.
Commands
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py list 'https://www.tiktok.com/@user/video/VIDEO_ID'
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py fetch \
--output-dir tiktok-transcripts
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py channel @user -- 20
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py preview tiktok-transcripts/VIDEO_ID
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py search tiktok-transcripts/VIDEO_ID
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py excerpt tiktok-transcripts/VIDEO_ID \
--start 00:00:30 \
--end 00:01:10
python3 <this-skill-dir>/scripts/fetch-tiktok-transcript.py text tiktok-transcripts/VIDEO_ID --max-chars 4000
