mcpField
A
audio-extract

audio-extract

github.com/agntswrmクリエイティブ・メディア639 回インストール34 週間前に更新
リポジトリ

audio-extract について

audio-extractは、同梱のffmpegを使って動画から音声を取り出すスキルです。APIキーや外部サービスを使わずローカルで処理でき、文字起こし用の音声準備などに利用できます。

主な機能

  1. 01動画ファイルやURLから音声を抽出
  2. 02MP3またはWAV形式を選択
  3. 03出力先のパスやディレクトリを指定
  4. 04同梱ffmpegによるローカル処理

活用シーン

  1. 01インタビュー動画から文字起こし用音声を作成
  2. 02動画の音声を別ファイルとして保存

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agntswrm/agent-media --skill audio-extract

インストール後、Claude Code で/audio-extractを入力して読み込まれたか確認します。

詳細

音声を抽出

動画ファイルから音声トラックを抽出します。バンドルされた ffmpeg バイナリを使用するローカル操作のため、API キーや外部サービスは必要ありません。

コマンド

npx agent-media@latest audio extract --in <path> [options]

入力

オプション必須説明
--inはい入力動画のファイルパスまたは URL（mp4、webm、mkv、avi、mov に対応）
--formatいいえ出力音声形式：mp3（デフォルト）または wav
--outいいえ出力先のパス、ファイル名、またはディレクトリ（デフォルト：./）

出力

抽出した音声ファイルを含む JSON オブジェクトを返します：

{
  "ok": true,
  "media_type": "audio",
  "action": "extract",
  "provider": "local",
  "output_path": "extracted_123_abc.mp3",
  "mime": "audio/mpeg",
  "bytes": 24779
}

例

音声を MP3 として抽出（デフォルト）：

npx agent-media@latest audio extract --in video.mp4

音声を WAV として抽出：

npx agent-media@latest audio extract --in video.mp4 --format wav

出力先ディレクトリを指定：

npx agent-media@latest audio extract --in video.mp4 --out ./audio-files

ユースケース：動画の文字起こしワークフロー

文字起こしサービスは音声ファイル（アップロード容量が小さく、処理が速い）に最適化されているため、次のワークフローを使用してください：

# Step 1: Extract audio from video (local, instant)
npx agent-media@latest audio extract --in interview.mp4 --format mp3
# Output: extracted_xxx.mp3

# Step 2: Transcribe the audio (cloud API)
npx agent-media@latest audio transcribe --in extracted_xxx.mp3 --provider fal

プロバイダー

このアクションは、バンドルされた ffmpeg（ffmpeg-static 経由）を使用するローカルプロバイダーを利用します。API キーは必要ありません。

コメント

Markdown 対応