youtube-processor

YouTube プロセッサー

これは何をするものですか

YouTube の URL を受け取り、文字起こしを抽出し、あなた（Claude）が要約します。Obsidian ですぐに使える Markdown を出力します。リンクを共有するだけで、すぐに実用的なメモが得られます。

使用する場面

• 「この動画を要約して：[URL]」
• 「この YouTube 動画をメモにまとめて」
• 「この動画はどんな内容？」
• 「これをニュースレター用に処理して」
• 処理用に共有された YouTube の URL 全般

場所

このスキルのツールは次の場所にあります：

/Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools/

仕組み

ステップ 1： Python で文字起こしを抽出します（API キーは不要です） ステップ 2： あなた（Claude）が知能とコンテキストを活用して要約します ステップ 3： Obsidian 形式の出力を書きます

この方法なら、要約中に mission-context、newsletter-coach などのスキルを利用できます。

---

手順

使用する方法

環境	方法
Claude Code	ローカルの Python スクリプト（ステップ 1a）
Claude.ai / Mac Client	WebFetch 経由の API（ステップ 1b）

---

ステップ 1a：文字起こしを抽出する（Claude Code）

Python ツールを実行して文字起こしを取得します：

cd /Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools && \
python3 get_transcript.py --url "[URL]"

JSON 出力の場合（解析が簡単です）：

python3 get_transcript.py --url "[URL]" --json

ステップ 1b：文字起こしを抽出する（Claude.ai / Mac Client）

WebFetch 経由で API エンドポイントを使用します：

WebFetch: https://youtube-processor-eight.vercel.app/transcript?url=[VIDEO_URL]

API は JSON を返します：

{
  "success": true,
  "video_id": "abc123",
  "language": "en",
  "transcript": "...",
  "char_count": 5000,
  "word_count": 850
}

WebFetch 用のプロンプト例： 「レスポンスから文字起こしテキストを抽出してください」

---

ステップ 2：文字起こしを要約する

文字起こしを取得したら、ユーザーのニーズに合わせて要約します：

クイックサマリー：

• 見出し（1 文）
• 要点（3～5 項目）
• 主な結論

詳細な分析：

• 見出しの要約
• コンテキストを含めた要点
• 主な結論
• 言及されたアクション項目
• Ed の仕事との関連（該当する場合）

ニュースレター向けの素材収集：

• 記事のフック案
• 核となる洞察／フレームワーク
• エピソードのストーリー展開
• 読者向けの要点
• The Little Blue Report 向けのニュースレターの切り口

ステップ 3：Obsidian 用に整形する

次の構成で Markdown を作成します：

---
source: YouTube
video_id: [ID]
url: [URL]
processed: [YYYY-MM-DD HH:MM]
tags: [youtube, video-notes]
---

# [Video Title or Topic]

**Link**: [URL]
**Processed**: [Date]

## Summary

[Your summary here]

---

## Full Transcript

[The transcript]

---

_Generated by youtube-processor skill_

ステップ 4：保存する（任意）

Ed の Zettelkasten に保存します：

/Users/eddale/Documents/COPYobsidian/MAGI/Zettelkasten/

ファイル名の形式：YT - [Topic] - YYYY-MM-DD.md

---

エラー処理

エラー	意味	対処方法
"Transcripts disabled"	作成者が字幕をオフにしています	動画を処理できません
"No transcript found"	英語字幕がありません	別の動画を試してください
"Video unavailable"	非公開、削除済み、または年齢制限付きです	URL を確認してください

---

例

例 1：クイックサマリー

ユーザーの依頼：

Summarize this: https://www.youtube.com/watch?v=VIDEO_ID

実行する内容：

1. 実行：python3 get_transcript.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
2. 文字起こしの出力を読む
3. ユーザーに要約を提示する

例 2：Obsidian に保存する

ユーザーの依頼：

Turn this video into notes and save it: [URL]

実行する内容：

1. Python ツールで文字起こしを抽出する
2. 内容を要約する
3. Obsidian 用の Markdown に整形する
4. Write ツールを使用して Zettelkasten に保存する
5. 「[filepath] に保存しました」と確認する

例 3：ニュースレター向けの素材収集

ユーザーの依頼：

I want to write about this video for the newsletter: [URL]

実行する内容：

1. 文字起こしを抽出する
2. ニュースレターの切り口（フック、洞察、ストーリー展開）を分析する
3. 切り口を提示する
4. newsletter-coach スキルへの引き継ぎを提案する

---

連携ポイント

• newsletter-coach：動画から洞察を抽出した後、記事の作成に引き継ぎます
• mission-context：要約には Ed の語り口とスタイルを使用します
• task-clarity-scanner：動画から得たアクション項目を日次メモに追加できます

---

依存関係

Python ツールには次のものが必要です：

youtube-transcript-api

必要に応じてインストールします：

pip3 install youtube-transcript-api

---

バージョン履歴

バージョン	日付	変更内容
1.1	2026-01-03	Claude.ai/Mac クライアント対応用の Vercel API を追加
1.0	2026-01-02	文字起こし抽出機能を備えた初期ビルド

備考と学び

• youtube-transcript-api は API キーなしで動作します
• ほとんどの動画には自動生成された英語字幕があります
• 要約は Python から API を呼び出すより Claude が行うほうが優れています（コンテキストを活用できるため）
• 一般的な動画の文字起こし抽出にかかる時間は約 3～5 秒です