mcpField
Y
Youtube Skills For Ai Agents

Youtube Skills For Ai Agents

ローカル
github.com/ZeroPointRepoメディア・デザイン1.1k5 週間前に更新

Youtube Skills For Ai Agents について

YouTube Skills は TranscriptAPI を基盤とし、Agent Skills 形式に対応する AI エージェントから、YouTube の字幕、検索、チャンネル、プレイリストを利用できるようにします。yt-dlp やヘッドレスブラウザーを使わず API 呼び出しで動作し、YouTube を対象とした調査を行う利用者向けです。

主な機能

  1. 01タイムスタンプ付きの動画字幕の取得
  2. 02動画とチャンネルのキーワード検索
  3. 03チャンネルのアップロード一覧と @handle の解決
  4. 04プレイリスト内の全動画の抽出

活用シーン

  1. 01エージェントに動画の要約や翻訳を依頼
  2. 02特定のチャンネル内でキーワードによる動画検索
  3. 03プレイリストやチャンネルの字幕を一括取得

MCP 対応

TranscriptAPI の MCP サーバーとして提供され、Claude や ChatGPT などの LLM が YouTube データ用のインターフェースを直接呼び出せるようにします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"youtube-skills": {
"command": "npx",
"args": [
"-y",
"@anthropic-ai/claude-code"
]
}
}
}
起動コマンドnpx -y @anthropic-ai/claude-code

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@anthropic-ai/claude-code

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

AI エージェント向け YouTube スキル 🎬

skills.sh

あらゆる AI エージェントから、YouTube の文字起こしを取得し、動画を検索し、チャンネルを閲覧し、プレイリストを抽出できます。

YouTube Skills を使うと、AI エージェントから YouTube の文字起こし、動画検索、チャンネルデータ、プレイリストの抽出にすぐアクセスできます。yt-dlp も(YouTube は主要なクラウド IP をすべてブロックするため)、ヘッドレスブラウザーも、バイナリも不要です。どこでも使える高速な API 呼び出しだけです。TranscriptAPI を利用しており、YouTubeToTranscript.com と同じバックエンドで動作します。

🦞 OpenClaw(ClawdBot/Moltbot)、README の画像 Hermes Agent、Claude Code、Cursor、Antigravity、および Agent Skills 形式に対応するあらゆるエージェントで動作します。

無料プラン · クレジットカード不要 · 登録時に100クレジット

TranscriptAPI.com · MCP サーバー · ドキュメント


インストール

ほとんどのユーザーには youtube-full がおすすめです。文字起こし、検索、チャンネル、プレイリストを1つのスキルで利用できます。

🦞 OpenClaw(ClawdBot/Moltbot):

npx clawhub@latest install youtube-full

README の画像 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、README の画像 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 キーを自動で設定します。次のように進みます。

  1. エージェントがメールアドレスを尋ね、TranscriptAPI に登録します
  2. メールでOTP コードが届きます。エージェントの案内に従って入力してください
  3. 確認が完了すると、エージェントが API キーをシェルとエージェントの設定に自動で保存します

これで完了です。無料クレジットが100件付与され、クレジットカードは不要です。

手動での設定(自分で設定したい場合)
  1. transcriptapi.com で登録します。無料で、クレジットカードは不要です

  2. ダッシュボードから API キーをコピーします(sk_ で始まります)

  3. エージェントに保存を依頼します。

    「TranscriptAPI のキーは sk_... です。セッションをまたいで保持されるように保存してください。」

または、環境変数として自分で設定します。

export TRANSCRIPT_API_KEY="sk_your_key_here"
キーはどこに保存されますか?

エージェントは、実行環境に応じて API キーを次の場所に保存します。

場所ファイル
OpenClaw/Moltbot~/.openclaw/openclaw.json または ~/.clawdbot/moltbot.json
Hermes AgentHermes のシークレットストア(スキルのフロントマターで 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-searchYouTube で動画やチャンネルを検索--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-fullYouTube の包括的なツールキット — 文字起こし、検索、チャンネル、プレイリスト
transcript任意の YouTube 動画からタイムスタンプ付きの文字起こしを抽出
captionsYouTube 動画のクローズドキャプション/CC を取得
subtitlesYouTube 動画から字幕を抽出
youtube-searchYouTube で動画やチャンネルを検索
youtube-channelsチャンネルのアップロード動画を閲覧、最新動画を取得、@handle を解決
youtube-playlistYouTube のプレイリストからすべての動画を取得
youtube-dataYouTube の動画とチャンネルのデータを取得(Google の API に代わる軽量な手段)
youtube-apiAI エージェント向けの YouTube API アクセス — Google のクォータを気にする必要はありません
transcriptapiすべてのエンドポイントを含む、TranscriptAPI のフルアクセス
video-transcriptYouTube 動画をテキスト形式の文字起こしに変換
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
README の画像 Hermes Agenthermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
Claude Codenpx skills add ZeroPointRepo/youtube-skills
Cursornpx skills add ZeroPointRepo/youtube-skills
Antigravitynpx skills add ZeroPointRepo/youtube-skills
Clinenpx skills add ZeroPointRepo/youtube-skills
Codexnpx 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 UnauthorizedAPI キーが設定されていない、入力ミスがある、または環境に読み込まれていないエージェントが実行されるシェルで TRANSCRIPT_API_KEY が設定されていることと、キーが sk_ で始まることを確認してください
402 Payment Requiredアカウントのクレジットが不足しているtranscriptapi.com/billing で残高を確認してください
Cloudflare コード 1010 を伴う 403User-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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。