Cliptude

Cliptude CLI + MCP

保存済みのテンプレートから動画を生成します。cliptude.com と同じアカウントとクレジットを使用します。

Cliptude の関連プロジェクト：顔出しなしの YouTube 自動化に関する優れた情報。顔出しなしチャンネル向けのツール、映像素材の提供元、YouTube のポリシーを厳選してまとめています。

セットアップ

1. CLI をインストールします：npm i -g @cliptude/cli を実行します。
2. 認証します：cliptude auth login を実行し、開いたブラウザーでサインインを完了します。
3. 関連スキルをインストールします：npx skills add cliptude/cliptude を実行します（cliptude、cliptude-script、cliptude-plan が含まれます）。

npm を使わずにこのリポジトリから実行する場合：

pip install -e .
cliptude auth login

コマンド

cliptude templates
cliptude template-options --format faceless_documentary
cliptude voices --provider elevenlabs
cliptude template-create --name "TSMC doc" --format faceless_documentary --set voice_id=<id> --set voice_name=George --set generation_model=pro --set faceless_documentary_style=investigative
cliptude template-create --name "TSMC doc" --format faceless_documentary --settings-file settings.json
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P over 10 years, keep it for beginners" --duration 3-4
cliptude estimate --template "Finance vector weekly" --script-file script.txt
cliptude avatars --section mine
cliptude generate --template "My avatar weekly" --title "Episode one" --script-file script.txt --avatar 42
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --voiceover narration.mp3
cliptude generate --template "My talking head" --title "Weekly recap" --talking-head clip.mp4
cliptude generate --template "My avatar weekly" --title "Grandma egg trick" --script-file script.txt --avatar-ai-footage --avatar-intro-only
cliptude script --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P" --duration 3-4
cliptude voiceover --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
cliptude download-voiceover <job-id> --out narration.mp3
cliptude editor <job-id>                                   # editor project id, revision, timeline item ids
cliptude agent <project-id> --prompt "Replace this shot with real footage of a TSMC fab" --items clip-1 --tier smart --wait
cliptude render <project-id> --wait                        # new MP4 of the edited timeline
cliptude continue <job-id>
cliptude status <job-id>

テンプレートがまだない場合、template-create を使うと、作成ウィザードを使わずにテンプレートを作成できます。voices から voice_id を選び、その他すべてのフィールドと選択肢、デフォルト値については template-options を確認してください（未設定のフィールドにはウィザードのデフォルト値が適用されます）。値の検証方法はウィザードと同じです。カスタム音楽、アバター、キャラクターのアップロードには、引き続きウィザードが必要です。MCP ツール：get_template_options、list_voices、create_template。Avatar Video の場合、avatars（MCP の list_avatars）で自分のアバターを一覧表示できます。template-create で --set avatar_profile_id=<id> を指定して設定するか、generate、plan-job、estimate で --avatar <id>（および --avatar-engine iv|v）を指定して動画ごとに上書きします。アバターの性別は音声と一致している必要があります。Vector Explainer の場合、vector-characters で組み込みキャストとアップロードしたキャラクターを一覧表示できます。vector-character-upload --name "Dr. Maya" --file maya.png（または --url）で独自のキャラクターを追加し、template-create で --set vector_character_id=<id> を指定するか、generate／plan-job で --vector-character <id> を指定して使用します。モーション：テンプレートで --set vector_reveal_mode=none|video を指定するか、generate、plan-job、estimate で --vector-motion none|video を指定します（none はカメラワークを加えた静止画、video は AI クリップを意味します）。サムネイル：template-create で --thumbnail-reference <YouTube link or image URL> または --thumbnail-prompt "<brief>" を指定すると、テンプレートの見た目を設定できます。同じフラグを generate と plan-job で指定すると、動画ごとに設定できます。どちらも指定しない場合、各動画はタイトルに合わせて独自のスタイル参照を選択します。

先に料金を確認するには、estimate（MCP の estimate_credits、REST の POST /api/v1/jobs/estimate）を使います。generate と同じテンプレートとプロンプト／スクリプトを指定し、アップロードの場合は --voiceover-seconds／--talking-head-seconds を指定すると、ジョブに必要なクレジットとアカウントに十分なクレジットがあるかどうかが返されます。ジョブの作成や課金は行われません。

