Pasted video links or IDs, @handles, quick video lookups

by ZeroPointRepo · MIT license · ★ 945 on GitHub · v1.5.2 · updated Sep 22

Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers…

---
name: yt
description: "Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for uploads or account management."
version: "1.5.2"
user-invocable: true
compatibility: Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.
required_environment_variables:
  - name: TRANSCRIPT_API_KEY
    prompt: Your TranscriptAPI key (starts with sk_)
    help: Free account at https://transcriptapi.com — 100 credits, no card required. Or let the agent create one for you.
    required_for: all API requests
metadata: {"openclaw":{"emoji":"▶️","requires":{"env":["TRANSCRIPT_API_KEY"]},"primaryEnv":"TRANSCRIPT_API_KEY","homepage":"https://transcriptapi.com"},"hermes":{"tags":["youtube","transcripts","video","search","channels","utility"],"category":"media"}}
---

# yt

Quick YouTube lookup via [TranscriptAPI.com](https://transcriptapi.com).

Overview

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

Manual install (npx, ZIP)

Claude Codenpx skills add ZeroPointRepo/youtube-skills --skill yt -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/ZeroPointRepo/youtube-skills/tar.gz/4f7994b94e7d \
  | tar -xz -C ~/.claude/skills --strip-components=2 youtube-skills-4f7994b94e7d/skills/yt

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/8397aa547a8aab67360a/yt.zip" -OutFile "$env:TEMP\yt.zip"; Expand-Archive "$env:TEMP\yt.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.7 KB
references/2 files · 8.2 KB

Read the files here

ZeroPointRepo/4f7994b3 files

SKILL.md3.7 KB

SKILL.md

Show the full text91 lines

yt/SKILL.md91 lines · 3.7 KB

PreviewCode

Outline

RawView on GitHub

yt

Quick YouTube lookup via TranscriptAPI.com.

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

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

Search — 1 credit

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

Param	Default	Values
`q`	—	1-200 chars (required)
`type`	`video`	`video`, `channel`
`limit`	`20`	1-50

Channel latest — FREE

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

Returns last 15 videos with exact view counts and publish dates. Accepts @handle, channel URL, or UC... ID.

Resolve handle — FREE

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

Use to convert @handle to UC... channel ID.

Errors

Code	Meaning	Action
401	Bad API key	Check key
402	No credits	transcriptapi.com/billing
403/1010	Cloudflare block	Add or fix User-Agent header
404	Not found	No captions or resource doesn't exist
408	Timeout	Retry once

Free tier: 100 credits. Search and transcript cost 1 credit. Channel latest and resolve are free.

Copy-paste examples

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

1	---
2	name: yt
3	description: "Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for uploads or account management."
4	version: "1.5.2"
5	user-invocable: true
6	compatibility: Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.
7	required_environment_variables:
8	- name: TRANSCRIPT_API_KEY
9	prompt: Your TranscriptAPI key (starts with sk_)
10	help: Free account at https://transcriptapi.com — 100 credits, no card required. Or let the agent create one for you.
11	required_for: all API requests
12	metadata: {"openclaw":{"emoji":"▶️","requires":{"env":["TRANSCRIPT_API_KEY"]},"primaryEnv":"TRANSCRIPT_API_KEY","homepage":"https://transcriptapi.com"},"hermes":{"tags":["youtube","transcripts","video","search","channels","utility"],"category":"media"}}
13	---
14
15	# yt
16
17	Quick YouTube lookup via [TranscriptAPI.com](https://transcriptapi.com).
18
19	## Setup
20
21	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.
22
23	## Required Headers
24
25	Every request needs two headers:
26
27	- Authorization: `Bearer $TRANSCRIPT_API_KEY`
28	- 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.
29
30	## API Reference
31
32	Full OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas.
33
34	## Transcript — 1 credit
35
36	```http
37	GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true
38	Authorization: Bearer $TRANSCRIPT_API_KEY
39	User-Agent: YourAgent/1.0
40	```
41
42	## Search — 1 credit
43
44	```http
45	GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10
46	Authorization: Bearer $TRANSCRIPT_API_KEY
47	User-Agent: YourAgent/1.0
48	```
49
50	\| Param \| Default \| Values \|
51	\| ------- \| ------- \| ---------------------- \|
52	\| `q` \| — \| 1-200 chars (required) \|
53	\| `type` \| `video` \| `video`, `channel` \|
54	\| `limit` \| `20` \| 1-50 \|
55
56	## Channel latest — FREE
57
58	```http
59	GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
60	Authorization: Bearer $TRANSCRIPT_API_KEY
61	User-Agent: YourAgent/1.0
62	```
63
64	Returns last 15 videos with exact view counts and publish dates. Accepts `@handle`, channel URL, or `UC...` ID.
65
66	## Resolve handle — FREE
67
68	```http
69	GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
70	Authorization: Bearer $TRANSCRIPT_API_KEY
71	User-Agent: YourAgent/1.0
72	```
73
74	Use to convert @handle to UC... channel ID.
75
76	## Errors
77
78	\| Code \| Meaning \| Action \|
79	\| -------- \| ---------------- \| ---------------------------------------------- \|
80	\| 401 \| Bad API key \| Check key \|
81	\| 402 \| No credits \| transcriptapi.com/billing \|
82	\| 403/1010 \| Cloudflare block \| Add or fix User-Agent header \|
83	\| 404 \| Not found \| No captions or resource doesn't exist \|
84	\| 408 \| Timeout \| Retry once \|
85
86	Free tier: 100 credits. Search and transcript cost 1 credit. Channel latest and resolve are free.
87
88	## Copy-paste examples
89
90	Every request in this file as a ready-to-run one-liner: [references/curl-examples.md](references/curl-examples.md)
91