ShortSmash

ShortSmash ⚒️

プロンプトを入力。完成したショート動画を出力。

ShortSmash は、1 文の指示、または今日のトレンドをもとに、字幕付きの完成した 9:16 のショート動画を制作し、YouTube、TikTok、Instagram、X、Threads、Bluesky、LinkedIn、Pinterest、Facebook（プロフィールとページ）に公式 APIを通じて公開する AI 動画スタジオです。台本、ナレーション、検証済みのストック映像、カラオケ字幕、音楽の音量調整、トレンド収集、バッチ制作、スケジュール設定、コメント返信の下書きまで、すべてを 1 つの CLI で実行できます。さらに、AI エージェントが制作工程全体を操作できる MCP サーバーも備えています。

shortsmash trends food                    # what's hot right now (free, no keys)
shortsmash batch food --count 5           # turn the top 5 trends into 5 videos
shortsmash serve                          # 🆕 web studio: http://localhost:8000
shortsmash agent "make a 30s reel about coffee and post it Friday at 6pm"
shortsmash post myvideo.mp4 --caption     # post YOUR video: AI title + hashtags
shortsmash post myvideo.mp4 --at "Friday 6pm" --platforms youtube,tiktok

git clone https://github.com/hydope/shortsmash && cd shortsmash
./install.sh                          # Windows: .\install.ps1
shortsmash "why you can't tickle yourself"   # prompt in, finished short out

🏆 注目の掲載先

ShortSmash は、厳選された awesome リストに掲載されています（PR はマージ済みです）。

• ToolkitlyAI/awesome-ai-tools — AI 動画
• TensorBlock/awesome-mcp-servers — MCP レジストリのプロフィールが tensorblock.co で公開中
• sajadh76/awesome-AI-tools — 動画生成
• mcpHQ/awesome-mcp-servers — MCP サーバー
• Jenqyang/Awesome-AI-Agents — AI エージェント
• Official MCP Registry — io.github.hydope/shortsmash。pip install shortsmash でインストールできます

🏗️ アーキテクチャ

flowchart LR
    P["Prompt / trend"] --> LLM["LLM: script + shot plan<br/>(NVIDIA · Gemini · Grok)"]
    LLM --> TTS["Neural TTS<br/>(50 languages)"]
    LLM --> VIS["Visuals<br/>(Pixabay · Agnes · Veo 3.1 · Kling)"]
    VIS --> GATE["Vision gate<br/>(CLIP + Gemini)"]
    GATE -->|reject| VIS
    TTS --> REN["FFmpeg render<br/>1080×1920 · karaoke captions<br/>cinematic grade · music"]
    GATE --> REN
    REN --> DUB["Dub engine<br/>(50 languages)"]
    REN --> PUB["10 publishers<br/>(official APIs)"]
    DUB --> PUB
    PUB --> SCHED["Scheduler<br/>(SQLite · 'Friday 6pm')"]

🖥️ ShortSmash Studio（Web UI）

shortsmash serve を実行すると、ブラウザーで軽快なダークテーマのスタジオが起動します。ビルド手順は不要です。

• 🎬 スタジオタブ — トピックを入力して「Smash」をクリックすると制作が始まり、動画をその場でプレビューできます
• 📈 トレンドタブ — ジャンルごとの注目トレンドを確認し、気になるトレンドをクリックしてトピックに設定できます
• 📚 ライブラリータブ — すべてのプロジェクト、動画プレビュー、ワンクリックでの公開を利用できます
• 📤 手動投稿 — 自分の動画をアップロードし、投稿前チェック（解像度、再生時間、プラットフォームごとの上限）を受けて、AI が作成したタイトルとハッシュタグを追加したうえで、今すぐ投稿するか、「金曜日の午後 6 時」のように指定して 10 のプラットフォームに予約投稿できます
• 📊 統計タブ — 出力状況をひと目で確認できます

🎬 デモ

ShortSmash だけで、最初から最後まで自動生成しています。人が選んだクリップも、人による編集もありません。LLM による台本、ニューラル音声、CLIP で検証したストック映像、カラオケ字幕、ナレーションに合わせて音量を下げた BGM。

