# PodVoice

> Discord の録音を AI（Claude・GPT など）から直接編集できる、完全日本語対応のポッドキャスト編集サービス。
> MCP（Model Context Protocol）Server と REST API を公開しており、AI エージェントが自律的にポッドキャスト制作を実行できる。

- URL: https://www.podvoice.jp
- MCP Server: https://www.npmjs.com/package/podvoice-mcp（npx で即起動）
- API Base: https://www.podvoice.jp
- 認証: `Authorization: Bearer <APIキー>` （pv_ から始まるキー）
- ドキュメント: https://www.podvoice.jp/docs
- llms-full.txt（詳細仕様）: https://www.podvoice.jp/llms-full.txt

## MCP Server セットアップ（最速）

```json
{
  "mcpServers": {
    "podvoice": {
      "command": "npx",
      "args": ["-y", "podvoice-mcp"],
      "env": { "PODVOICE_API_KEY": "pv_xxxx" }
    }
  }
}
```

## 利用可能な MCP ツール（36個）

### 録音の確認・管理
- `get_status()` — プラン・API残り回数・ストレージ確認
- `get_recordings(limit?)` — 録音一覧（最大100件）
- `recordings_latest()` — 最新の録音1件
- `search_recordings(query?, after?)` — ファイル名・日付で検索
- `get_recording_info(recording_id)` — 詳細情報・URL
- `export_audio(recording_id)` — ダウンロードURL取得
- `rename_recording(recording_id, new_name)` — ファイル名変更
- `duplicate_recording(recording_id, new_name?)` — コピー（編集前バックアップ用）
- `delete_recording(recording_id, confirm)` — 削除（取り消し不可）

### 音声処理
- `trim_audio(recording_id, start_sec, end_sec)` — トリム
- `reduce_noise(recording_id)` — ノイズ除去
- `detect_fillers(recording_id)` — フィラー語を検出して一覧を返す（ドライラン・音声変更なし）
- `remove_fillers(recording_id)` — フィラー語除去（えー・あのー等）
- `get_voice_types()` — 利用可能なボイスタイプ一覧（Free / Pro 別）
- `change_voice(recording_id, voice_type)` — ボイスチェンジ（robot / pitch_up / child など）
- `adjust_volume(recording_id, gain_db, segments?)` — 全体/区間単位の音量調整
- `normalize_audio(recording_id, target_lufs?)` — 音量正規化（デフォルト -14LUFS、ポッドキャスト標準）
- `remove_silence(recording_id, min_silence_sec?, threshold_db?)` — 無音区間の自動除去
- `transcribe_recording(recording_id)` — 文字起こし

### BGM・素材
- `search_bgm(query?, style?, limit?)` — Jamendo CC楽曲をキーワード/スタイルで検索
- `add_bgm(recording_id, position, style, project_name?)` — BGM追加。project_name を指定するとマルチトラックプロジェクトも自動作成

### 結合・パイプライン
- `concatenate_recordings(recording_ids, gap_seconds?)` — 複数録音を結合
- `pipeline(recording_id, steps)` — 複数処理をまとめて実行

### プロジェクト管理（GUI マルチトラック編集と連動）
- `list_projects()` — プロジェクト一覧
- `create_project(name, recording_id?)` — プロジェクト作成
- `get_project(project_id)` — 詳細取得
- `describe_project(project_id)` — タイムライン構成を AI 向けに読み上げ
- `rename_project(project_id, name)` — 名前変更
- `delete_project(project_id, confirm)` — 削除
- `list_project_regions(project_id)` — トラック一覧（voice/BGM/SE）
- `add_region_to_project(project_id, recording_id, type?, start_time?, volume?)` — トラック追加
- `remove_region_from_project(project_id, region_id)` — トラック削除
- `update_region(project_id, region_id, volume?, fade_in?, fade_out?, start_time?)` — トラック音量・フェード調整
- `open_in_editor(project_id)` — プロジェクトのエディタ URL を返す（ブラウザで開ける）

## 推奨ワークフロー（AI エージェント向け）

### プロ品質ポッドキャストの自動生成
```
1. normalize_audio(recording_id, target_lufs=-14)  # 音量を -14LUFS に統一
2. remove_silence(recording_id, min_silence_sec=1)  # デッドエアを除去
3. search_bgm(query="acoustic podcast", limit=5)    # BGM を検索
4. add_bgm(recording_id, position="both", project_name="今週のエピソード")
   → GUI エディタで voice/BGM 別レイヤーで確認・微調整可能
5. update_region(project_id, "bgm-0", volume=0.1, fade_in=4)  # BGM の音量調整
```

### AI で方向性決め → GUI で仕上げ
```
1. AI がおおまかな構成を自然言語で指示
2. describe_project(project_id) でタイムラインを確認
3. update_region() で個別トラックを微調整
4. ブラウザエディタ (https://www.podvoice.jp/editor?project=xxx) で視覚確認
5. WAV 書き出し
```

## サービスの特徴

- **Discord 連携**: Discord Bot が参加者別トラックを 48kHz WAV で自動録音
- **AI/CLI ファースト**: 全機能が MCP・REST API で操作可能（GUI は補助）
- **マルチトラックプロジェクト**: AI が作った構成を GUI で視覚確認・微調整できる
- **完全日本語**: UI・ドキュメント・エラーメッセージすべて日本語

## プラン

| プラン | 月間 API 呼び出し | 価格 |
|--------|----------------|------|
| Free   | 50回/月         | 無料 |
| Pro    | 無制限           | 980円/月 |

エラー: HTTP 429 + `{ "remaining": 0, "reset_at": "YYYY-MM-01" }`

## お問い合わせ

- Email: support@podvoice.jp
- X: @PodVoiceJP