YTAPI

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

YTAPI を利用した、YouTube の文字起こし、検索、チャンネル、再生リスト向けのエージェントスキルです。Claude Code、Codex、Cursor、 OpenClaw、Hermes Agent、およびAgent Skillsを読み込めるあらゆるエージェントで動作します。

curl による通常の HTTPS 呼び出しだけで、ほかにインストールするものはありません。YouTube への直接アクセスに失敗する環境でも動作します。サーバーやクラウドエージェントでは、yt-dlp などのツールが HTTP 429、ボットチェック、IP ブロックに遭遇することがよくあります。

インストール

Claude プラグイン： YTAPI MCP サーバーに加え、動画の要約、 チャンネルのダイジェスト、トピック調査、チャンネル分析用のスキルが含まれています。Claude Code では、次のように実行します。

/plugin marketplace add ytapi/youtube-skills
/plugin install ytapi@ytapi

Claude が初めて YTAPI ツールを使うときは、/mcp を実行して YTAPI アカウントにサインインしてください（またはアカウントを作成してください。200 クレジットが無料で、カードは不要です）。API キーは必要ありません。 プラグインは plugins/ytapi にあります。

Cursor： Cursor の Settings → MCP で YTAPI MCP サーバーを追加するか、 ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に次の設定を追加してください。

{
  "mcpServers": {
    "ytapi": { "url": "https://api.ytapi.dev/mcp" }
  }
}

Cursor では、初回に YTAPI アカウントへのサインインを求められます。このリポジトリは Cursor プラグインとしても使えます。ルートにある .cursor-plugin/plugin.json と .mcp.json、および以下のスキルが含まれています。

Claude Code、Codex、Cursor、Cline など（skills.sh）：

npx skills add ytapi/youtube-skills

スキルを 1 つだけインストールする場合：

npx skills add ytapi/youtube-skills --skill ytapi-youtube-transcript

OpenClaw（ClawHub）：

npx clawhub@latest install ytapi

Hermes Agent：

hermes skills install skills-sh/ytapi/youtube-skills/skills/ytapi

開発者でない方へ： 次の内容をエージェントに貼り付けてください。

https://github.com/ytapi/youtube-skills から YouTube スキルをインストールして、 YTAPI キーを設定してください。

スキル

スキル	機能
ytapi	以下のすべてを 1 つのスキルで利用できます：文字起こし、動画の詳細、コメント、最もリプレイされた場面、検索、チャンネル、再生リスト、一括処理
ytapi-youtube-transcript	文字起こしと字幕：テキスト、Markdown、タイムスタンプ付き JSON、SRT、VTT、あらゆる言語
ytapi-youtube-search	動画、チャンネル、再生リスト、ショート動画を検索し、結果を読み取ります
ytapi-youtube-channels	チャンネルのプロフィール、最新のアップロード、すべての動画、再生リスト
ytapi-youtube-summarize	動画やチャンネルの新着動画を、タイムスタンプ付きリンクとともに要約し、メモを作成します
ytapi-youtube-channel-analysis	競合調査：急成長した動画、チャンネルの成長経緯、動画がバイラルになった理由、および成功例を自分のチャンネルで再利用するためのプレイブックを作成するスキル

どれをインストールするか迷った場合は、ytapi をインストールしてください。

API キー

スキルは YTAPI_API_KEY からキーを読み込みます。設定されていない場合、エージェントが無料アカウントの作成を提案します。メールアドレスと、送信される 6 桁のコードを入力すると、キーが保存されます。ブラウザーもカードも不要です。 または、ytapi.dev で自分でキーを作成できます。

新しいアカウントには 200 クレジットが無料で付与されます。リクエストが成功するたびに 1 クレジットを使用します（動画の基本情報と検索候補は無料です）。失敗したリクエストは無料です。 クレジットパックを購入するまでは、1 秒あたり 1 リクエスト、1 日あたり 100 リクエストまで利用できます。クレジットパックは 2,000 クレジットで 9 ドルからで、有効期限はありません： 料金。

使用例

• 「この動画を要約してください：https://youtu.be/dQw4w9WgXcQ」
• 「この講演のスペイン語字幕を SRT ファイルで取得してください。」
• 「今週、Rust async に関する最も視聴された動画を見つけて、内容を教えてください。」
• 「@mkbhd は最近どんな動画をアップロードしましたか？それぞれ 2 行で要約してください。」
• 「この再生リストにあるすべての動画を、長さとともに一覧表示してください。」
• 「@channel の最新動画が好評だったのはなぜですか？うまくいった点を、自分のチャンネルで使えるプレイブックにまとめてください。」

リンク

• ドキュメント：https://docs.ytapi.dev（エージェント向け：https://docs.ytapi.dev/llms-full.txt）
• リモート MCP サーバー：https://docs.ytapi.dev/agent-setup/#mcp
• エージェント登録 API：https://docs.ytapi.dev/agent-signup/
• サポート：[email protected]

コントリビューション

各スキルには、references/ フォルダーに shared/auth-setup.md のコピーが含まれています。スキルは個別にインストールされるためです。shared/ 内のファイルを編集したら、./scripts/sync-references.sh を実行してください。

plugins/ytapi の Claude プラグインには独自のスキルがあり、MCP ツールを使用するため、API キーを扱うことはありません。これらを変更した場合は、plugins/ytapi/.claude-plugin/plugin.json の version を更新してください。Claude Code は、そこに記載されたバージョンを使用してプラグインのユーザーを管理します。

MIT-0 ライセンスです。