broll

broll

コーディングエージェント向けコンテンツスタジオ MCP です。 broll を使うと、Claude Code、Codex、あらゆる MCP クライアントがコンテンツ制作で実際に作業できるようになります。自分の API キーでメディアを生成し、コードで動画やカルーセルを決定論的にレンダリングして、下書き優先の送信ボックスから公開できます。

計画を立てるのはモデルです。レンダリングするのはコードです。確認なしに投稿されることはありません。

理由

コーディングエージェントを使う開発者は、誰もが同じ壁にぶつかります。エージェントはマーケティング計画を書けても、カルーセルを作ったり、動画を編集したり、投稿したりはできません。既存のツールは、クレジット制の料金体系を採用した、ソーシャルメディア担当者向けのスケジューラーです。broll は開発者向けに作られています。

• 自分のキーを使用し、上乗せ料金はありません。 画像・動画の生成には、直接 OPENAI_API_KEY ／ GEMINI_API_KEY を使用します。broll が推論を中継したり、クレジットを転売したりすることはありません。組み込みのモックプロバイダーにより、キーを追加する前でもすべてのワークフローを実行できます。
• 決定論的なレンダリング。 動画やスライドは、宣言的なプランから正確な ffmpeg／sharp の呼び出しにコンパイルされます。同じプランと同じ入力なら、同じ出力が得られます。AI の出力にばらつきがある場合、解決策はコードです。そのため、レイアウト、フォント、キャプション、ブランド設定はコードで管理します。
• 下書き優先の公開。 投稿は送信ボックス内の確認可能な JSON ファイルです。publish_post では confirm: true が必要です。何かがマシンの外に送信される前に、プラットフォームごとのルール（文字数制限、メディア数、ファイルサイズ）を検証し、プラットフォームごとの結果を報告します。export プラットフォームは常に利用でき、すぐに投稿できるバンドルを書き出します。

インストール

Node 20 以降と ffmpeg が必要です（brew install ffmpeg）。

cd broll
npm install && npm run build

Claude Code に登録します（または、このリポジトリ内で作業する場合は、同梱の .mcp.json を使用してください）。

claude mcp add broll -- node /path/to/broll/dist/index.js

任意の環境変数：

変数	用途
OPENAI_API_KEY	gpt-image-1 による画像生成
GEMINI_API_KEY	Imagen による画像生成と Veo による動画生成
BLUESKY_IDENTIFIER / BLUESKY_APP_PASSWORD	Bluesky への実際の投稿（アプリパスワードを使用）
MASTODON_ACCESS_TOKEN（任意で MASTODON_INSTANCE も指定）	Mastodon への実際の投稿 — アプリ審査不要、任意のインスタンスに対応
X_API_KEY / X_API_SECRET / X_ACCESS_TOKEN / X_ACCESS_TOKEN_SECRET	X への実際の投稿（無料 API ティアで利用可能）
BROLL_HOME	ワークスペースの場所（デフォルトは ~/.broll）
BROLL_FFMPEG / BROLL_FFPROBE	バイナリのパスを明示的に指定

ブランドキット：サーバーの実行場所と同じディレクトリに broll.config.json を配置します（例については、このリポジトリのファイルを参照してください）。名前、ハンドル、色、フォント、ロゴを設定します。レンダリングのたびに自動で適用されます。

ツール

ツール	機能
broll_status	ワークスペース、ffmpeg、プロバイダーとプラットフォームの準備状況を確認します。最初に呼び出してください。
generate_image / generate_video	自分のキーで生成し、ワークスペースのアセットに保存します（キーがない場合はモックにフォールバック）
import_asset / list_assets / probe_asset	メディアを取り込み、内容を確認します
render_video	宣言的な RenderPlan から mp4 を生成します。クリップ（動画／画像／色）、トリミング、cover／contain フィット、焼き込みタイトルとタイミング指定付きキャプション、音楽、9:16／1:1／4:5／16:9 に対応
render_carousel	ブランド設定を適用したスライドセット（Instagram／LinkedIn 形式）を作成します。キッカー、見出し、本文、アクセントバー、ページ番号、透かしに対応し、レイアウトはすべてコードで制御します
extract_frame	PNG フレームを抽出し、エージェントが自身のレンダリングを視覚的に QA できるようにします
create_post_draft	テキスト、メディア、プラットフォームから、検証済みで確認可能な下書きを送信ボックスに作成します
list_drafts / publish_post	送信ボックスを確認し、明示的に confirm: true を指定して公開します

試してみる

npm run smoke

実際の MCP クライアントを介して実際のサーバーを動作させます。背景を生成し、3 枚のスライドからなるカルーセルと、キャプション付きの 9:16 ティーザー動画をレンダリングして、QA フレームを抽出した後、下書きを作成し、エクスポートバンドルを「公開」します。すべて ./.broll/ に出力されます。

broll cloud（ウェイトリスト）

ご覧のローカルサーバーは、引き続きMITライセンスで無料です。broll cloud では、ローカルサーバーでは対応が難しい機能を追加します。broll 独自の承認済み認証情報を使ったアプリ審査の壁があるプラットフォーム（Instagram、LinkedIn、TikTok）への投稿、ノートパソコンを閉じている間も実行される予約投稿、スマートフォンでスワイプして承認できる受信トレイです。リリース時の価格は月額約29ドルです。

ウェイトリストに登録 → 👍 issue #1 — 登録者にはリリースのお知らせをお送りします。コメントでプラットフォームの開発順を決定します。

安全モデル

1. まずディスク上に下書きファイルを作成しない限り、何も公開されません。
2. publish_post には confirm: true が必須です。エージェントには、ユーザーから明示的な許可を得るよう指示されています。
3. 制約違反がある場合、公開はブロックされます。テキストが自動的に切り詰められることはありません。
4. キーは環境から読み込まれ、それぞれのベンダーのAPIにのみ送信されます。

ステータスとロードマップ

開発初期ながら、実用可能な状態です。実際のFFmpegによる統合レンダリングと、MCPの一連の往復処理を含む96件のテストがあります。

• Blueskyの動画アップロード
• Xの分割動画アップロード
• LinkedInアダプター（アプリ審査が必要）
• Mastodonアダプター
• ユーザーのOAuth経由でYouTube Shortsに対応
• ケン・バーンズ／クロスフェードのトランジション
• トランスクリプトから単語単位の字幕タイミングを設定
• npx broll-mcp による配布

開発

npm test          # unit + integration (real ffmpeg)
npm run typecheck
npm run smoke     # end-to-end artifact check

MIT。