PodVoiceドキュメント

MCP対応33ツールREST API

PodVoice ドキュメント

AI エージェント（Claude・GPT など）からポッドキャスト編集を自動化するための MCP Server と REST API のリファレンス

クイックスタート

2ステップで Claude から PodVoice を操作できます。

APIキーを取得

ダッシュボード → Claude 連携 →「新しいキーを発行」。pv_ から始まる文字列です。

APIキーを発行 →

Claude Desktop に MCP Server を登録

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

json

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

Claude Desktop を再起動すると「podvoice: ✓ Connected」と表示されます。

Claude に話しかけてみる

「最新の録音を見せて」

「録音を-14LUFSに正規化して無音区間を削除して」

「stylishなBGMを探してイントロとアウトロに追加して、プロジェクト名は今週号で」

「プロジェクトのBGM音量を0.1にして」

Claude MCP 連携

推奨

MCP（Model Context Protocol）を使うと、Claude が直接 PodVoice のツールを呼び出せます。自然言語の指示だけで録音の確認・編集・書き出しまで自動化できます。

🎙Discord 録音の確認・検索

✂️トリム・ノイズ除去・フィラー除去

🎵BGM 検索・追加（Jamendo CC）

📊音量正規化・無音除去

🎭ボイスチェンジ（20種類）

📋マルチトラックプロジェクト管理

📝文字起こし

⬇️WAV ダウンロード URL 取得

MCPツール一覧

33ツール

録音の確認・管理

get_status()プラン・API残り回数・ストレージ確認

get_recordings()録音一覧（limit で件数指定）

recordings_latest()最新の録音1件をすぐに取得

search_recordings()ファイル名・日付で検索

get_recording_info()詳細情報・試聴 URL を取得

export_audio()署名付きダウンロード URL（1時間有効）

rename_recording()ファイル名を変更

duplicate_recording()録音をコピー（編集前バックアップ用）NEW

delete_recording()録音を削除（confirm: true が必要）

音声処理

trim_audio()開始・終了秒を指定してトリム

normalize_audio()音量を LUFS に正規化（デフォルト -14LUFS）NEW

remove_silence()無音区間（デッドエア）を自動除去NEW

reduce_noise()環境ノイズ・ハム音を除去

detect_fillers()フィラー語を検出して一覧を返す（ドライラン・音声は変更しない）NEW

remove_fillers()「えー」「あのー」等を自動除去

get_voice_types()利用可能なボイスタイプ一覧を返す（Free / Pro 別）NEW

change_voice()ボイスチェンジ（robot / pitch_up / child など）

adjust_volume()全体または区間単位で音量（dB）調整

transcribe_recording()文字起こしNEW

BGM・素材

search_bgm()Jamendo CC楽曲をキーワード/スタイルで検索（商用利用可）NEW

add_bgm()BGM をイントロ・アウトロ・両方に追加。project_name でマルチトラックプロジェクトも同時作成

結合・パイプライン

concatenate_recordings()複数録音を順番に結合（gap_seconds で間隔調整）

pipeline()複数ステップをまとめて実行（noise→filler→bgm→export など）

プロジェクト管理（GUI と連動）

list_projects()プロジェクト一覧

create_project()プロジェクトを作成。recording_id でトラックを初期設定NEW

get_project()プロジェクト詳細（タイムライン state を含む）NEW

describe_project()タイムライン構成を AI 向けに読み上げNEW

rename_project()プロジェクト名を変更NEW

delete_project()プロジェクトを削除NEW

list_project_regions()voice/BGM/SE トラック一覧（音量・フェード情報付き）NEW

add_region_to_project()録音を既存プロジェクトのタイムラインに追加NEW

remove_region_from_project()プロジェクトから特定トラックを削除NEW

update_region()トラックの音量・フェード・位置を変更（GUI の右クリックと同等）NEW

open_in_editor()プロジェクトのエディタ URL を返す（ブラウザで開ける）NEW

AI編集ワークフロー

AI が方向性を決めて、GUI で微調整。この流れが PodVoice の強みです。

🎯

プロ品質ポッドキャスト自動生成

text

① normalize_audio(id, target_lufs=-14)   # Spotify/Apple 標準に統一
② remove_silence(id, min_silence_sec=1)  # デッドエアを自動カット
③ search_bgm(query="acoustic warm")       # CC楽曲を検索
④ add_bgm(id, position="both",            # BGM追加 + プロジェクト作成
           bgm_url="...",
           project_name="EP01")
⑤ describe_project(project_id)           # タイムラインを確認
⑥ update_region(project_id, "bgm-0",     # BGM音量を微調整
                volume=0.1, fade_in=4)
⑦ export_audio(recording_id)             # ダウンロード

🤖→🎨

AI で下書き → GUI で仕上げ

AI がプロジェクトを作ると、ブラウザエディタで voice・BGM・SE が別レイヤーで表示されます。右クリックでフェード・音量を微調整して「WAV書き出し」するだけ。

