youtube-full について
youtube-fullは、TranscriptAPI.com経由でYouTubeの情報を取得するエージェントスキルです。字幕、検索、動画・チャンネル情報、チャンネルフィード、再生リストに対応します。
主な機能
- 01タイムスタンプ付きまたは通常の字幕取得
- 02動画、チャンネル、再生リスト、映画の検索
- 03動画とチャンネル情報の取得
- 04チャンネルフィードと再生リストの閲覧
- 05チャンネルハンドルの解決
活用シーン
- 01テーマを調べて動画の字幕を集める
- 02チャンネルの最新アップロードを追跡する
- 03チャンネル情報と再生リストを確認する
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/youtube-fullを入力して読み込まれたか確認します。
同梱ファイルreferences/auth-setup.mdreferences/curl-examples.md
詳細
YouTube Full
TranscriptAPI.com を使った完全な YouTube ツールキットです。すべてが 1 つのスキルにまとまっています。
セットアップ
$TRANSCRIPT_API_KEY が設定されていない場合は、references/auth-setup.md を読み、キーを取得して保存するための手順に従ってください。
必須ヘッダー
すべてのリクエストに 2 つのヘッダーが必要です。
- Authorization:
Bearer $TRANSCRIPT_API_KEY - User-Agent: エージェントの名前と、分かる場合はバージョン（例：
HermesAgent/0.11.0、ClaudeCode/1.0）。バージョンは省略可能で、エージェント名だけでもかまいません。このヘッダーを省略したり、デフォルト値のまま送信したりしないでください。Cloudflare は 403（エラーコード 1010）を返し、リクエストをブロックします。
API リファレンス
OpenAPI の完全な仕様：transcriptapi.com/openapi.json。最新のパラメーターとスキーマを確認するには、こちらを参照してください。
トランスクリプト — 1 クレジット
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
| パラメーター | 必須 | デフォルト | 値 |
|---|---|---|---|
video_url | はい | — | YouTube URL または 11 文字の動画 ID |
format | いいえ | json | json、text |
include_timestamp | いいえ | true | true、false |
send_metadata | いいえ | false | true、false |
レスポンス（format=json）：
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],
"metadata": { "title": "...", "author_name": "...", "author_url": "..." }
}
動画情報とメタデータ
# Free — languages available for the transcript endpoint
GET https://transcriptapi.com/api/v2/youtube/info?video_url=VIDEO_URL
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# 1 credit — rich metadata (views, likes, description, duration, tags)
GET https://transcriptapi.com/api/v2/youtube/video/metadata?video_url=VIDEO_URL&include=details,related
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
video/metadata の include には、details および／または related を指定できます。名前について：/video/metadata は以前は /video/info でした。古いパスも引き続き動作しますが、非推奨です。
検索 — 1 ページにつき 1 クレジット
# Videos
GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# Channels, playlists, or movies
GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
| パラメーター | 必須 | デフォルト | 検証 |
|---|---|---|---|
q | はい | — | 1～200 文字 |
type | いいえ | video | video、channel、playlist、movie |
sort | いいえ | relevance | relevance、views（最初のページのみ） |
upload_date | いいえ | — | hour、today、week、month、year（動画、最初のページ） |
duration | いいえ | — | short、medium、long（動画、最初のページ） |
features | いいえ | — | 例：hd,subtitles,cc（最初のページ） |
limit | いいえ | 20 | 1～50 |
チャンネル
すべてのチャンネルエンドポイントは、channel に @handle、チャンネル URL、または UC... チャンネル ID を指定できます。事前に解決する必要はありません。
ハンドルを解決 — 無料
GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
レスポンス：{"channel_id": "UC...", "resolved_from": "@TED"}
最新の動画 15 件 — 無料
GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
正確な viewCount と ISO 形式の published タイムスタンプを返します。
チャンネルフィード（動画／ショート／配信）— 1 ページにつき 1 クレジット
# First page (100 items, tab defaults to "videos")
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&tab=videos
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# Most-viewed first (channel Videos tab, ~30 items)
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# Next pages (repeat the same tab AND sort)
GET https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popular
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
channel または continuation のいずれか 1 つだけを指定してください。tab は videos（デフォルト）、shorts、streams のいずれかです。レスポンスには continuation_token と has_more が含まれます。
並べ替え。 channel/videos に sort=latest、popular、または oldest を追加すると、チャンネルの動画を希望する順序（たとえば人気の高いアップロード順）で取得できます。並べ替えたページでは約 30 件の動画が返されます（並べ替えなしのページでは約 100 件）。どちらもページあたりのクレジットは同じ 1 です。
ページングするときは、各リクエストで同じ sort を指定してください。
項目のフィールド。 すべての項目には members_only が含まれます。この値が true になるのは、YouTube が「メンバー限定」と表示している場合だけです。これらの項目には viewCountText がありません。tab=streams の項目には lengthText と publishedTimeText（例：2 年前に配信）が含まれます。tab=shorts では、YouTube のショート動画グリッドにこれらの情報が表示されないため、どちらも null になります。チャンネルタブのフィード（sort を指定した tab=videos、tab=shorts、tab=streams）では、channelId、channelTitle、channelHandle、index が null になります。
チャンネル内検索 — 1 クレジット
GET https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=QUERY&limit=30
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
チャンネルプロフィール — 1 クレジット
GET https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
タイトル、ハンドル、認証済みフラグ、登録者数／動画数、説明、タグ、サムネイル、バナー、availableTabs を返します。
チャンネルのプレイリスト — 1 クレジット／ページ
GET https://transcriptapi.com/api/v2/youtube/channel/playlists?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
各プレイリストの playlistId、title、url、videoCountText を返します。playlistId を下記の Playlists エンドポイントに渡してください。
チャンネルのコミュニティ投稿 — 1 クレジット／ページ
GET https://transcriptapi.com/api/v2/youtube/channel/posts?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
チャンネルのキュレーション済みセクション — 1 クレジット
GET https://transcriptapi.com/api/v2/youtube/channel/sections?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
tab は featured（デフォルト、ホームページ）、podcasts、または releases です。
Playlists — 1 クレジット／ページ
playlist を指定します。YouTube のプレイリスト URL またはプレイリスト ID を指定できます。
# First page
GET https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# Next pages
GET https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
有効な ID の接頭辞：PL、UU、LL、FL、OL。レスポンスには playlist_info、results、continuation_token、has_more が含まれます。
クレジットの料金
| エンドポイント | コスト |
|---|---|
| transcript | 1 |
| info | 無料 |
| video/metadata | 1 |
| search | 1／ページ |
| channel/resolve | 無料 |
| channel/info | 1 |
| channel/latest | 無料 |
| channel/videos | 1／ページ |
| channel/search | 1 |
| channel/playlists | 1／ページ |
| channel/posts | 1／ページ |
| channel/sections | 1 |
| playlist/videos | 1／ページ |
検証ルール
| フィールド | ルール |
|---|---|
channel | @handle、チャンネル URL、または UC... ID |
playlist | プレイリスト URL または ID（PL／UU／LL／FL／OL 接頭辞） |
q | 1〜200 文字 |
type (search) | video（デフォルト）、channel、playlist、movie |
tab (channel/videos) | videos（デフォルト）、shorts、streams |
sort (channel/videos) | latest、popular、oldest（アップロードフィードには指定しません） |
tab (channel/sections) | featured（デフォルト）、podcasts、releases |
include (video/metadata) | details、related（カンマ区切り） |
limit | 1〜50 |
エラー
| コード | 意味 | 対処 |
|---|---|---|
| 401 | API キーが無効です | キーを確認してください |
| 402 | クレジットがありません | transcriptapi.com/billing |
| 403/1010 | Cloudflare にブロックされました | User-Agent ヘッダーを追加するか、修正してください |
| 404 | 見つかりません | リソースが存在しないか、字幕がありません |
| 408 | タイムアウト | 2 秒後に 1 回再試行してください |
| 422 | 検証エラー | パラメーターの形式を確認してください |
| 429 | レート制限中 | 待機し、Retry-After を守ってください |
代表的なワークフロー
調査ワークフロー： 検索 → 動画を選択 → トランスクリプトを取得
# 1. Search
GET https://transcriptapi.com/api/v2/youtube/search?q=machine+learning+explained&limit=5
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# 2. Transcript
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
チャンネルのモニタリング： 最新情報（無料） → トランスクリプト
# 1. Latest uploads (free — pass @handle directly)
GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
# 2. Transcript of latest
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
無料プラン：100 クレジット、300 リクエスト／分。Starter（月額 $5）：1,000 クレジット。
コピーして貼り付けられる例
このファイル内のすべてのリクエストを、すぐに実行できる 1 行コマンドとして掲載しています：references/curl-examples.md