youtube-ingest について
youtube-ingest は、YouTube の URL から Obsidian Vault 用のノートを作成するワークフロースキルです。動画情報を取得し、YouTube のサムネイル URL を組み立て、ファイル名を決めてノートを保存・コミットします。
主な機能
- 01動画タイトルとチャンネル情報の取得
- 02動画 ID からサムネイル URL を作成
- 03Vault 用ファイル名の生成
- 04構造化された Obsidian ノートの作成
- 05ノートのステージングとコミット
活用シーン
- 01YouTube 動画を Vault のノートに保存
- 02トピックとサムネイル情報をノートに追加
- 03新しい動画ノートをコミット
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/youtube-ingestを入力して読み込まれたか確認します。
同梱ファイルtile.json
詳細
YouTube 取り込みワークフロー
YouTube URL（例：https://youtu.be/0EHFgu7V7N4）が与えられたら、次の手順を順番に実行します。
出力は次の手順に引き継ぎます。手順が失敗しない限り、途中でユーザーに質問しないでください。
Step 1: 動画のメタデータを取得する
yt-dlp を実行して動画のタイトルを取得します。
uvx yt-dlp --get-title "<youtube_url>"
出力から次の情報を収集します。
- 動画のタイトル
ページも取得して、チャンネル名とトピックの1文要約を確認します。 タイトル、チャンネル、トピックを尋ねるプロンプトを指定して、正規の YouTube 再生 URL に対して WebFetch を使用します。
Step 2: サムネイル URL を直接取得する
YouTube ではサムネイルが安定した URL でホストされているため、ここでは social-to-imgur スキルを実行しないでください。
動画 ID から URL を組み立てます：https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg
これを pic: とヒーロー画像の両方に使用します。
Imgur を経由しても YouTube では何も利点がなく、送信元 IP に対する 429 エラーが発生します。Instagram など、CDN URL の有効期限が切れる他のプラットフォームでは、引き続きアップロードが必要です。
Step 3: Vault ファイル名を決める
動画タイトルを Vault で使えるファイル名に変換します。
- すべて小文字にする
- 単語をスペースで区切る（ハイフンやアンダースコアは使用しない）
- 特殊文字（パイプ、コロン、スラッシュなど）を取り除く
- 意味のない語句（例：「how to」、「a」、「the」）は、結果が説明的である場合に限り取り除く
例：「How To Make Dumpling Wrappers From Scratch | KitchenAid Pasta Attachment」
は次のようになります：dumpling wrappers from scratch kitchenaid pasta attachment.md
Step 4: Vault ノートを書き込む
次の構成で /Users/mtm/Documents/Obsidian Vault/<filename>.md にノートを書き込みます。
<youtube_url>
ユーザーから求められない限り、フロントマターは不要です。
Step 5: コミットする
新しいファイルをステージしてコミットします。
git add "<filename>.md"
git commit -m "Add <short topic> note with YouTube link and hero image"
各 git コマンドは、それぞれ別の Bash 呼び出しとして実行します（&& で連結しないでください）。
最終報告
すべての手順が完了したら、次の内容を報告します。
- Vault ノートのファイル名
- i.ytimg.com のサムネイル URL
- 元の YouTube URL