「ヤギがあなたをコーヒー中毒にした理由」 — 49秒、1080×1920、1つのプロンプトから作成。クリックして再生：

同じ動画を別の声で再生 — ネイティブのニューラル音声、映像素材は同じものを検証済み：

スペイン語 · ウルドゥー語 · ローマ字ウルドゥー語 · 中国語 — マンダリン版は、翻訳調ではないネイティブ音声と、漢字のカラオケ字幕を使用しています。1つのプロジェクトで、あらゆる視聴者に届けられます。

その他のデモ — どれも1つのプロンプトから作成。クリックして再生：

自分で自分をくすぐれない理由 — 11秒、1080×1920

地球上で最も深い場所 — 14秒、1080×1920

年を取るほど時間が速く過ぎる理由 — 11秒、1080×1920

📤 AI を使わず、自分の動画を投稿する

動画をアップロードすると、投稿前チェック（解像度、長さ、プラットフォームごとの制限）、AI が作成するタイトルとハッシュタグを利用でき、すぐに投稿するか、「金曜午後6時」のように指定して10のプラットフォームに予約投稿できます。Studio の Publish タブから、または次のコマンド1つで実行できます：shortsmash post myvideo.mp4 --caption

🖥️ ShortSmash Studio

shortsmash serve — ブラウザーから動画の生成、トレンドの閲覧、投稿、統計の確認ができます：

Studio（テンプレート）	Settings（API キー）
Publish	Library
Trends	Stats
Lyrics mode	Auto pilot

ShortSmash を選ぶ理由

多くのテキスト動画生成ツールは、クリップを無差別に組み合わせます。ストック映像 API が最初に返したものを何でも使います。そのため、自動生成のショート動画には悪名高い「ストック映像っぽさ」があります。料理チュートリアルにハンバーガーが、レシピ動画にオウムが登場するのです。

ShortSmash は、映像を見て判断するオープンソースのパイプラインです。

• 2段階のビジョンゲート。 候補となるすべてのクリップの中間フレームを、ローカルの CLIP モデル（オフライン、使用枠なし、無料）で、ハンバーガー、鳥、観葉植物、空のフライパン、柑橘類など、15種類の紛らわしいカテゴリと照合して確認します。その後、使用枠に余裕があれば Gemini のビジョン機能でも確認します。不適切な映像素材は決して出力されません。
• 音声ゲート。 音声が無音または欠落しているレンダリングは、出力せずに失敗として処理します。
• 無音では出力しません。 CC ライセンスの音楽ライブラリは初回実行時に自動ダウンロードされます。FFmpeg のサイドチェーン機能を使って、ナレーションに合わせて BGM の音量を下げます。

パイプライン

prompt ──▶ script ──▶ voice ──▶ visuals ──▶ captions ──▶ render ──▶ publish
           NVIDIA     Edge-TTS   Pixabay      faster-     FFmpeg      official
           Gemini     Piper      Veo 3.1      whisper     1080x1920   APIs only
           Grok       (offline   Kling        karaoke     +faststart
           OpenAI-    neural)    Agnes
           compat     50 langs   CLIP-verified

