youtube-transcript-note

YouTube 文字起こしノートのワークフロー

YouTube の URL を指定したら、以下の手順を順番に実行します。 出力は次の手順に引き継ぎます。手順が失敗しない限り、途中でユーザーに確認しないでください。

Step 1: タイムスタンプ付きの文字起こしを取得する

SRT 形式で benevolentbadger を実行し、タイムスタンプ付きの字幕を取得します。

uv run --no-active --project /Users/mtm/pdev/taylormonacelli/benevolentbadger benevolentbadger --format srt "<youtube_url>"

SRT の出力全体を保存してください。Step 5 でタイムスタンプが必要になります。

また、プレーンテキストでも実行し、クリーニング用の生の文字起こしを取得します。

uv run --no-active --project /Users/mtm/pdev/taylormonacelli/benevolentbadger benevolentbadger "<youtube_url>"

Step 2: 文字起こしをクリーニングする

これは文字起こしタスクであり、要約タスクではありません。 話された内容はすべて出力に含めてください。文字起こしの一部を省略、短縮、要約してはいけません。 文字起こしが長い場合は、全体を出力してください。

プレーンテキストの文字起こしに、次のルールを適用します。

• すべてのスペルミスを修正する
• 文法上の誤り（主語と動詞の一致、時制の一貫性など）を修正する
• 適切な句読点を追加する（ピリオド、コンマ、アポストロフィ、短縮形など）
• 固有名詞と文頭を大文字にする
• 完全な文をそれぞれ別の行に配置する
• 各文の間に空行を入れる
• 断片的なフレーズを、完全で筋の通った文にまとめる
• フィラー語（um、uh、like、you know、so、kinda、gonna、wanna）を削除する（「gonna」などの短縮形は「going to」に置き換える）
• 言い直しや繰り返された語を削除する
• ナレーターのラベル（[Narrator] など）、動作の指示（(laughing) など）、末尾の URL を削除する

Step 3: セクションに分ける

クリーニングした文字起こしを読み、自然な話題の区切りを 4～7 個特定します。

クリーニングした文字起こしの文はすべて、ちょうど 1 つのセクションに含めてください。削除や省略はできません。

各セクションについて：

• 話題を表す簡潔な ## 見出しを作成します（タイトルケース）。
• その話題に属するクリーニング済みの文をすべて、見出しの下に配置します。

Step 1 の SRT 出力を使い、各セクションに属する最初の字幕の start 時刻（秒単位）を探します。 動画のタイムスタンプ URL を、## 見出しの直後の行に単独のリンクとして追加します。

## Section name

https://youtu.be/<VIDEO_ID>?t=<seconds>s

First sentence of section.

Step 4: TOC を作成する

本文の先頭（最初の ## セクションより前）に、標準の Markdown アンカーではなく、Obsidian のウィキリンク見出し形式を使って目次を追加します。

## Table of contents

- [[#Section one]]
- [[#Section two]]
- [[#Section three]]

Step 5: サムネイル URL を直接取得する

YouTube はサムネイルを固定 URL でホストしているため、ここでは social-to-imgur スキルを実行しないでください。

動画 ID から URL を作成します。https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg

YouTube の場合、Imgur を経由しても利点はなく、送信元 IP による 429 エラーが発生します。Instagram など、CDN の URL に有効期限があるプラットフォームでは、引き続きアップロードが必要です。

Step 6: Vault のファイル名を決める

動画タイトルを、Vault で安全に使えるファイル名に変換します。

• すべて小文字にする
• 単語はスペースで区切る（ハイフンやアンダースコアは使わない）
• 特殊文字（パイプ、コロン、スラッシュなど）を削除する

区別しやすくなる場合は、チャンネル名またはクリエイター名を先頭に付けます。 例：tasty kitchen cast iron skillet care and cooking.md

Step 7: Vault ノートを書く

次の構成で、ノートを /Users/mtm/Documents/Obsidian Vault/<filename>.md に書き込みます。

---
tags:
  - <relevant-tag>
pic: https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg
---

![<filename without .md>](https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg)

https://youtu.be/<VIDEO_ID>

<intro sentences — any content before the first natural section break>

## Table of contents

- [[#Section one]]
...

## Section one

https://youtu.be/<VIDEO_ID>?t=<seconds>s

<sentences>

## Section two

https://youtu.be/<VIDEO_ID>?t=<seconds>s

<sentences>

ルール：

• # Title 見出しは使用しません。Obsidian ではファイル名がタイトルになります。
• タグには既存の Vault タグのみを使用します。ユーザーの許可なく新しいタグを作成しないでください。
• 全体を通して、1 行に 1 文を配置し、文の間には空行を入れます。
• ファイル内ではイタリックや太字を一切使用しません。
• 名前のある製品は、ローカル Vault にページがあればそのページへのリンク（例：`[[flaxseed oil]]）を設定し、なければ Google 画像検索 URL へのリンクを設定します。

Step 8: コミットする

新しいファイルをステージングしてコミットします。

git add "<filename>.md"
git commit -m "Add <short topic> note from YouTube transcript"

各 git コマンドは、別々の Bash 呼び出しとして実行してください（&& で連結しないでください）。

ステップ 9：レシピのクリーンアップを適用する（料理／レシピ関連のコンテンツのみ）

以下のいずれかの手がかりを確認して、動画がレシピまたは料理を主題とするコンテンツかどうかを判断します。

• 動画タイトルに、recipe、sauce、how to make、cooking、bake、roast、stir-fry、marinade、dipping、dumpling、noodle、soup、fry などの語が含まれている
• チャンネル名が食べ物や料理に関連している
• トランスクリプトに、材料の計量値や分量、または料理の手法に関する語彙が含まれている

いずれかの手がかりからレシピ／料理関連のコンテンツだと判断できた場合は、作成したばかりの保管庫ノートのパスを渡して、recipe-cleanup スキルを呼び出します。

/recipe-cleanup <absolute path to vault note>

このスキルは、YouTube の説明欄から印刷可能なレシピを取得し（存在する場合）、構造化された ### Ingredients チェックリストと ### Instructions ブロックを追加して、フロントマターの creator フィールドを更新し、材料のウィキリンクを解決します。

スキルの完了後、更新したファイルをコミットします。

git add "<filename>.md"
git commit -m "Apply recipe cleanup to <short topic> note"

コンテンツがレシピや料理を主題とするものではない場合は、このステップ全体をスキップしてください。recipe-cleanup は呼び出さないでください。

最終レポート

すべてのステップが完了したら、次の内容を報告します。

• 保管庫ノートのファイル名
• i.ytimg.com のサムネイル URL
• セクションの内訳と、それぞれの動画のタイムスタンプ
• レシピのクリーンアップを適用したかどうか