video-transcript

Name: video-transcript
Author: ZeroPointRepo

484installs31forks

How to install video-transcript?

zeropointrepo/youtube-skills/video-transcript

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

Installs into the current project.

Summary

Use when video content needs to be extracted as text: pasted YouTube links or IDs, requests to transcribe, summarize, quote, translate, convert video to text, or extract information from video content. Also use when a user shares a video URL without explanation and wants to know

Files · 1

View on GitHub

SKILL.md

1	# Video Transcript
2
3	Extract transcripts from videos 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` (structured), `text` (readable) \|
29	\| `include_timestamp` \| no \| `true` \| `true`, `false` \|
30	\| `send_metadata` \| no \| `false` \| `true`, `false` \|
31
32	Accepted URL formats:
33
34	- `https://www.youtube.com/watch?v=VIDEO_ID`
35	- `https://youtu.be/VIDEO_ID`
36	- `https://youtube.com/shorts/VIDEO_ID`
37	- Bare video ID: `dQw4w9WgXcQ`
38
39	Response (`format=text&send_metadata=true`):
40
41	```json
42	{
43	"video_id": "dQw4w9WgXcQ",
44	"language": "en",
45	"transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
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=json`):
56
57	```json
58	{
59	"video_id": "dQw4w9WgXcQ",
60	"language": "en",
61	"transcript": [
62	{ "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
63	{ "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
64	]
65	}
66	```
67
68	## Tips
69
70	- Summarize long transcripts into key points first, offer full text on request.
71	- Use `format=json` when you need precise timestamps for quoting specific moments.
72	- Use `send_metadata=true` to get video title and channel for context.
73	- Works with YouTube Shorts too.
74
75	## Errors
76
77	\| Code \| Meaning \| Action \|
78	\| -------- \| ---------------- \| ---------------------------------------------- \|
79	\| 401 \| Bad API key \| Check key or re-setup \|
80	\| 402 \| No credits \| Top up at transcriptapi.com/billing \|
81	\| 403/1010 \| Cloudflare block \| Add or fix User-Agent header \|
82	\| 404 \| No transcript \| Video may not have captions enabled \|
83	\| 408 \| Timeout \| Retry once after 2s \|
84
85	1 credit per successful request. Errors don't consume credits. Free tier: 100 credits, 300 req/min.

People who liked this also viewed

6 picks

Type

video-transcript

484installs31forks

View on GitHub

How to install video-transcript?

zeropointrepo/youtube-skills/video-transcript

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Video Transcript
2
3	Extract transcripts from videos 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` (structured), `text` (readable) \|
29	\| `include_timestamp` \| no \| `true` \| `true`, `false` \|
30	\| `send_metadata` \| no \| `false` \| `true`, `false` \|
31
32	Accepted URL formats:
33
34	- `https://www.youtube.com/watch?v=VIDEO_ID`
35	- `https://youtu.be/VIDEO_ID`
36	- `https://youtube.com/shorts/VIDEO_ID`
37	- Bare video ID: `dQw4w9WgXcQ`
38
39	Response (`format=text&send_metadata=true`):
40
41	```json
42	{
43	"video_id": "dQw4w9WgXcQ",
44	"language": "en",
45	"transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
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=json`):
56
57	```json
58	{
59	"video_id": "dQw4w9WgXcQ",
60	"language": "en",
61	"transcript": [
62	{ "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
63	{ "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
64	]
65	}
66	```
67
68	## Tips
69
70	- Summarize long transcripts into key points first, offer full text on request.
71	- Use `format=json` when you need precise timestamps for quoting specific moments.
72	- Use `send_metadata=true` to get video title and channel for context.
73	- Works with YouTube Shorts too.
74
75	## Errors
76
77	\| Code \| Meaning \| Action \|
78	\| -------- \| ---------------- \| ---------------------------------------------- \|
79	\| 401 \| Bad API key \| Check key or re-setup \|
80	\| 402 \| No credits \| Top up at transcriptapi.com/billing \|
81	\| 403/1010 \| Cloudflare block \| Add or fix User-Agent header \|
82	\| 404 \| No transcript \| Video may not have captions enabled \|
83	\| 408 \| Timeout \| Retry once after 2s \|
84
85	1 credit per successful request. Errors don't consume credits. Free tier: 100 credits, 300 req/min.

People who liked this also viewed

6 picks

Type