Agent skill

YouTube Transcripts and Search

by ZeroPointRepo in ZeroPointRepo/youtube-skills

Fetches YouTube transcripts and searches videos, channels and playlists through the TranscriptAPI.com service.

MITAuto-check passedKnowledge Management

Install YouTube Transcripts and Search

skills CLI
$ npx skills add ZeroPointRepo/youtube-skills --skill youtube-full -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZeroPointRepo/youtube-skills youtube-full --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZeroPointRepo/youtube-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube-full .claude/skills/youtube-full && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-full
GitHub stars
1k
Used in
1 other repo
Token cost
~3.1k tokens
SKILL.md length
637 words
Files
3 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Fetches YouTube transcripts and searches videos, channels and playlists through the TranscriptAPI.com service.

  • Summarizing a YouTube video from a pasted link
  • SKILL.md covers Setup, Required Headers, API Reference and Transcript — 1 credit, plus 9 more sections
  • Reaches transcriptapi.com; needs TRANSCRIPT_API_KEY
  • Pulling quotes or timestamps from a lecture or talk transcript

What it does

The skill wraps TranscriptAPI.com behind plain HTTP requests: transcripts as JSON or text with optional timestamps and metadata, video info and metadata, video and channel search, channel browsing, playlists and search within a channel. Every request needs an `Authorization` bearer header built from `TRANSCRIPT_API_KEY` and a `User-Agent` naming the agent, since a bare default is blocked with a 403.

If the key is not set, the agent reads `references/auth-setup.md` to get and store one. Transcript calls cost one credit and search costs one credit per page, while listing available transcript languages is free; the full parameter list lives in the service's OpenAPI spec, and `references/curl-examples.md` has sample requests. It is meant to trigger whenever YouTube could help, such as pasted links, video IDs or @handles, summaries, quotes, tutorials or product reviews, and it is not for uploads or account management.

When your agent uses it

  • Summarizing a YouTube video from a pasted link
  • Pulling quotes or timestamps from a lecture or talk transcript
  • Searching YouTube for tutorials, reviews or expert discussions on a topic
  • Browsing a creator's channel or playlist by @handle

Example prompts

  • “Summarize this video and give me the key quotes with timestamps.”
  • “Find recent YouTube videos about Postgres indexing and list three that match closely.”
  • “Get the transcript for this lecture and translate the first section into Spanish.”

Requirements

  • A TranscriptAPI.com key in `TRANSCRIPT_API_KEY`
  • Internet access to transcriptapi.com
  • Compatibility (from SKILL.md): Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.

What it can do on your machine

Read from SKILL.md and the folder at commit 4f7994b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are http and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • transcriptapi.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TRANSCRIPT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.

    From compatibility in the SKILL.md frontmatter.

Context cost

YouTube Transcripts and Search loads about 3.1k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 142 tokens; SKILL.md has 637 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~142
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZeroPointRepo/youtube-skills at commit 4f7994b, republished under its MIT licence (© ZeroPointRepo). 637 words, ~3,067 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-full/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
youtube-full
description
Use when YouTube is or could be relevant — even if not mentioned: pasted video/channel/playlist links, video IDs, @handles, creator lookups, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews, how-to guides, new product announcements, first looks, or anything where video content is fresher or richer than text search. Covers transcripts, video/channel search, channel browsing, playlists, and within-channel search. Not for uploads, account management, or written-source-only research.
compatibility
Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.
version
1.6.2
user-invocable
true

YouTube Full

Complete YouTube toolkit via TranscriptAPI.com. Everything in one skill.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md and follow the instructions there to get and store the key.

Required Headers

Every request needs two headers:

  • Authorization: Bearer $TRANSCRIPT_API_KEY
  • User-Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0, ClaudeCode/1.0). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.

API Reference

Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.

Transcript — 1 credit

http
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
ParamRequiredDefaultValues
video_urlyes—YouTube URL or 11-char video ID
formatnojsonjson, text
include_timestampnotruetrue, false
send_metadatanofalsetrue, false

Response (format=json):

json
{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],
  "metadata": { "title": "...", "author_name": "...", "author_url": "..." }
}

Video Info & Metadata

http
# Free — languages available for the transcript endpoint
GET https://transcriptapi.com/api/v2/youtube/info?video_url=VIDEO_URL
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# 1 credit — rich metadata (views, likes, description, duration, tags)
GET https://transcriptapi.com/api/v2/youtube/video/metadata?video_url=VIDEO_URL&include=details,related
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

include on video/metadata accepts details and/or related. Naming: /video/metadata was previously /video/info — the old path still works but is deprecated.

Search — 1 credit/page

http
# Videos
GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Channels, playlists, or movies
GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
ParamRequiredDefaultValidation
qyes—1-200 chars
typenovideovideo, channel, playlist, movie
sortnorelevancerelevance, views (first page only)
upload_dateno—hour, today, week, month, year (videos, first page)
durationno—short, medium, long (videos, first page)
featuresno—e.g. hd,subtitles,cc (first page)
limitno201-50

Channels

All channel endpoints accept channel — an @handle, channel URL, or UC... channel ID. No need to resolve first.

