doc2video

d2v — doc2video CLI および MCP サーバー

ドキュメントや写真のフォルダーを d2v に指定すると、doc2video.io でナレーション付きの AI 生成動画を作成できます。自分で操作することも、Claude や ChatGPT（Codex）に操作させることもできます。CLI 経由でも、MCP サーバーとしても利用できます。

d2v create "Spring Open House" ./open-house --duration 1m --aspect 9:16 \
  --direction "Warm and inviting, finish on the garden" --build --wait

インストール

Node.js 18.18 以降が必要です。

npm install -g doc2video     # installs the `d2v` (and `doc2video`) command

インストールせずに実行する場合は、npx doc2video <command> を使用してください。

ログイン

d2v login

ブラウザーで doc2video が開きます。サインイン（または新規登録）し、コードがターミナルに表示されたものと一致することを確認して、Approve をクリックすれば完了です。キーは ~/.doc2video/config.json に保存され、ダッシュボードの API ページにも表示されます。ここからキーを取り消せます。このマシンでブラウザーを使えない場合は、d2v login --no-browser を実行すると、どこからでも開けるリンクが表示されます。

エージェントがリンクを表示できるように、ログインは 2 つの手順で行います。d2v login --start --json（リンクとコードを返します）を実行し、承認後に d2v login --wait を実行します。MCP 経由では、d2v_connect_account ツールが同じ処理を行います。

API ページで作成したキーを貼り付ける（d2v login --key d2v_…）か、DOC2VIDEO_API_KEY を設定することもできます。別のサーバー（ローカル開発環境など）を指定するには、--url http://localhost:3000 または DOC2VIDEO_URL を使用してください。

フォルダーに含めるもの

種類	形式	用途
ドキュメント	PDF, DOCX, PPTX, Markdown, TXT, CSV, JSON	ストーリー：これらをもとに脚本を作成します
写真	JPG, PNG, WebP, HEIC（iPhone）	脚本作成者に提示され、シーンに使用されます

フォルダーは再帰的にスキャンされます（隠しファイルはスキップされます）。古い形式の .doc／.ppt／Keynote／Pages ファイルは、変換するよう案内を表示してスキップされます。写真だけのフォルダーも使用できます。その場合、写真とクリエイティブな指示をもとにストーリーが作られます。ファイルがない場合は、--draft "description" を使用してください。

デフォルトでは写真をそのまま使用し、動画の形に合わせてトリミングします。静止画またはケン・バーンズ効果のシーンとして無料で使えます（写真から AI 動画クリップを作成するなど、AI 処理にのみ料金がかかります）。実際の被写体を保ちながら、AI で写真をシネマティックなキーフレームに仕上げるには、--photos restyle を使用してください。または、d2v scene <p> <n> --photo-treatment restyle でシーンごとに設定できます。

ワークフロー

d2v create "Name" ./folder [settings] --build --wait   # storyboard: script → keyframes → narration → preview
d2v show <project>                                     # scenes, narration, preview URL, next steps
d2v pull <project>                                     # keyframes + storyboard.md to a local folder

# steer, scene by scene
d2v keyframe  <p> 3 "warmer light, show the sign"      # edit the image
d2v keyframe  <p> 3 --fresh                            # brand-new image
d2v narration <p> 3 --prompt "shorter and punchier"    # AI rewrite + new voice-over
d2v narration <p> 3 --text "Exact words."              # exact text + new voice-over
d2v scene     <p> 3 --engine veo3                      # still | kenburns | runway | veo3
d2v scene     <p> 3 --photo IMG_2041.jpg               # feature a photo (or --photo none)
d2v run       <p> preview --wait                       # refresh the preview video

# finish (costs money — you pay in the browser)
d2v estimate <p>
d2v buy <p> --open          # or: d2v buy <p> --credits, or: d2v redeem <p> CODE
d2v produce <p> --wait      # AI clips → final assembly
d2v download <p>

無料のストーリーボードとクレジット

毎日、2 件の無料ストーリーボードと、未払いプロジェクトでのシーンの再生成 20 回が利用できます。それ以降は、ストーリーボード 1 件につき前払いクレジットから $0.50かかります。create --build、build、または run に --use-credits を渡すと確定できます（指定しない場合、コマンドは停止して料金を通知します）。クレジットを使うと、完成動画も利用できるようになります：d2v buy <p> --credits。

d2v credits                 # balance, free storyboards left today, recent activity
d2v credits add 10 --open   # top up $5, $10 or $25 in the browser

プロジェクトは、ID、8 文字の ID プレフィックス、または完全一致する名前で指定できます。d2v help <command> で各オプションを確認でき、d2v guide でワークフローガイド全体を表示できます。

設定（create と set で指定）：--duration auto|30s|1m|2m|5m|10m、--aspect 9:16|16:9、--direction、--voice（d2v voices を参照）、--stability、--photos original|restyle、--consistency／--no-consistency、--client、--email、--phone、--website。

長時間実行される手順

