Youtube Full

zeropointrepo/youtube-skills/clawhub/youtube-full

作者 zeropointrepo4f7994b94e7d無授權條款1K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫2 天前更新

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.

AI 產生的概覽

透過 TranscriptAPI 服務取得 YouTube 字幕、影片中繼資料、搜尋結果、頻道內容與播放清單。

功能
此技能說明如何呼叫 TranscriptAPI.com 的 HTTP 端點取得 YouTube 資料:可附時間戳與中繼資料的影片字幕、影片中繼資料、跨影片/頻道/播放清單/電影的關鍵字搜尋、頻道解析、最新上傳、頻道內容串、頻道內搜尋、頻道簡介、播放清單、社群貼文與精選區塊。它提供請求參數、驗證規則、點數成本、錯誤碼與 curl 範例,產出供代理使用的字幕文字與 JSON 中繼資料。它僅有指示說明,未附任何指令碼。
適用情境
當任務涉及 YouTube 內容或可能因此受益時使用,例如貼上的影片、頻道或播放清單連結、影片 ID 或 @handle、影片摘要、引用、翻譯、主題研究、教學、演講、講座、專家討論、產品評測或操作指南。不適用於上傳、帳號管理,或僅以文字來源為主的調查。
執行需求
需要連線至 transcriptapi.com 的網路存取,以及 TRANSCRIPT_API_KEY 環境變數(免費帳號提供 100 點數);請求還需 Authorization bearer 標頭與可識別的 User-Agent 標頭。不需要其他執行環境或相依套件,也未附指令碼。

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 [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.

API Reference

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

Transcript — 1 credit

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"
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

bash
# Free — languages available for the transcript endpointcurl -s "https://transcriptapi.com/api/v2/youtube/info?video_url=VIDEO_URL" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# 1 credit — rich metadata (views, likes, description, duration, tags)curl -s "https://transcriptapi.com/api/v2/youtube/video/metadata\?video_url=VIDEO_URL&include=details,related" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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

bash
# Videoscurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Channels, playlists, or moviescurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

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

Latest 15 videos — FREE

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Returns exact viewCount and ISO published timestamps.

Channel feed (videos/shorts/streams) — 1 credit/page

bash
# First page (100 items, tab defaults to "videos")curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&tab=videos" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Most-viewed first (channel Videos tab, ~30 items)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pages (repeat the same tab AND sort)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\?channel=@TED&q=QUERY&limit=30" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel profile — 1 credit

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

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

Channel playlists — 1 credit/page

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/playlists?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/posts?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel curated sections — 1 credit

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/sections?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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.

bash
# First pagecurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pagescurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "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

bash
# 1. Searchcurl -s "https://transcriptapi.com/api/v2/youtube/search\?q=machine+learning+explained&limit=5" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcriptcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel monitoring: latest (free) → transcript

bash
# 1. Latest uploads (free — pass @handle directly)curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcript of latestcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

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

來源與署名

來源:zeropointrepo/youtube-skills位於clawhub/youtube-full提交4f7994b

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架