• スクリプト — NVIDIA NIM（無料）→ Gemini（無料）→ Grok → OpenAI 互換エンドポイント（OpenRouter、DeepSeek、ローカルの Ollama）→ オフラインテンプレート。思わずスクロールを止めるスクリプトと、pydantic で検証済みの厳密な JSON 編集プランを作成します。二人称で、テンポよく、各シーンは 3～4 秒です。
• 音声 — Edge-TTS → Piper オフラインニューラル → gTTS のフォールバックチェーン。ウルドゥー語、ヒンディー語、アラビア語を含む 50 言語の吹き替えに、各言語のネイティブ音声で対応します。
• 映像 — 無料の Pixabay 映像、または AI 生成：Google Veo 3.1（最高品質、ネイティブ音声）、Kling AI（最高クラスのモーション）、Agnes AI（無料プラン）。ソースにかかわらず、すべてのクリップをビジョンゲートで検証します。自分の映像を使いたい場合は、任意のコマンド（ComfyUI、Replicate、MiniMax など）を指定して visual_provider: custom に設定します。
• 字幕 — faster-whisper の単語タイムスタンプ → 映像に焼き込むカラオケ字幕。
• レンダリング — FFmpeg：9:16 のスマートリフレーム、トランジション、フックと CTA のオーバーレイ、音楽のダッキング、H.264/AAC faststart。
• 公開 — YouTube、TikTok、Instagram、Threads、Bluesky、LinkedIn、Pinterest、X。公式 API のみを使用します。Selenium もスクレイピングも、アカウント停止につながるものも使いません。
• 吹き替え — shortsmash dub <slug> --lang ur で、動画の音声を50 言語で吹き替えできます。ウルドゥー語、ヒンディー語、アラビア語、スペイン語、フランス語、ドイツ語、中国語、ポルトガル語など、ほか 42 言語に対応しています。さらに、ネイティブのニューラル音声に合わせて、ローマ字字幕（「Tum kaise ho?」）を表示する ur-roman / hi-roman も利用できます。ウルドゥー語字幕は、カラオケのハイライトが読み上げ中の単語を追いながら、右から左に正しいナスタアリーク体で表示されます。同じ検証済みクリップに、新しいネイティブ音声のナレーションを加えます。
• 分析 — shortsmash analytics で YouTube API から実際の再生数、いいね数、コメント数を取得します。プラットフォーム上の実数を使い、見栄えだけの指標には頼りません。
• トレンド — shortsmash trends <niche> で Google News と Hacker News からトレンドを収集します（無料、API キー不要）。shortsmash batch では、上位のトレンドを動画に自動変換できます。
• スケジュール — 自然言語（「金曜日の午後 6 時」）、永続性のある SQLite キュー、リトライ機能付きワーカー。
• エンゲージメント — 最近のコメントを取得して、親しみやすい返信案を作成します。返信ごとにタップして承認するのはあなたです。自動で投稿されることはありません。
• MCP サーバー — python -m shortsmash.mcp_server で generate_video、get_trends、list_projects、project_status を Claude Code、Cursor、あらゆる MCP クライアントに公開します。
• 再開 — shortsmash resume <slug> で、失敗したプロジェクトを最初の未完了ステージから再開し、すべてやり直す手間を省きます。

ShortSmash の比較

	ShortSmash	MoneyPrinterTurbo	OpenPost	Postiz	ShortGPT
プロンプトから完成したショート動画を作成	✅	✅	❌（手動エディター）	❌	✅
自分の動画を投稿（検証＋スケジュール設定）	✅	❌	✅	✅	❌
映像の検証	✅ CLIP + Gemini	❌	n/a	n/a	❌
オフラインのニューラル音声フォールバック	✅ Piper	❌	n/a	n/a	❌
オーディオ安全ゲート	✅	❌	n/a	n/a	❌
トレンド収集（無料、API キー不要）	✅	✅	❌	❌	❌
バッチ制作	✅	✅	❌	❌	❌
単語単位のカラオケ字幕	✅	✅	✅	❌	✅
公式の公開 API	✅ 10 プラットフォーム	⚠️ YT には Selenium を使用	✅	✅	⚠️
多言語吹き替え	✅ 50 言語（ローマ字表記のウルドゥー語／ヒンディー語、中国語を含む）	❌	❌	❌	✅
実データの分析取得	✅	❌	❌	✅	❌
Web UI	✅ Studio	✅	✅	✅	✅
MCP サーバー	✅	❌	✅	✅	❌
コメント返信案（人間が承認）	✅	❌	❌	❌	❌
失敗したプロジェクトの再開	✅	❌	n/a	n/a	❌
ライセンス	MIT	MIT	AGPL/Commercial	MIT	MIT
$0 で実行可能	✅	✅	セルフホスト	✅	✅

MoneyPrinterTurbo（129K★）は最も成熟したプロジェクトです。OpenPost は手動作業に最適なワークスペースです。ShortSmash は、AI ネイティブのパイプラインとして最も緻密に設計されており、自らの作業を検証する唯一のツールです。

ShortSmash が決してしないこと

