Prosey

Prosey は、YouTube から動画の文字起こしをダウンロードして表示する CLI ツールです。何時間も無駄にせず、必要な情報を素早く得られます。

主なユースケースは以下の通りです。

• 要約 - YouTube 動画を要約し、1 つのコマンドで CLI に表示します（より素早く）。
• 読む - 動画のキャプションを、元の動画のようにチャプターで整理・整形して表示します（場合により時間がかかります）。

どちらの用途でも、システム上に AI アシスタントが必要です（デフォルト: opencode。独自のものを設定するには prosey config を使用してください）。

シンタックスハイライターがシステムに検出されると、カラー出力が適用されます。

Prosey は、ネイティブの JSON 形式をそのまま出力または保存することもできます。

機能

クイックスタート

npx ですぐに試せます。

npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt

インストール

お好みのパッケージマネージャーでグローバルインストールします。

npm install -g @tacone/prosey
# or
yarn global add @tacone/prosey
# or
pnpm add -g @tacone/prosey
# or
bun install -g @tacone/prosey

その後、どこでも使用できます。

prosey 771PQEDeRmw

ソースから

開発には Bun を使用しています。スクリプト、パッケージ管理、TypeScript ソースの直接実行に利用します。

git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw

使い方

prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey config
prosey help

summarize がデフォルトのコマンドです。そのため prosey <id> で AI 要約が実行されます。 prosey read <id> を使用すると、リッチに整形された文字起こしをダウンロードして表示します。

summarize コマンドは文字起こしを取得し、設定の [summarize] セクションのプロンプトを先頭に付加して、設定された AI コマンドにパイプします。

read コマンドは文字起こしをダウンロードし、stdout に表示します（プレーンテキスト、Markdown、または JSON）。AI 処理が不要な場合に便利です。

info コマンドは動画のメタデータ（タイトル、チャンネル、再生時間、視聴回数）を表示します。

config コマンドは設定ファイルを $EDITOR で開きます。$EDITOR が未設定の場合は、設定ファイルのパスが表示されます。

help コマンドは --help と同じヘルプメッセージを表示します。

例

# Summarize (AI summary + formatting + syntax highlighting)
prosey 771PQEDeRmw

# Summarize (same as above)
prosey summarize 771PQEDeRmw

# Transcribe (AI summary + formatting + syntax highlighting)
prosey read 771PQEDeRmw

# Show video metadata
prosey info 771PQEDeRmw

# Edit config in $EDITOR
prosey config

# List available languages
prosey read https://youtu.be/771PQEDeRmw --list

# Specify language
prosey read https://youtu.be/771PQEDeRmw --lang es

# Display JSON (no AI transcription)
prosey read 771PQEDeRmw

# Display plain text (no AI transcription)
prosey read 771PQEDeRmw

# Save transcript to file
prosey read 771PQEDeRmw -o transcript.txt

オプション

JSON 形式

--json を使用すると、出力はオブジェクトの配列になります。

[
  {
    "text": "♪ We're no strangers to love ♪",
    "offset": 18.64,
    "duration": 3.24,
    "timestamp": "00:18"
  }
]

JSON モードでは timestamp は常に存在します。JSON は構造化データであるため、動画詳細は（暗黙的に）抑制されます。

開発

このプロジェクトは開発に Bun を使用しています。

bun run typecheck   # TypeScript check
bun run start       # Run the CLI from source
bun run test        # Run unit tests
bun run build       # Compile Node bundle to bin/prosey

npm に公開する前に、prepack フックによって bun run build が自動実行され、bin/prosey に Node 互換の JS バンドルが生成されます。

設定

Prosey は TOML ファイルから設定を読み取ります。場所は XDG Base Directory Specification に従います（~/.config/prosey/config.toml）。または、PROSEY_CONFIG_PATH 環境変数を設定してカスタムパスを使用することもできます。

設定ファイルは初回実行時にデフォルト値で自動生成されます。--reset-config を使用していつでもデフォルトに戻せます。

pager

文字起こしと要約出力のページャーコマンド。デフォルトは "auto" で、次のうち最初に見つかったものを検出します: bat -lmd --style plain → glow -p → mdcat -l -p → less。カスタムコマンド（例: "less -R"）に設定して上書きすることもできます。PROSEY_PAGER 環境変数はこの設定よりも優先されます。

[summarize]

[summarize] セクションは summarize コマンドを設定します。

PROSEY_PAGER

ページャーコマンドを設定する環境変数。pager 設定値よりも優先されます。"auto" または空に設定すると自動検出になります。

キャッシュ

文字起こしと要約は /tmp/prosey/ にキャッシュされます。同じ動画とオプションで繰り返し実行すると即座に結果が返り、オフラインでも動作します。--no-cache を使用するとキャッシュ読み取りをスキップし、強制的に新規取得します。

prosey summarize を実行すると、コマンドはその動画のキャッシュディレクトリ内で実行されます。これにより、AI エージェントがカレントフォルダのプロジェクト固有ファイル（AGENTS.md や CLAUDE.md など）を拾うのを防ぎ、そのディレクトリ外のファイルを変更する能力も制限されます。

終了コード

仕組み

Prosey は、youtube-transcript-plus ライブラリを介して YouTube の Innertube API を使用しています。API キーやブラウザ自動化は不要です。

このツールは、手動で作成されたキャプションと自動生成された文字起こし（YouTube の音声認識）の両方に対応しています。自動検出は、YouTube のプレイヤー応答が提供する順序で言語をフォールバックします。