transcript

Name: transcript
Author: ZeroPointRepo

396installs31forks

How to install transcript?

zeropointrepo/youtube-skills/transcript

$npx -y skills add ZeroPointRepo/youtube-skills --skill transcript

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

1	# Transcript
2
3	Fetch video transcripts via [TranscriptAPI.com](https://transcriptapi.com).
4
5	## Setup
6
7	If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.
8
9	## Required Headers
10
11	Every request needs two headers:
12
13	- Authorization: `Bearer $TRANSCRIPT_API_KEY`
14	- 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.
15
16	## GET /api/v2/youtube/transcript
17
18	```bash
19	curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
20	?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
21	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
22	-H "User-Agent: YourAgent/1.0"
23	```
24
25	\| Param \| Required \| Default \| Values \|
26	\| ------------------- \| -------- \| ------- \| ------------------------------- \|
27	\| `video_url` \| yes \| — \| YouTube URL or 11-char video ID \|
28	\| `format` \| no \| `json` \| `json`, `text` \|
29	\| `include_timestamp` \| no \| `true` \| `true`, `false` \|
30	\| `send_metadata` \| no \| `false` \| `true`, `false` \|
31
32	Accepts: full URLs (`youtube.com/watch?v=ID`), short URLs (`youtu.be/ID`), shorts (`youtube.com/shorts/ID`), or bare video IDs.
33
34	Default: Always use `format=text&include_timestamp=true&send_metadata=true` unless user specifies otherwise.
35
36	Response (`format=json`):
37
38	```json
39	{
40	"video_id": "dQw4w9WgXcQ",
41	"language": "en",
42	"transcript": [
43	{ "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
44	{ "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
45	],
46	"metadata": {
47	"title": "Rick Astley - Never Gonna Give You Up",
48	"author_name": "Rick Astley",
49	"author_url": "https://www.youtube.com/@RickAstley",
50	"thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
51	}
52	}
53	```
54
55	Response (`format=text`):
56
57	```json
58	{
59	"video_id": "dQw4w9WgXcQ",
60	"language": "en",
61	"transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
62	"metadata": {...}
63	}
64	```
65
66	## Errors
67
68	\| Code \| Meaning \| Action \|
69	\| -------- \| ---------------- \| ---------------------------------------------- \|
70	\| 401 \| Bad API key \| Check key or re-setup \|
71	\| 402 \| No credits \| Top up at transcriptapi.com/billing \|
72	\| 403/1010 \| Cloudflare block \| Add or fix User-Agent header \|
73	\| 404 \| No transcript \| Video may not have captions enabled \|
74	\| 408 \| Timeout \| Retry once after 2s \|
75	\| 429 \| Rate limited \| Wait and retry \|
76
77	## Tips
78
79	- For long videos, summarize key points first, offer full transcript on request.
80	- Use `format=json` when you need precise timestamps for quoting specific moments.
81	- Use `include_timestamp=false` for clean text suitable for translation or analysis.
82	- 1 credit per successful request. Errors don't cost credits.
83	- Free tier: 100 credits, 300 req/min.

People who liked this also viewed

6 picks

Type

transcript

396installs31forks

View on GitHub

How to install transcript?

zeropointrepo/youtube-skills/transcript

$npx -y skills add ZeroPointRepo/youtube-skills --skill transcript

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Transcript
2
3	Fetch video transcripts via [TranscriptAPI.com](https://transcriptapi.com).
4
5	## Setup
6
7	If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.
8
9	## Required Headers
10
11	Every request needs two headers:
12
13	- Authorization: `Bearer $TRANSCRIPT_API_KEY`
14	- 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.
15
16	## GET /api/v2/youtube/transcript
17
18	```bash
19	curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
20	?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
21	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
22	-H "User-Agent: YourAgent/1.0"
23	```
24
25	\| Param \| Required \| Default \| Values \|
26	\| ------------------- \| -------- \| ------- \| ------------------------------- \|
27	\| `video_url` \| yes \| — \| YouTube URL or 11-char video ID \|
28	\| `format` \| no \| `json` \| `json`, `text` \|
29	\| `include_timestamp` \| no \| `true` \| `true`, `false` \|
30	\| `send_metadata` \| no \| `false` \| `true`, `false` \|
31
32	Accepts: full URLs (`youtube.com/watch?v=ID`), short URLs (`youtu.be/ID`), shorts (`youtube.com/shorts/ID`), or bare video IDs.
33
34	Default: Always use `format=text&include_timestamp=true&send_metadata=true` unless user specifies otherwise.
35
36	Response (`format=json`):
37
38	```json
39	{
40	"video_id": "dQw4w9WgXcQ",
41	"language": "en",
42	"transcript": [
43	{ "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
44	{ "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
45	],
46	"metadata": {
47	"title": "Rick Astley - Never Gonna Give You Up",
48	"author_name": "Rick Astley",
49	"author_url": "https://www.youtube.com/@RickAstley",
50	"thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
51	}
52	}
53	```
54
55	Response (`format=text`):
56
57	```json
58	{
59	"video_id": "dQw4w9WgXcQ",
60	"language": "en",
61	"transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
62	"metadata": {...}
63	}
64	```
65
66	## Errors
67
68	\| Code \| Meaning \| Action \|
69	\| -------- \| ---------------- \| ---------------------------------------------- \|
70	\| 401 \| Bad API key \| Check key or re-setup \|
71	\| 402 \| No credits \| Top up at transcriptapi.com/billing \|
72	\| 403/1010 \| Cloudflare block \| Add or fix User-Agent header \|
73	\| 404 \| No transcript \| Video may not have captions enabled \|
74	\| 408 \| Timeout \| Retry once after 2s \|
75	\| 429 \| Rate limited \| Wait and retry \|
76
77	## Tips
78
79	- For long videos, summarize key points first, offer full transcript on request.
80	- Use `format=json` when you need precise timestamps for quoting specific moments.
81	- Use `include_timestamp=false` for clean text suitable for translation or analysis.
82	- 1 credit per successful request. Errors don't cost credits.
83	- Free tier: 100 credits, 300 req/min.

People who liked this also viewed

6 picks

Type