mcpField
Y
yt

yt

github.com/zeropointrepo生産性1.1k701 回インストール5 週間前に更新
リポジトリ

yt について

ytは、TranscriptAPI.comを通じてYouTubeを手早く検索するエージェント向けスキルです。動画やチャンネルの検索、文字起こしの取得、最新のチャンネル投稿確認に使えます。

主な機能

  1. 01動画またはチャンネルの検索
  2. 02動画の文字起こし取得
  3. 03チャンネルの最新15本を表示
  4. 04ハンドルからチャンネルIDを解決

活用シーン

  1. 01YouTube動画の素早い検索
  2. 02動画の文字起こし確認
  3. 03最新投稿と再生数の確認
  4. 04チャンネルハンドルをIDに変換

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zeropointrepo/youtube-skills --skill yt

インストール後、Claude Code で/ytを入力して読み込まれたか確認します。

同梱ファイルreferences/auth-setup.mdreferences/curl-examples.md

詳細

yt

TranscriptAPI.com を使った YouTube の簡単な検索です。

セットアップ

$TRANSCRIPT_API_KEY が設定されていない場合は、references/auth-setup.md を読み、API キーを取得して保存する手順に従ってください。

必須ヘッダー

すべてのリクエストに、次の 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

検索 — 1 クレジット

GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
パラメーターデフォルト値
q—1〜200 文字（必須）
typevideovideo、channel
limit201〜50

チャンネルの最新動画 — 無料

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

再生回数と公開日が正確な最新動画 15 件を返します。@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

@handle を UC... チャンネル ID に変換する際に使用します。

エラー

コード意味対処
401API キーが無効ですキーを確認してください
402クレジットがありませんtranscriptapi.com/billing
403/1010Cloudflare にブロックされましたUser-Agent ヘッダーを追加または修正してください
404見つかりません字幕がないか、リソースが存在しません
408タイムアウト1 回再試行してください

無料プランでは 100 クレジットを利用できます。検索と文字起こしには 1 クレジットかかります。チャンネルの最新動画の取得とハンドルの解決は無料です。

コピーして貼り付けられるサンプル

このファイル内のすべてのリクエストを、そのまま実行できる 1 行形式で掲載しています：references/curl-examples.md

コメント

Markdown 対応