Skip to content
Skills Library
Data & analytics · Conversion & formats

youtube-transcript

/youtube-transcript

Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).

Repository
skills ↗
Licence
MIT
Last repository change
03.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
1
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).

Original author description

Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).

How it works

  1. When to use it
  2. Prerequisites
  3. Cost
  4. Workflow
  5. MCP instead of the CLI
  6. Troubleshooting
Original SKILL.md headings · 83 lines, 732 words
SKILL.md preview
---
name: youtube-transcript
description: Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).
license: MIT
metadata:
  author: Arcadium Data
  author_url: https://arcadiumdata.io
  category: content
  keywords: "youtube transcript, youtube captions, youtube subtitles, srt, vtt, youtube-transcript-api, RequestBlocked, video summary, timestamps, channel transcripts"
  apify-actors: "arcadium/youtube-transcripts"
---

# YouTube transcript

Transcripts of YouTube videos, fetched in the Apify cloud and returned as one JSON row per video.

**Disclosure:** the actor this skill runs is built and sold by Arcadium Data, the author of this skill. You pay Apify per transcript delivered (see Cost). No affiliate codes are used.

## When to use it

- The user gives one or more YouTube links or video IDs and wants the text, a summary, quotes or timestamps.
- The user wants the transcripts of a channel or playlist (newest first, optional date range).
- A local tool fails: `youtube-transcript-api` raises `RequestBlocked` or `IpBlocked` (YouTube blocks most cloud-provider IPs, as that library's README explains), or `yt-dlp` asks to sign in to confirm you are not a bot. If a local tool works for the user, it is fine to keep using it; this skill is for when it does not.

Out of scope:

- Videos without captions: the actor does not download or transcribe audio.
- Age-restricted and members-only videos (they need a signed-in account; the actor never logs in).
- Comments, video or audio downloads. For a broad topic search across many videos, use the `youtube-transcript-research` skill.

## Prerequisites

- Apify account and `APIFY_TOKEN`, or `apify login`. Apify CLI (`npm i -g apify-cli`) or the Apify MCP server (`https://mcp.apify.com`).

## Cost

Free Apify plan prices; paid plans pay less. Videos without captions, private, age-restricted or missing videos, repeats and error rows are free.

| Actor | Charged event | Free plan | Start fee per run |
| --- | --- | --- | --- |
| `arcadium/youtube-transcripts` | `transcript` | $2.48 per 1,000 | $0.001 |

Worked example: 10 videos in one run = 10 x $0.00248 + $0.001 = **about $0.026**.

## Workflow

### 1. Build the input

<!-- input: youtube-transcripts -->
```json
{
  "urls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "languages": ["en"],
  "includeSegments": true
}
```

- `urls`: video links, `youtu.be` links, Shorts links, bare video IDs (`dQw4w9WgXcQ`), channel URLs (`https://www.youtube.com/@kurzgesagt`) or playlist URLs. Put every video in one run (one start fee).
- Channels and playlists: add `maxVideosPerSource` (for example 20) and optionally `publishedAfter` / `publishedBefore` (`YYYY-MM-DD`).
- `languages`: in order of preference; `en` also matches `en-US` and `en-GB`. If none exists, the original spoken language is returned and `languageMatched` is `false`.
- `captionType`: `any` (default, creator captions first), `manual` or `auto`.
- `subtitleFormat`: `srt` or `vtt` adds a ready subtitle file to each row.
- `includeSegments: false` when only the plain text is needed (smaller output).

From youtube-transcript-api: `YouTubeTranscriptApi().fetch(video_id, languages=["de", "en"])` maps to `{"urls": [video_id], "languages": ["de", "en"]}`. The segments use the same `text`, `start` and `duration` fields.

### 2. Run it

    apify actors call arcadium/youtube-transcripts --input-file transcripts.json --user-agent arcadium-skills/youtube-transcript --json 2>/dev/null
    apify datasets get-items DATASET_ID --format json --user-agent arcadium-skills/youtube-transcript 2>/dev/null > transcripts.out.json

(`DATASET_ID` is `.defaultDatasetId` from the call output.) Without the CLI, one HTTP call returns the rows: `POST https://api.apify.com/v2/acts/arcadium~youtube-transcripts/run-sync-get-dataset-items` with header `Authorization: Bearer $APIFY_TOKEN` and the input as the JSON body. In Python: `ApifyClient(token).actor("arcadium/youtube-transcripts").call(run_input=...)`, then iterate `client.dataset(run.default_dataset_id).iterate_items()` (apify-client 3.x).

### 3. Read the rows

Filter on `rowType` first.

- `transcript` rows: `videoId`, `url`, `title`, `channelName`, `publishDate`, `durationSeconds`, `viewCount`, `transcript` (full text), `segments` (`start`, `duration` in seconds, `text`), `wordCount`, `language`, `isAutoGenerated`, `languageMatched`, `availableLanguages`, and `srt` / `vtt` when asked.
- `error` rows (free): `code` and `message`, plus the `input` they are about.

For a summary or quotes, cite timestamps as `<url>&t=<start>s` using the `start` of the segment (rounded down). Quote the text exactly and say when captions are auto-generated (`isAutoGenerated: true`): they have no punctuation and names or numbers may be misheard. For long transcripts, use `wordCount` to decide whether to summarise in chunks.

## MCP instead of the CLI

With the Apify MCP server connected, call `arcadium/youtube-transcripts` with the same input. To expose only this actor as a tool: `https://mcp.apify.com/?tools=arcadium/youtube-transcripts`.

## Troubleshooting

- `no_match`: the video has no captions (or none of the requested `captionType`). Nothing to retry.
- `not_found`: private, removed or unknown video or channel.
- `unavailable`: age-restricted, members-only, not yet published, or a temporary error; retry later only for the temporary case.
- `blocked`: YouTube still refused after all retries; run again later.
- `languageMatched: false`: the requested language does not exist; check `availableLanguages`. `translateTo` returns a native track in that language only when the video has one, because YouTube currently refuses its machine translation to anonymous clients (`translationStatus: "unavailable"`); translate the text yourself in that case.

Versions

RepositoryScoreLicence
This page · arcadiumdata/skills100MIT
tubeagentkit/youtube-transcript-skills100MIT
davepoon/buildwithclaude100MIT
silvio-l/skills100MIT
mthines/agent-skills100MIT
glebis/claude-skills100MIT
maxouf/sherwood-skills100MIT
mkurman/zorai100MIT
qa-aman/claude-skills100MIT

Database snapshot: 13.11.2026 · package version 1f1f89782d79 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100youtube-research
    Pulls structured YouTube data — video and channel details, transcripts/captions, comments, playlists, and search — via the Crawlora API as clean JSON, with no yt-dlp or HTML scraping. Use when the user provides a YouTube URL or asks for a transcript, comments, channel/video…
  • 100youtube-transcription
    Transcribe YouTube videos to text using OpenAI Whisper and yt-dlp. Use when the user wants to get a transcript from a YouTube video, generate subtitles, convert video speech to text, create SRT/VTT captions, or extract spoken content from YouTube URLs.
  • 100youtube-transcript-research
    Research a topic from YouTube videos - search YouTube or list a channel, pull full transcripts with timestamps, and write a cited summary of what the videos claim, where they agree and disagree, with links that jump to the exact second. Use when the user asks what YouTubers say…
  • 100ytapi-youtube-transcript
    Get the transcript, subtitles or captions of a YouTube video (plain text, Markdown, timestamped JSON, SRT or VTT, any language) through the YTAPI API. Use when the user shares a YouTube link or video ID and wants what was said: to read, summarize, quote, translate or search it.…
  • 100yt-transcript
    Fetch transcripts from YouTube videos. Use when user asks to get, download, extract, or retrieve YouTube video transcripts, captions, or subtitles. Also activates for video content analysis, summarizing YouTube videos, or processing video content.
  • 100youtube-full
    Use when the user needs YouTube transcripts, video search, channel browsing, playlist extraction, or content monitoring. Trigger phrases: 'get the transcript for', 'search YouTube for', 'what are the latest videos on', 'list this playlist', 'monitor this channel', or any request…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.