すべて doc2video のサーバー上で実行されます。ストーリーボードの作成には数分、最終制作にはさらに時間がかかります。--wait を指定すると、stderr に進捗を表示しながら処理を待ちます。Ctrl+C を押しても待機が終了するだけで、作業は続行されます。d2v wait <project> で再び確認できます。手順はサーバー上で連鎖させられるため、ターミナルを閉じても build は続行されます。

スクリプトとエージェント

任意のコマンドに --json を追加すると、機械可読な出力が stdout に表示されます（進行状況は stderr に表示されます）。 終了コード：0 成功、1 エラー、2 使用方法エラー、3 支払いが必要、4 --wait のタイムアウト、 5 レート制限または1日の無料利用上限に到達。

Claude または ChatGPT から利用する

ホスト型 MCP サーバー（インストール不要）

doc2video は、https://doc2video.io/mcp で MCP サーバーも実行しています。カスタム コネクターとして追加し、求められたら doc2video アカウントでサインインしてください（OAuth のため、コピーするキーはありません）。

• Claude（claude.ai、Desktop、モバイル）：Settings → Connectors → Add custom connector を選択し、URL に https://doc2video.io/mcp を指定します。
• Claude Code： claude mcp add --transport http doc2video https://doc2video.io/mcp を実行し、その後 /mcp を実行してサインインします。
• ChatGPT： サーバー URL https://doc2video.io/mcp を使ってコネクターを追加し（開発者モード）、OAuth でサインインします。
• Cursor、VS Code、その他のクライアント： 次のようなリモートサーバーのエントリーを追加します。 { "doc2video": { "url": "https://doc2video.io/mcp" } }（VS Code の場合は "type": "http"）。

ホスト型サーバーには同じツールがありますが、コンピューター上のファイルは参照できません。テキストや公開リンク （PDF、Word および PowerPoint ファイル、写真、ウェブページ）を渡すか、リンク先のプロジェクトページにファイルを追加してください。 ローカルフォルダーから作業するには、以下の CLI または d2v mcp を使用します。接続済みアプリの一覧表示と接続解除は、ダッシュボードの API ページから行えます。

Claude Code / Codex CLI（シェル）

どちらも d2v を実行するだけで使用できます。ファイルのあるフォルダーでターミナルエージェントを起動し、たとえば次のように依頼します。 「doc2video を使って、このフォルダーから60秒の縦型動画を作成し、ストーリーボードを見せて、冒頭をもっと印象的にしてください。」 より良い結果を得るには、エージェント向けの指示をインストールしてください。

• Claude Code： agents/SKILL.md を ~/.claude/skills/doc2video-cli/SKILL.md にコピーします。
• Codex CLI： agents/AGENTS.md を ~/.codex/AGENTS.md（またはフォルダー内の AGENTS.md）に追記します。

どちらのファイルもパッケージに含まれています。$(npm root -g)/doc2video/agents/ にあります。

MCP（Claude Desktop、Claude Code、Codex、任意の MCP クライアント）

d2v mcp は、ワークフロー全体を扱うツールを備えた MCP サーバーを stdio 経由で実行します。これには d2v_view_storyboard が含まれ、モデルがストーリーボードを実際に確認して視覚的なフィードバックを行えるよう、キーフレーム画像を返します。 公式の MCP Registry では io.github.doc2video/d2v として登録されています。

以下の API キーは任意です。キーがない場合、d2v_connect_account ツールがブラウザーでサインイン（または新規登録）するためのリンクを表示し、キーを記憶します。

Cursor / VS Code — このページの上部にあるボタンを使用してください。

Claude Code

claude mcp add doc2video -- npx -y doc2video mcp
# or with a key from doc2video.io/dashboard/api-keys:
claude mcp add doc2video -e DOC2VIDEO_API_KEY=d2v_xxx -- npx -y doc2video mcp

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "doc2video": {
      "command": "npx",
      "args": ["-y", "doc2video", "mcp"],
      "env": { "DOC2VIDEO_API_KEY": "d2v_xxx" }
    }
  }
}

Codex CLI — ~/.codex/config.toml：

[mcp_servers.doc2video]
command = "npx"
args = ["-y", "doc2video", "mcp"]
env = { DOC2VIDEO_API_KEY = "d2v_xxx" }

グローバルインストールを使用する場合は、npx の代わりに "command": "d2v", "args": ["mcp"] を使用できます。

ChatGPT（ウェブ／デスクトップ）： ChatGPT が接続できるのは リモート MCP サーバーのみのため、上記のホスト型サーバーを使用してください。ローカルフォルダーには Codex CLI を使用してください。

REST API

CLI は doc2video REST API の薄いクライアントです。API を直接呼び出す方法については、API.md を参照してください。

開発

npm install
npm run build      # compile to dist/
npm test           # build + end-to-end tests against a mock API (no network)
npm link           # use your local build as `d2v`

リリースは v* タグがプッシュされると GitHub Actions から npm（プロベナンス付き）および MCP Registry に公開されます。 問題の報告やプルリクエストは github.com/doc2video/cli までお寄せください。

ライセンス

CLI と MCP サーバーは MIT ライセンスです。これらは、独自の 利用規約を定めるホスト型 doc2video サービス（doc2video.io）のクライアントです。