# Video Transcriber
> オンライン動画ソースから動画の書き起こし（字幕）とメタデータを取得し、Markdown、JSON、またはプレーンテキストで出力します。現在サポート中：YouTube。手動作成字幕を優先し、自動生成字幕にフォールバックします。
- Skill: `ellmos-ai/video-transcriber-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ellmos-ai/video-transcriber-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/video-transcriber-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/video-transcriber-2
---
> **日本語** — `video-transcriber` の公式日本語版。
# Video Transcriber (日本語)
オンライン動画の書き起こし（字幕）およびメタデータ（タイトル、チャンネル、日付、再生回数、
概要）を取得します。手動で作成された字幕を優先し、自動生成された字幕に
フォールバックします。Markdown、JSON、またはプレーンテキストで出力します。
現在サポートされているソース：**YouTube**（youtube.com, youtu.be, youtube-nocookie.com）。
動画の場合、内容を手動で要約する代わりにこのツールを使用してください ——
書き起こしが信頼できる情報源です。
> **注意：** このツールは YouTube または Google と提携、承認、スポンサー関係に
> ありません。使用はユーザー自身の責任において行ってください。ユーザーは、該当プラットフォームの
> 利用規約および適用される著作権法を遵守する全責任を負います。DRM、ペイウォール、
> またはアクセス制限の回避は不可。大量のスクレイピングは不可。権利者の同意なしに
> 著作権で保護された書き起こしを再配布することは不可。
## 依存関係とライセンス
```bash
pip install youtube-transcript-api # 書き起こし（必須） — MITライセンス
pip install yt-dlp # メタデータ（オプション、フォールバック: noembed） — Unlicense (パブリックドメイン)
```
## 使い方
> **Windowsに関する注意：** 常に `PYTHONIOENCODING=utf-8` を設定してください。そうしないと、
> 出力時にウムラウトや特殊文字が文字化けします（cp1252エンコーディング）。
```bash
# デフォルト：タイムスタンプ付きMarkdown
PYTHONIOENCODING=utf-8 python video_transcriber.py "https://www.youtube.com/watch?v=VIDEO_ID"
# 出力フォーマットを選択
PYTHONIOENCODING=utf-8 python video_transcriber.py URL --format markdown|json|plain
# ファイルに保存
PYTHONIOENCODING=utf-8 python video_transcriber.py URL -o transcript.md
# 優先言語（デフォルト: de en）
PYTHONIOENCODING=utf-8 python video_transcriber.py URL --lang de en fr
```
### オプション
| オプション | 効果 |
|------------|------|
| `--format markdown\|json\|plain` | 出力フォーマット（デフォルト: markdown） |
| `--output, -o ` | stdout ではなくファイルに書き込む |
| `--lang ` | 優先する字幕言語（デフォルト: de en） |
| `--meta-only` | メタデータのみ、書き起こしなし |
| `--transcript-only` | 書き起こしのみ、メタデータなし |
| `--no-timestamps` | タイムスタンプなしの書き起こし |
| `--no-meta` | 高速化: yt-dlp メタデータをスキップ |
### Pythonライブラリとして
```python
from video_transcriber import extract_video_id, fetch_metadata, fetch_transcript, format_markdown
video_id = extract_video_id("https://www.youtube.com/watch?v=VIDEO_ID")
meta = fetch_metadata(video_id)
transcript = fetch_transcript(video_id, languages=["de", "en"])
output = format_markdown(meta, transcript)
```
## 典型的なユースケース
- リサーチ：動画コンテンツをテキストとして引用可能にする
- 出典分析：講演における論理展開/比喩の検証
- 要約：ハルシネーションの代わりに信頼できる基盤としての書き起こし
## 制限事項
- 動画に字幕（手動または自動）がある場合のみ動作
- 自動字幕には認識エラーが含まれる場合があります
- 音声ダウンロードなし、組み込み音声認識なし
## 変更履歴
### 1.1.0 (2026-06-20)
- `yt-transcriber` から `video-transcriber` に名称変更（YouTubeのブランディングポリシー：
"yt" は明示的に禁止された略称です。RECHTSCHECK_2026-06-20.md を参照）
- スクリプト：`yt_transcriber.py` → `video_transcriber.py`
- 免責事項と依存関係ライセンスを追加（ユーザーの責任、利用規約、承認なし）
- YouTubeは情報源として記述的にのみ言及され、名前/ブランドコンポーネントとしては使用されません
- 下位互換性ラッパー `yt_transcriber.py` を旧パスに保持
### 1.0.0 (2026-06-12)
- SKILL.md を追加（ツールはスクリプト + README としてすでに存在していました）
- スクリプト v1.0.0：書き起こし + メタデータ、3つの出力フォーマット、言語優先設定