https://www.podvoice.jp/editor?project=<project_id>

📚

複数録音の組み合わせ

text

① 各録音を normalize_audio で -14LUFS に揃える（並列実行可）
② remove_silence で各録音のデッドエアを除去
③ concatenate_recordings([id1, id2, id3], gap_seconds=0.8)
④ add_bgm(concat_id, position="both", style="podcast",
           project_name="2026年5月号")

プロジェクト管理

NEW

プロジェクトは GUI エディタのタイムライン状態（voice / BGM / SE の複数トラック）を保存します。 AI で作った構成をブラウザで確認・編集できます。

タイムライン構成のイメージ

// describe_project() の出力例

[BGM イントロ] 0s ──── 8s vol:0.10 fade:3s

[voice-0] 8s ──────────── 31s vol:1.00

[BGM アウトロ] 31s ─── 39s vol:0.10 fade:3s

各トラックは update_region() で音量・フェード・開始位置を個別に調整できます。変更は即座にブラウザエディタに反映されます。

REST API リファレンス

すべてのリクエストに Authorization: Bearer <APIキー> ヘッダーが必要です。
ベースURL: https://www.podvoice.jp

GET/api/recordings

録音一覧（?limit=20）

GET/api/recordings/:id

録音詳細・URL

GET/api/mcp/status

プラン・使用量

POST/api/mcp/trim

トリム

POST/api/mcp/normalize

音量正規化NEW

POST/api/mcp/remove-silence

無音除去NEW

POST/api/mcp/noise-reduce

ノイズ除去

POST/api/mcp/filler-remove

フィラー除去

POST/api/mcp/voice-change

ボイスチェンジ

POST/api/mcp/adjust-volume

音量調整（dB・区間指定）

POST/api/mcp/transcribe

文字起こし

POST/api/mcp/duplicate

録音コピーNEW

POST/api/mcp/concatenate

結合

POST/api/mcp/add-bgm

BGM追加（マルチトラック対応）

GET/api/mcp/search-bgm

BGM検索（Jamendo）NEW

POST/api/mcp/pipeline

パイプライン実行

GET/api/mcp/projects

プロジェクト一覧

POST/api/mcp/projects

プロジェクト作成

GET/api/mcp/projects/:id

プロジェクト詳細

PUT/api/mcp/projects/:id

プロジェクト更新

DELETE/api/mcp/projects/:id

プロジェクト削除

GET/api/mcp/projects/:id/regions

リージョン一覧NEW

POST/api/mcp/projects/:id/regions

リージョン追加NEW

DELETE/api/mcp/projects/:id/regions

リージョン削除NEW

POST/api/mcp/projects/:id/region

リージョン更新NEW

curl 実行例

bash

# 録音一覧
curl -H "Authorization: Bearer pv_xxx" \
  https://www.podvoice.jp/api/recordings

# 正規化（-14LUFS）
curl -X POST \
  -H "Authorization: Bearer pv_xxx" \
  -H "Content-Type: application/json" \
  -d '{"recording_id": "abc123", "target_lufs": -14}' \
  https://www.podvoice.jp/api/mcp/normalize

# BGM 検索
curl -H "Authorization: Bearer pv_xxx" \
  "https://www.podvoice.jp/api/mcp/search-bgm?q=acoustic+podcast&limit=5"

# プロジェクトのトラック一覧
curl -H "Authorization: Bearer pv_xxx" \
  https://www.podvoice.jp/api/mcp/projects/PROJECT_ID/regions

レート制限

Free プラン

月間 API 呼び出し回数

50 回/月

Pro プラン

月額 980円（税込）

無制限

上限到達時（HTTP 429）

json

{
  "error": "月間API呼び出し回数の上限（50回）に達しました。",
  "remaining": 0,
  "reset_at": "2026-06-01",
  "upgrade_url": "https://www.podvoice.jp/dashboard"
}

AI向けリソース

AI エージェントや LLM が PodVoice の仕様を効率よく読むためのリソースです。

llms.txt開く →

AI ツール向けの概要仕様。MCP ツール一覧・推奨ワークフロー・API エンドポイントをコンパクトにまとめています。

llms-full.txt開く →

詳細仕様書。全ツールのパラメータ・レスポンス型・エラーコード・AudioRegion 型定義を含む完全版。

システムプロンプトへの組み込み例

text

# PodVoice の仕様
# 最新情報: https://www.podvoice.jp/llms-full.txt

あなたは PodVoice（ポッドキャスト編集サービス）のアシスタントです。
ユーザーの録音を MCP ツールで編集し、プロ品質のポッドキャストを作成します。

処理の基本フロー:
1. normalize_audio で -14LUFS に統一
2. remove_silence でデッドエアを除去
3. search_bgm で楽曲を選択
4. add_bgm でマルチトラックプロジェクトを作成
5. describe_project でタイムラインを確認・報告

Claude から PodVoice を使ってみよう

無料プランで50回/月まで。クレジットカード不要。

APIキーを発行 →llms.txt を読む