Youtube Skills For Ai Agents について
YouTube Skills は TranscriptAPI を基盤とし、Agent Skills 形式に対応する AI エージェントから、YouTube の字幕、検索、チャンネル、プレイリストを利用できるようにします。yt-dlp やヘッドレスブラウザーを使わず API 呼び出しで動作し、YouTube を対象とした調査を行う利用者向けです。
主な機能
- 01タイムスタンプ付きの動画字幕の取得
- 02動画とチャンネルのキーワード検索
- 03チャンネルのアップロード一覧と @handle の解決
- 04プレイリスト内の全動画の抽出
活用シーン
- 01エージェントに動画の要約や翻訳を依頼
- 02特定のチャンネル内でキーワードによる動画検索
- 03プレイリストやチャンネルの字幕を一括取得
MCP 対応
TranscriptAPI の MCP サーバーとして提供され、Claude や ChatGPT などの LLM が YouTube データ用のインターフェースを直接呼び出せるようにします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
AI エージェント向け YouTube スキル 🎬
あらゆる AI エージェントから、YouTube の文字起こしを取得し、動画を検索し、チャンネルを閲覧し、プレイリストを抽出できます。
YouTube Skills を使うと、AI エージェントから YouTube の文字起こし、動画検索、チャンネルデータ、プレイリストの抽出にすぐアクセスできます。yt-dlp も(YouTube は主要なクラウド IP をすべてブロックするため)、ヘッドレスブラウザーも、バイナリも不要です。どこでも使える高速な API 呼び出しだけです。TranscriptAPI を利用しており、YouTubeToTranscript.com と同じバックエンドで動作します。
🦞 OpenClaw(ClawdBot/Moltbot)、
Hermes Agent、Claude Code、Cursor、Antigravity、および Agent Skills 形式に対応するあらゆるエージェントで動作します。
無料プラン · クレジットカード不要 · 登録時に100クレジット
TranscriptAPI.com · MCP サーバー · ドキュメント
インストール
ほとんどのユーザーには youtube-full がおすすめです。文字起こし、検索、チャンネル、プレイリストを1つのスキルで利用できます。
🦞 OpenClaw(ClawdBot/Moltbot):
npx clawhub@latest install youtube-full
Hermes Agent:
hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
Claude Code / Cursor / Antigravity / Cline / Codex:
npx skills add ZeroPointRepo/youtube-skills --skill youtube-full
12個のスキルをすべて一度にインストール:
npx skills add ZeroPointRepo/youtube-skills
手動(git clone):
git clone https://github.com/ZeroPointRepo/youtube-skills.git
cp -r youtube-skills/skills/youtube-full ~/.claude/skills/
開発者ではありませんか? 🦞 OpenClaw、
Hermes Agent、Claude、ChatGPT、または任意の AI エージェントに、次のプロンプトを貼り付けるだけです。
この GitHub リポジトリから youtube skills をインストールしてください:https://github.com/ZeroPointRepo/youtube-skills エージェントから YouTube の文字起こしを取得したり、YouTube を検索したり、チャンネルの動画を閲覧したりできるようにしたいです。 すべて設定してください。あとはエージェントが対応します。
できること
インストールして質問するだけです。設定もコードも不要です。エージェントに普段の英語で話しかけてください。
| タスク | プロンプトの例 |
|---|---|
| YouTube の文字起こしを取得する | 「この動画を要約してください:[URL]」 |
| YouTube を検索する | 「機械学習についての動画を見つけてください」 |
| チャンネルを閲覧する | 「TED は今週、何を投稿しましたか?」 |
| プレイリストの内容を取得する | 「このプレイリストの動画をすべて一覧表示してください」 |
| 動画の字幕を抽出する | 「この動画の字幕をスペイン語で取得してください」 |
| 文字起こしを一括取得する | 「このチャンネルのすべての動画の文字起こしを取得してください」 |
| トピックを調査する | 「量子コンピューティングについて、上位5本の動画を見つけて要約してください」 |
| 最新のアップロード動画を取得する | 「NASA の最近の動画を見せてください」 |
| チャンネル内を検索する | 「TED チャンネルで『人工知能』を検索してください」 |
セットアップ — API キー
スキルをインストールして、エージェントを初めて実行すると、エージェントが無料の API キーを自動で設定します。次のように進みます。
- エージェントがメールアドレスを尋ね、TranscriptAPI に登録します
- メールでOTP コードが届きます。エージェントの案内に従って入力してください
- 確認が完了すると、エージェントが API キーをシェルとエージェントの設定に自動で保存します
これで完了です。無料クレジットが100件付与され、クレジットカードは不要です。
手動での設定(自分で設定したい場合)
-
transcriptapi.com で登録します。無料で、クレジットカードは不要です
-
ダッシュボードから API キーをコピーします(
sk_で始まります) -
エージェントに保存を依頼します。
「TranscriptAPI のキーは
sk_...です。セッションをまたいで保持されるように保存してください。」
または、環境変数として自分で設定します。
export TRANSCRIPT_API_KEY="sk_your_key_here"
キーはどこに保存されますか?
エージェントは、実行環境に応じて API キーを次の場所に保存します。
| 場所 | ファイル |
|---|---|
| OpenClaw/Moltbot | ~/.openclaw/openclaw.json または ~/.clawdbot/moltbot.json |
| Hermes Agent | Hermes のシークレットストア(スキルのフロントマターで required_environment_variables を使って TRANSCRIPT_API_KEY を宣言) |
| macOS シェル | ~/.zshenv、~/.zprofile |
| Linux シェル | ~/.profile、~/.bashrc、~/.zshenv |
| Fish シェル | ~/.config/fish/config.fish |
| フォールバック | ~/.transcriptapi(モード 600) |
保存後、エージェントが自動でキーを読み込みます。
スキル
ほとんどのユーザーには、youtube-full スキルがおすすめです。文字起こし、検索、チャンネル、プレイリストのすべてが含まれています。
より小さく、用途を絞ったスキル(コンテキストが小さいほど、特定のタスクでエージェントのパフォーマンスが向上します)を使いたい場合は、必要なものを選んでください。
| スキル | 機能 | インストール |
|---|---|---|
| youtube-full | すべて — 文字起こし、検索、チャンネル、プレイリスト | --skill youtube-full |
| transcript | タイムスタンプ付きで動画の文字起こしを取得 | --skill transcript |
| youtube-search | YouTube で動画やチャンネルを検索 | --skill youtube-search |
| youtube-channels | アップロード動画の閲覧、最新動画の取得、@handle の解決 | --skill youtube-channels |
| youtube-playlist | プレイリスト内のすべての動画を抽出 | --skill youtube-playlist |
# Install a specific skill
npx skills add ZeroPointRepo/youtube-skills --skill transcript
# Install multiple specific skills
npx skills add ZeroPointRepo/youtube-skills --skill transcript --skill youtube-search
全12種類のスキル
スキルは全部で12種類あります。その多くは、上記の主要な5種類をより細分化したもの、または別名です。そのため、依頼の表現にかかわらず、エージェントが適切なスキルを見つけられます。
| スキル | 説明 |
|---|---|
| youtube-full | YouTube の包括的なツールキット — 文字起こし、検索、チャンネル、プレイリスト |
| transcript | 任意の YouTube 動画からタイムスタンプ付きの文字起こしを抽出 |
| captions | YouTube 動画のクローズドキャプション/CC を取得 |
| subtitles | YouTube 動画から字幕を抽出 |
| youtube-search | YouTube で動画やチャンネルを検索 |
| youtube-channels | チャンネルのアップロード動画を閲覧、最新動画を取得、@handle を解決 |
| youtube-playlist | YouTube のプレイリストからすべての動画を取得 |
| youtube-data | YouTube の動画とチャンネルのデータを取得(Google の API に代わる軽量な手段) |
| youtube-api | AI エージェント向けの YouTube API アクセス — Google のクォータを気にする必要はありません |
| transcriptapi | すべてのエンドポイントを含む、TranscriptAPI のフルアクセス |
| video-transcript | YouTube 動画をテキスト形式の文字起こしに変換 |
| yt | 素早い検索に使える、手軽な YouTube ユーティリティ |
料金
| プラン | 料金 | クレジット | レート制限 |
|---|---|---|---|
| Free | $0 | 登録時に100クレジット | 300 req/min |
| Starter | $5/month | 月1,000クレジット | 300 req/min |
| Starter Annual | $54/year ($4.50/mo) | 月1,000クレジット | 300 req/min |
ほとんどの操作は1クレジットを消費します。チャンネルの解決と最新情報の取得は無料です。無料プランではクレジットカードは不要です。
対応エージェント
Agent Skills 形式に対応する、あらゆるAIエージェントで利用できます。
| エージェント | インストールコマンド |
|---|---|
| 🦞 OpenClaw (ClawdBot/Moltbot) | npx clawhub@latest install youtube-full |
hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full | |
| Claude Code | npx skills add ZeroPointRepo/youtube-skills |
| Cursor | npx skills add ZeroPointRepo/youtube-skills |
| Antigravity | npx skills add ZeroPointRepo/youtube-skills |
| Cline | npx skills add ZeroPointRepo/youtube-skills |
| Codex | npx skills add ZeroPointRepo/youtube-skills |
| その他 | Goose、AMP、Kiro、Roo、OpenCode、Gemini、GitHub Copilot など |
よくある質問
YouTubeの文字起こしを取得するには?
youtube-full(または transcript)をインストールし、エージェントに次のように依頼します。
「この動画の文字起こしを取得して:https://youtube.com/watch?v=VIDEO_ID」
エージェントはタイムスタンプ付きの全文字起こしを取得します。その後、内容の要約、翻訳、引用、分析を依頼できます。
エージェントからYouTubeを検索するには?
youtube-full(または youtube-search)をインストールし、次のように依頼します。
「機械学習に関する動画を探して」
タイトル、サムネイル、再生回数、公開日を含む最大50件の結果が返されます。
YouTubeチャンネルの全動画を取得するには?
youtube-full(または youtube-channels)をインストールし、次のように依頼します。
「TEDチャンネルの全動画を一覧表示して」
エージェントは@handleを解決し、アップロード動画を取得します(ページ分割、1ページあたり100件)。その後、任意の動画、またはすべての動画の文字起こしを取得できます。
YouTubeの文字起こしを一括ダウンロードできますか?
はい。youtube-full をインストールし、次のように依頼します。
「このプレイリスト内の全動画の文字起こしを取得して:[URL]」
エージェントはプレイリストを取得し、動画を順に処理して、それぞれの文字起こしを抽出します。
Google YouTube Data APIキーは必要ですか?
いいえ。TranscriptAPIは、文字起こしの抽出、検索、チャンネル/プレイリスト操作において、Google YouTube Data APIの代わりになります。Google Cloudプロジェクト、クォータ制限、OAuthの設定は不要です。
APIキーは必要ですか?
はい。ただし、登録は無料で、すぐに完了します。クレジットカードは不要で、100クレジットが付与されます。初回実行時の設定はエージェントが自動で行います。
どのスキルをインストールすればよいですか?
- すべて利用したい場合 →
youtube-full(推奨) - 文字起こしだけの場合 →
transcript - 検索だけの場合 →
youtube-search - チャンネル情報だけの場合 →
youtube-channels - プレイリストだけの場合 →
youtube-playlist
TranscriptAPIとは何ですか?
TranscriptAPI.com は、YouTubeデータ用のREST APIおよびMCP サーバーです。文字起こしの抽出、動画検索、チャンネルの閲覧、プレイリスト操作を提供し、開発者とAIエージェント向けに構築されています。LLM(Claude、ChatGPT)と直接連携できるMCP サーバーとしても利用できます。
トラブルシューティング
ユーザーが実際に遭遇する問題への簡単な対処法です。エラーコードは API 自体から返されるため、エージェントは通常、そのまま報告します。
| 症状 | 考えられる原因 | 対処法 |
|---|---|---|
401 Unauthorized | API キーが設定されていない、入力ミスがある、または環境に読み込まれていない | エージェントが実行されるシェルで TRANSCRIPT_API_KEY が設定されていることと、キーが sk_ で始まることを確認してください |
402 Payment Required | アカウントのクレジットが不足している | transcriptapi.com/billing で残高を確認してください |
Cloudflare コード 1010 を伴う 403 | User-Agent ヘッダーなしでリクエストが送信された | たとえば HermesAgent/0.11.0 のように、エージェント名を User-Agent として送信してください |
404 Not Found | 動画に字幕がない、公開されていない、または ID が間違っている | URL がブラウザーで開けることと、プレーヤーに字幕が表示されることを確認してください |
408 Request Timeout | 動画側の一時的な上流負荷 | 一時的なものです。数秒待ってから一度再試行してください |
422 Validation Error | チャンネルや再生リストの参照が不正など、パラメーターの形式が正しくない | チャンネルには @handle、チャンネル URL、または UC ID を指定できます。再生リストには PL、UU、LL、FL、OL のプレフィックスを指定できます |
429 Too Many Requests | レート制限に達した | 待機し、Retry-After ヘッダーに従ってください |
知っておくと役立つ、その他の 3 つのケース:
- キーを保存したのに、エージェントから認識されない。 シェルの設定ファイルはシェルの種類ごとに読み込まれます。セットアップセクションの「キーはどこに保存されますか?」の表を確認し、エージェントの実行に使われるシェルに合ったファイルか確かめてください。キーを保存した後にエージェントを再起動すると、ほとんどの場合解決します。
- ライブ配信とプレミア公開。 文字起こしを利用できるようになるのは、配信終了後に字幕の処理が完了してからです。配信中は利用できません。
- 文字起こしが予期しない言語で返される。 多くの動画には元の言語の字幕しかありません。希望する言語のパラメーターを指定して文字起こしをリクエストするか、結果を翻訳するようエージェントに依頼してください。
TranscriptAPI によって提供
TranscriptAPI.com — 月間 1,500 万件以上の文字起こし、稼働率 99.9%。
こちらも利用できます:MCP サーバー で Claude や ChatGPT と直接連携できます。
API の全ドキュメント:transcriptapi.com/docs
Hermes Agent のスキル、プラグイン、エージェントプロファイル、メモリープロバイダーのディレクトリである awesome-hermes-skills に掲載されています。
開示事項
TranscriptAPI は独立した製品であり、YouTube または Google とは提携しておらず、これらから推奨も受けていません。
貢献
PR を歓迎します。CONTRIBUTING.md をご覧ください。
ライセンス
MIT © TranscriptAPI
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。