Resolve handle — FREE
http
GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Response: {"channel_id": "UC...", "resolved_from": "@TED"}

Latest 15 videos — FREE
http
GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Returns exact viewCount and ISO published timestamps.

Channel feed (videos/shorts/streams) — 1 credit/page
http
# First page (100 items, tab defaults to "videos")
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&tab=videos
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Most-viewed first (channel Videos tab, ~30 items)
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Next pages (repeat the same tab AND sort)
GET https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popular
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Provide exactly one of channel or continuation. tab is videos (default), shorts, or streams. Response includes continuation_token and has_more.

Sorting. Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit.

When paging, send the same sort on each request.

Item fields. Every item carries members_only, true only when YouTube badges it "Members only", and those items have no viewCountText. tab=streams items carry lengthText and publishedTimeText (for example Streamed 2 years ago); tab=shorts returns null for both, because YouTube's Shorts grid publishes neither. On the channel-tab feeds (tab=videos with sort, tab=shorts, tab=streams) channelId, channelTitle, channelHandle and index are null.

Search within channel — 1 credit
http
GET https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=QUERY&limit=30
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
Show full SKILL.md (253 more words)Show less
Channel profile — 1 credit
http
GET https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Returns title, handle, verified flag, subscriber/video counts, description, tags, thumbnails, banners, and availableTabs.

Channel playlists — 1 credit/page
http
GET https://transcriptapi.com/api/v2/youtube/channel/playlists?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Returns each playlist's playlistId, title, url, videoCountText — feed a playlistId into the Playlists endpoint below.

Channel community posts — 1 credit/page
http
GET https://transcriptapi.com/api/v2/youtube/channel/posts?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
Channel curated sections — 1 credit
http
GET https://transcriptapi.com/api/v2/youtube/channel/sections?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

tab is featured (default, Home page), podcasts, or releases.

Playlists — 1 credit/page

Accepts playlist — a YouTube playlist URL or playlist ID.

http
# First page
GET https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Next pages
GET https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Valid ID prefixes: PL, UU, LL, FL, OL. Response includes playlist_info, results, continuation_token, has_more.

Credit Costs

EndpointCost
transcript1
infofree
video/metadata1
search1/page
channel/resolvefree
channel/info1
channel/latestfree
channel/videos1/page
channel/search1
channel/playlists1/page
channel/posts1/page
channel/sections1
playlist/videos1/page

Validation Rules

FieldRule
channel@handle, channel URL, or UC... ID
playlistPlaylist URL or ID (PL/UU/LL/FL/OL prefix)
q1-200 chars
type (search)video (default), channel, playlist, movie
tab (channel/videos)videos (default), shorts, streams
sort (channel/videos)latest, popular, oldest (omit for the uploads feed)
tab (channel/sections)featured (default), podcasts, releases
include (video/metadata)details, related (comma-separated)
limit1-50

Errors

CodeMeaningAction
401Bad API keyCheck key
402No creditstranscriptapi.com/billing
403/1010Cloudflare blockAdd or fix User-Agent header
404Not foundResource doesn't exist or no captions
408TimeoutRetry once after 2s
422Validation errorCheck param format
429Rate limitedWait, respect Retry-After

Typical Workflows

Research workflow: search → pick videos → fetch transcripts

http
# 1. Search
GET https://transcriptapi.com/api/v2/youtube/search?q=machine+learning+explained&limit=5
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# 2. Transcript
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Channel monitoring: latest (free) → transcript

http
# 1. Latest uploads (free — pass @handle directly)
GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# 2. Transcript of latest
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Free tier: 100 credits, 300 req/min. Starter ($5/mo): 1,000 credits.

Copy-paste examples

Every request in this file as a ready-to-run one-liner: references/curl-examples.md

© ZeroPointRepo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/youtube-full of ZeroPointRepo/youtube-skills.

  • SKILL.md
  • references/auth-setup.md
  • references/curl-examples.md

Open the folder on GitHubat commit 4f7994b

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ZeroPointRepo/youtube-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

YouTube Transcripts and Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