偽のいいね、コメント、フォロー、シェア、スターは行いません。ボット行為、プラットフォームの検出を回避するための「人間らしい」偽装、スクレイピング、非公式エンドポイントの使用も行いません。これらはすべてのプラットフォームの規約に違反し、アカウント停止につながります。そもそも実際の成長にも役立ちません。この境界は単なるポリシー上の注意書きではなく、アーキテクチャに組み込まれています。その機能はコードベースに存在しません。

クイックスタート — 1 つのコマンドで完了

Windows（PowerShell） — この 1 行を貼り付ければ完了です。Python、 FFmpeg、Git がインストールされていない場合はインストールし、すべてをセットアップして、ShortSmash Studio をデスクトップとスタートメニューに追加します：

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/hydope/shortsmash/master/install.ps1")))

Windows（CMD） — 同じ内容を、コマンドプロンプトで 1 行実行します：

curl -L -o "%TEMP%\rf-install.cmd" "https://raw.githubusercontent.com/hydope/shortsmash/master/install.cmd" && "%TEMP%\rf-install.cmd"

Linux / macOS / Git Bash（Windows） — どこでも使える 1 行のコマンドです。Windows の Git Bash でも動作します：

curl -fsSL "https://raw.githubusercontent.com/hydope/shortsmash/master/install.sh" | bash

インストール後、スタートメニュー／デスクトップ（Windows）から ShortSmash Studio を起動するか、shortsmash serve を実行して http://127.0.0.1:8000 を開きます。

手動でインストールしますか？ リポジトリをダウンロードし、install.bat をダブルクリックする（Windows）か、./install.sh（Linux/macOS）を実行してください。

コードだけを取得するためにクローンしますか？ リポジトリ全体はデモ動画で約 213 MB あります。スパースチェックアウトで動画を除外できます：

git clone --depth 1 --filter=blob:none --sparse https://github.com/hydope/shortsmash.git
git -C shortsmash sparse-checkout set shortsmash scripts fonts

以前のインストールが途中で失敗した場合は、ShortSmash フォルダーを削除して 1 行のコマンドを再実行してください。

Python 3.11～3.13 と ffmpeg が必要です。Windows 用の 1 行インストーラーは、どちらもインストールされていない場合に取得します。また、すでに Python 3.14 がインストールされているマシンでは、Python 3.14 ではまだ正常に動作する仮想環境を構築できないため、3.13（PowerShell）または 3.12（CMD）を並行してインストールし、そちらを使用します。インストールで取得するのはコードのみです（約 2 MB、デモ動画なし）。

🎬 Studio タブで動画を作成し、🚀 Publish タブをクリックすると、ワンクリックで 10 のプラットフォーム（YouTube、TikTok、Instagram、X、Threads、Bluesky、LinkedIn、 Pinterest、Facebook、Facebook Page）に投稿できます。プラットフォームごとのセットアップ状況と、安全なドライラン機能も備えています。

必要に応じて、手動で段階的にインストールする方法：

pip install 'shortsmash[ai,voice,captions,trends,vision,mcp,youtube,x,schedule]'
shortsmash init          # guided setup: keys, voice, defaults
shortsmash doctor        # verify every dependency

# Your first video (needs a free Pixabay key + any LLM key)
shortsmash new "coffee" --duration 30

# Ride the trends
shortsmash trends ai --limit 5
shortsmash batch ai --count 3

# Hands-free
shortsmash agent "make a 30s reel about the top AI trend and post it Friday at 6pm"

無料のキー：Pixabay（映像素材） · Google AI Studio（Gemini LLM） · NVIDIA NIM（LLM）。または openai_base_url をローカルの Ollama に指定すれば、費用は一切かかりません。

ドキュメント

プラットフォームごとの投稿設定（公式 API）：

• docs/setup-youtube.md、setup-tiktok.md、setup-instagram.md、setup-x.md
• docs/setup-threads.md、setup-bluesky.md、setup-linkedin.md、setup-pinterest.md、setup-facebook.md、setup-facebook_page.md
• docs/trends.md — トレンドの情報源とスコアリング
• docs/mcp.md — Claude Code / Cursor 用の MCP サーバーのセットアップ
• docs/visual-providers.md — AI ビジュアル生成機能の接続

ライセンス

MIT — 好きなものを何でも構築できます。