完成した動画を修正するには、editor でタイムライン（アイテム ID、時間、テキスト）を開き、agent で Cliptude Agent に編集を依頼します（エージェントのクレジットが消費されます。--items でアイテム ID を指定します）。その後、render で新しい MP4 を書き出します。MCP ツール：open_editor_project、get_editor_project、run_agent、get_agent_run、cancel_agent_run、render_project、get_render。

エージェントが計画する動画

Faceless Documentary、Faceless Top 10、Avatar Video、Vector Explainer のテンプレートでは、エージェントがすべてのビジュアルを計画し、Cliptude にはナレーション、素材の調達、レンダリングだけを任せることができます。

1. cliptude plan-job（plan_ready で停止）、cliptude narration <job>。
2. cliptude catalog --compact を実行し、続けて --types a,b を指定するとすべての項目が表示されます（--premium はプレミアムボードのみを一覧表示します）。
3. 有効になるまで cliptude plan-check <job> plan.json を実行し、cliptude plan-lock <job> plan.json、cliptude continue <job> を実行します。 ジョブは ready_for_edit で停止します。動画は作成され、料金も発生していますが、レンダリングはされていません。
4. cliptude plan-review <job>：すべての画像またはクリップ（要求したものと使用したもの、ファイルへのリンク）と、すべてのグラフィック（描画に使う素材、または欠落している理由）を確認できます。cliptude plan-report <job> では、各フォールバックも確認できます。
5. 修正するには、同じジョブで新しいプランに対して plan-check ／ plan-lock を実行し、もう一度 continue を実行します。同じナレーションが使われ、変更のないメディアは再利用されるため、追加料金は発生しません。
6. 1 回だけレンダリングします：cliptude editor <job>、cliptude render <project> --wait。

MCP ツール：create_plan_job、get_narration、get_kind_catalog、check_plan、lock_plan、get_plan、continue_job、get_plan_review、get_plan_report、続いて open_editor_project と render_project。 プランでは、全体の見た目（テーマ、スタイル、色、音楽）、それぞれ独自のデータ、色、サウンドを持つすべてのグラフィック、各ビートの映像素材、各カットのトランジション、2 画像のリビール、無料の効果音を指定します。get_kind_catalog では、グラフィック、transitions、reveal_styles、sounds（プレビュー付き）を一覧表示します。プランのスキーマとルールは skills/cliptude-plan/SKILL.md にあります。ジョブの料金はウェブサイトの料金と同じです。

--title は必須です。--prompt、--script ／ --script-file、--voiceover、--talking-head のいずれか 1 つ を指定します。タイトルを --prompt にコピーしないでください。トピックしかない場合は、cliptude-script（ウェブ検索 → ナレーション原稿の作成 → --script-file）に従うか、cliptude script を使って Cliptude に作成を依頼してください。script または voiceover ジョブの完了後に cliptude continue <job-id> を実行すると、同じジョブをフル動画に変換します（スクリプトを再利用し、voiceover ジョブでは TTS ファイルを再利用します）。--voiceover はローカルの音声ファイルです（create.html と同じ）。文字起こしされ、TTS はスキップされます。prompt／script と組み合わせないでください。--talking-head は Talking Head テンプレート用のプレゼンター動画（MP4、MOV、WEBM、AVI）です。文字起こしされ、TTS はスキップされます。省略可能な --duration はウィザードの時間区分です（3-4、6-8、10-12、…）。省略すると、テンプレートの長さが使われます。--script を指定した場合は、語数に基づく推定時間が使われます。アップロードした音声または talking-head 動画を指定すると、ファイルに基づいて長さが設定されます。Avatar Video テンプレートでは、--avatar-intro-only ／ --no-avatar-intro-only と --avatar-ai-footage ／ --no-avatar-ai-footage を指定して、Avatar Intro Only と AI Image + AI Video を上書きできます。これらのフラグを省略すると、テンプレートの設定が維持されます。generate ／ script ／ voiceover ／ continue はすぐに戻ります（queued）。status をポーリングしてください。

MCP

リモート Streamable HTTP：https://mcp.cliptude.com/mcp（OAuth または Bearer）。

cliptude-mcp

認証なしで POST /mcp を実行すると、RFC 9728 のメタデータを指す WWW-Authenticate ヘッダーとともに 401 が返されます。 Stdio は JSON-RPC 以外を stdout に書き込みません。