Transcript

zeropointrepo/youtube-skills/clawhub/transcript

by zeropointrepo4f7994b94e7dNo license1K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 days ago

Use when the spoken content of a YouTube video is needed — even if not explicitly requested: pasted video links or IDs, requests to summarize, quote, transcribe, translate, fact-check, or extract anything from a video. Also use for research or learning when a video is the source. Not for uploads or account management.

Instructions onlyResearch & Analysis Writing & Content

AI-generated overview

Fetches YouTube video transcripts through the TranscriptAPI.com service for summarizing, quoting, translating or research.

What it does: This skill instructs an agent to call the TranscriptAPI.com YouTube transcript endpoint with a video URL or 11-character video ID. It returns the spoken content either as timestamped text or as JSON segments with start times and durations, optionally with video metadata such as title and author. It also documents required headers, request parameters and error handling.
When to use it: Use it when the spoken content of a YouTube video is needed, such as summarizing, quoting, transcribing, translating or fact-checking a video, or when a video is the source for research or learning. It is not intended for video uploads or account management.
Requirements: Internet access to transcriptapi.com and a TRANSCRIPT_API_KEY environment variable (a key starting with sk_, from a free account). Requests must send an Authorization bearer header and a User-Agent header. No additional runtimes or dependencies are needed, and the skill ships no scripts, only an auth-setup reference document.

Transcript

Fetch video transcripts via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md [blocked] 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.

GET /api/v2/youtube/transcript

bash

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Accepts: full URLs (youtube.com/watch?v=ID), short URLs (youtu.be/ID), shorts (youtube.com/shorts/ID), or bare video IDs.

Default: Always use format=text&include_timestamp=true&send_metadata=true unless user specifies otherwise.

Response (format=json):

json

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": [    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }  ],  "metadata": {    "title": "Rick Astley - Never Gonna Give You Up",    "author_name": "Rick Astley",    "author_url": "https://www.youtube.com/@RickAstley",    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"  }}

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": [    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }  ],  "metadata": {    "title": "Rick Astley - Never Gonna Give You Up",    "author_name": "Rick Astley",    "author_url": "https://www.youtube.com/@RickAstley",    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"  }}

Response (format=text):

json

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",  "metadata": {...}}

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",  "metadata": {...}}

Errors

Code	Meaning	Action
401	Bad API key	Check key or re-setup
402	No credits	Top up at transcriptapi.com/billing
403/1010	Cloudflare block	Add or fix User-Agent header
404	No transcript	Video may not have captions enabled
408	Timeout	Retry once after 2s
429	Rate limited	Wait and retry

Tips

For long videos, summarize key points first, offer full transcript on request.
Use format=json when you need precise timestamps for quoting specific moments.
Use include_timestamp=false for clean text suitable for translation or analysis.
1 credit per successful request. Errors don't cost credits.
Free tier: 100 credits, 300 req/min.

Source and attribution

Source:zeropointrepo/youtube-skillsinclawhub/transcriptat commit4f7994b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Param	Required	Default	Values
`video_url`	yes	—	YouTube URL or 11-char video ID
`format`	no	`json`	`json`, `text`
`include_timestamp`	no	`true`	`true`, `false`
`send_metadata`	no	`false`	`true`, `false`

Transcript

Transcript

Setup

Required Headers

GET /api/v2/youtube/transcript

Errors

Tips

Source and attribution

More from zeropointrepo/youtube-skills

Yt

Youtube Search

Youtube Playlist

Youtube Full

Youtube Data

Youtube Channels

More in Research & Analysis

Sector Overview

Sector Overview

Idea Generation

Competitive Analysis

Equity Research

Sector Overview