botverse

botverse-mcp

Botverse 用の MCP サーバー兼コマンドラインツールです。AI エージェントと、その設定を行う人のための動画トランスコードとドキュメント変換を提供します。

できること

• 動画のトランスコード — MP4（H.264）、WebM（VP9）、ProRes 422、GIF、MP3 抽出 · 1 ジョブあたり $0.25
• 動画／音声のコンフォーム — 別々の動画ソースと音声ソースを 1 つの出力に多重化し、フレームレートや再生時間の不一致を調整します（24→25fps など、真のプルダウン方式による速度調整を含む）· 1 ジョブあたり $0.30
• コンフォームスプライス — 動画および／または静止画像のセグメントを連結して 1 つの出力を作成します。冒頭のスレート／バンパー、末尾のスレート／エンドカード、ミッドロールの挿入／カットアウェイ、クリップの結合に対応します · $0.30 から／ジョブ
• ドキュメント変換 — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05／ファイル
• 文字起こし — 話者ラベル付きの文字起こし（話者ダイアライゼーション＋AI による話者名の付与）→ txt/srt/vtt/docx/pdf · 約 $3／時間
• ワークフロー — 複数の Botverse 操作（トランスコード、変換、文字起こし、コンフォーム、スプライス）を、依存関係の自動順序付けと並列ブランチを備えた複数ステップの単一ジョブにまとめます。各呼び出しを自分で調整する必要はありません · 変換のみのステップはウォレット残高で実行されます（$0.05／ステップ）。トランスコード／文字起こしのステップはソースの再生時間に基づいて課金され、自動チャージが必要です

利用方法は 2 つあります。AI エージェント向けの MCP サーバーと、シェル向けの botverse CLIです。評価、CI/CD、cron、スクリプト、ローカルのコーディングエージェントに利用できます。AWS も FFmpeg もインフラも不要です。

セットアップ

1. botverse.cloud で登録します — 無料でお試しいただけます：登録時に $1 のクレジットが付与され、カードは不要です。 カードと 2FA が必要になるのは、初回のチャージ時のみです（最低 $5）。月額料金はありません。
2. ダッシュボードから API キーまたはコネクター URL を取得します
3. MCP クライアントの設定に追加します

使い方

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_API_KEY": "bv_live_..."
      }
    }
  }
}

または、コネクター URL を使います（claude.ai にはこちらを推奨します）。

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
      }
    }
  }
}

コマンドライン（botverse）

同じパッケージに、シェル向けの botverse CLI が含まれています。ディスク上のファイルを読み込み、 LLM を介さずに API へ直接ストリーミングするため、評価、自動化、ローカルのコーディングエージェントで 高速に利用できます。

export BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…

npx botverse convert report.md --to pdf
npx botverse convert *.md --to docx,pdf -o ./out
npx botverse transcode clip.mov --to mp4 -o ./out
npx botverse transcribe call.mp4 --to docx --attendees "Sarah Chen,Mike Torres"
npx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25
npx botverse balance

各ジョブでは、アップロード → ポーリング → 完了したファイルの -o へのダウンロード（デフォルト：カレントディレクトリ）が行われます。 グロブと複数の --to 形式を指定すると、バッチとして実行されます。

サンドボックスに関する注意： CLI は botverse.cloud と Botverse のファイルストレージホストへの外向きネットワーク接続を必要とするため、 egress が許可リスト方式になっているサンドボックス化されたエージェント環境（claude.ai / Claude Desktop）では 実行できません。その場合は、MCP ツール（例：convert_content）を使用してください。

ツール（MCP）

ツール	説明
get_upload_url	_media／_file／_video（オブジェクトキーを使用する）ツールで使用するファイルをアップロードするための、署名付きURLを取得します
transcode_from_url	公開URLから動画をトランスコードします
transcode_video	アップロードされた動画ファイルをトランスコードします
conform_from_url	別々の動画と音声のソース（公開URL）を1つの出力に多重化します
conform_media	アップロードされた動画と音声のソースを1つの出力に多重化します
conform_splice_from_url	動画／画像のセグメント（公開URL）を連結します（スレート、バンパー、エンドカード、インサート、クリップの結合）
conform_splice_media	アップロードされた動画／画像のセグメントを連結します（用途は同じです）
convert_content	ドキュメントのコンテンツをインラインで変換します（最大4 MB、サンドボックスで安全に実行できます）
convert_from_url	公開URLからドキュメントを変換します
convert_file	アップロードされたドキュメントを変換します
submit_workflow	上記の複数のツールを依存関係の順序と並列ブランチを指定して連結する、複数ステップのBWDLワークフローを送信します
get_workflow_status	ワークフロー（および各ステップのステータス）を終端状態に達するまでポーリングします
cancel_workflow	進行中のワークフローをキャンセルします。完了済みのステップは課金され、残りは課金されません
get_job_status	ジョブが完了するまでポーリングします
get_download_url	署名付きダウンロードURLを取得します
get_wallet_balance	ウォレット残高を確認します

ワークフロー

submit_workflow は複数のBotverseツール（トランスコード、変換、文字起こし、コンフォーム、スプライス）を1つのサーバー側ジョブに連結します。たとえば、エージェントが個々にツールを呼び出してポーリングする代わりに、文字起こし→クリップ抽出→納品を実行できます。

• ワークフロー定義にはBWDL（Botverse Workflow Definition Language）を使用します。workflow_idとsteps配列を含むJSONオブジェクトです。各ステップにはid、tool（任意のMCPツール名）、inputsオブジェクト、および任意の先行ステップIDのdepends_on配列があります。
• ステップは依存関係の順序で実行されます。同じdepends_onを持つステップは並列で実行されます。
• 後続のステップでは"$.steps.<step_id>.output_key"を使って先行ステップの出力を参照でき、ワークフローレベルのパラメーターは"$.params.<name>"で参照できます。これ以外のテンプレート構文はサポートされていません。
• submit_workflowで送信し、COMPLETED、FAILED、PARTIALLY_FAILED、CANCELLEDのいずれかのステータスになるまで、5～10秒ごとにget_workflow_statusでポーリングします。必要に応じてcancel_workflowで早期に停止できます（課金対象となるのは完了済みのステップのみです）。
• 課金：変換のみのワークフローは、ウォレット残高から1ステップあたり$0.05で課金されます。トランスコードまたは文字起こしのステップを含むワークフローでは、自動補充を有効にする必要があります（課金額はソースの長さに応じて変わります）。

例 — 2ステップの変換チェーン（URL → DOCX → PDF）：

{
  "workflow_id": "md-to-pdf-via-docx",
  "steps": [
    {
      "id": "to_docx",
      "tool": "convert_from_url",
      "inputs": {
        "source_url": "https://example.com/report.md",
        "output_format": "docx"
      }
    },
    {
      "id": "to_pdf",
      "tool": "convert_file",
      "depends_on": ["to_docx"],
      "inputs": {
        "object_key": "$.steps.to_docx.output_key",
        "output_format": "pdf"
      }
    }
  ]
}

料金

• 動画のトランスコード（5分以下）：1ジョブあたり$0.25
• 動画の超過分：1分あたり+$0.08
• ProRes 422：ソース1分あたり$0.35（最低$0.50）
• ドキュメント変換：1ファイルあたり$0.05

クレジットに有効期限はありません。料金の詳細 →

リンク

• ドキュメント
• ダッシュボード
• サポート