YouTube Transcripts and Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
YouTube Transcripts and Search this skillZeroPointRepo/youtube-skills1k1 repos~3.1kAutomated safety check: PassMIT
Video Lenskar2phi/video-lens113—~8.2kAutomated safety check: NotesMIT
YouTube Transcript ReformatterPrismer-AI/PrismerCloud1.6k2 repos~905Automated safety check: PassMIT
Youtube Transcript Extractor API Skillbrowser-act/skills6.1k1 repos~1.2kAutomated safety check: PassMIT
Youtube Transcriptbadlogic/pi-skills2.6k1 repos~179Automated safety check: PassMIT
Youtube Transcriptbrowser-act/skills6.1k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Video Lens

    kar2phi/video-lens

    Fetch a YouTube transcript and generate an executive summary, key points, and timestamped topic list as a polished HTML report.

    113 GitHub stars~8.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: notes
  • YouTube Transcript Reformatter

    Prismer-AI/PrismerCloud

    Fetches a YouTube transcript with a helper script and reshapes it into chapters, summaries, X threads, blog posts or timestamped quotes.

    1.6k GitHub starsUsed in 2 repos~905 tokens
    Knowledge ManagementAuto-check passed
  • This skill helps users automatically extract YouTube video transcripts and metadata via the BrowserAct API.

    6.1k GitHub starsUsed in 1 repo~1.2k tokens
    Knowledge ManagementAuto-check passed
  • Youtube Transcript

    badlogic/pi-skills

    Fetch transcripts from YouTube videos for summarization and analysis.

    2.6k GitHub starsUsed in 1 repo~179 tokens
    Knowledge ManagementAuto-check passed
  • Youtube Transcript

    browser-act/skills

    YouTube transcript extraction and content reformatting: given a YouTube video URL, opens the video's transcript panel, extracts all timestamped segments, and transforms the raw transcript into…

    6.1k GitHub stars~2.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Video Analysis

    ericosiu/ai-marketing-skills

    Analyze YouTube videos or local footage using transcripts first, with silent video checks for demonstrations, delivery, editing, and clip boundaries.

    3.6k GitHub stars~1.3k tokensUpdated 18 days ago
    Knowledge ManagementAuto-check passed

More from ZeroPointRepo/youtube-skills

All 12 skills in this repo
  • YouTube Captions Fetcher

    ZeroPointRepo/youtube-skills

    Fetches timestamped captions or plain-text transcripts for any YouTube video through the TranscriptAPI service, for reading, quoting, translating or accessibility.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Subtitle Fetcher

    ZeroPointRepo/youtube-skills

    Fetches timestamped subtitles for any YouTube video through TranscriptAPI, as clean text for reading and translation or timed JSON.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Transcript Fetcher

    ZeroPointRepo/youtube-skills

    Fetches the transcript of a YouTube video through TranscriptAPI.com so the agent can summarize, quote, translate or fact-check what was said.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube TranscriptAPI

    ZeroPointRepo/youtube-skills

    Pulls YouTube transcripts, searches videos and channels and browses playlists through the TranscriptAPI service with a single API key.

    1k GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • YouTube Video Transcript

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts through TranscriptAPI.com so an agent can summarize, quote or translate a video from a link or ID.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Data via TranscriptAPI

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts, video metadata, channel info, search results and playlists through the TranscriptAPI.com service, with no Google API quota or OAuth setup.

    1k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

Works with

Questions about YouTube Transcripts and Search

What does YouTube Transcripts and Search do?

Fetches YouTube transcripts and searches videos, channels and playlists through the TranscriptAPI.com service. com behind plain HTTP requests: transcripts as JSON or text with optional timestamps and metadata, video info and metadata, video and channel search, channel browsing, playlists and search within a channel. Every request needs an `Authorization` bearer header built from `TRANSCRIPT_API_KEY` and a `User-Agent` naming the agent, since a bare default is blocked with a 403.

When should I use YouTube Transcripts and Search?

YouTube Transcripts and Search fits situations like: summarizing a YouTube video from a pasted link; pulling quotes or timestamps from a lecture or talk transcript; searching YouTube for tutorials, reviews or expert discussions on a topic; browsing a creator's channel or playlist by @handle.

How do I install YouTube Transcripts and Search in Claude Code?

Run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-full -a claude-code`. Or copy the skill folder (skills/youtube-full in ZeroPointRepo/youtube-skills) into .claude/skills/youtube-full in your project. Claude Code loads it when a task matches its description.

How do I install YouTube Transcripts and Search in Codex?

Run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-full -a codex`. Or copy the skill folder (skills/youtube-full in ZeroPointRepo/youtube-skills) into .agents/skills/youtube-full in your project. Codex loads it when a task matches its description.

Can I use YouTube Transcripts and Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-full -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-full, .gemini/skills/youtube-full, .github/skills/youtube-full and .opencode/skills/youtube-full in your project.

What does YouTube Transcripts and Search need to run?

Going by SKILL.md and its folder, YouTube Transcripts and Search needs credentials named TRANSCRIPT_API_KEY. Our summary lists: A TranscriptAPI.com key in `TRANSCRIPT_API_KEY`; Internet access to transcriptapi.com. Compatibility (from SKILL.md): Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed..

Does YouTube Transcripts and Search access the network?

SKILL.md names 1 domain. In commands or code: transcriptapi.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is YouTube Transcripts and Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does YouTube Transcripts and Search use?

YouTube Transcripts and Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does YouTube Transcripts and Search use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to YouTube Transcripts and Search?

Skills that share tags, products or a category with YouTube Transcripts and Search: Video Lens (kar2phi/video-lens, 113 stars), YouTube Transcript Reformatter (Prismer-AI/PrismerCloud, 1.6k stars), Youtube Transcript Extractor API Skill (browser-act/skills, 6.1k stars) and Youtube Transcript (badlogic/pi-skills, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains YouTube Transcripts and Search?

ZeroPointRepo (a GitHub organization) maintains it in ZeroPointRepo/youtube-skills, which has 1,040 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 6, 2026.

Source: ZeroPointRepo/youtube-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.