FrameOS

AI エージェント向け FrameOS

いつも使っている AI エージェントに頼むだけで、長い動画を短いクリップにできます。ポッドキャスト、配信、インタビュー、ウェビナーのリンクを Claude、ChatGPT、Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Perplexity に貼り付けると、FrameOS が見どころを探し、用途に合わせて画角を調整し、字幕を追加して、ランキング形式のクリップ一覧を返します。どれをエクスポート、字幕付け、サムネイル作成、投稿するかは、あなたが決められます。

このリポジトリには FrameOS のプラグイン、スキル、拡張パッケージが含まれています。これらはエージェントをホスト型の FrameOS コネクター（https://frameos.studio/mcp にある MCP サーバー）に接続し、FrameOS をうまく使えるようにします。クレジットを確認するタイミング、レンダリングを待つ時間、使用できる字幕スタイル、あなたの許可なしに投稿しないことなどを学習します。

ステータス、2026-10-26：ホスト型コネクターは稼働中で、記載されているアプリのうち Devin 以外はすべてサインインできます。 https://frameos.studio/mcp は稼働しています。Claude Code、Claude（ウェブ、デスクトップ、モバイル）、ChatGPT、Codex、Cursor、GitHub Copilot を搭載した VS Code では、実際のアカウントを使ったエンドツーエンドのテストが完了しています。Gemini CLI、Perplexity、Copilot CLI はサインインできますが、エンドツーエンドのテストはまだ完了していません（ベータ版）。Devin（Windsurf を含む）は近日対応予定です。現時点ではサインインできません。残っている作業はdocs/status.mdをご覧ください。また、クレジットを使わずにモックサーバーでワークフロー全体を試すこともできます。

エージェントへの頼み方

コマンドを覚える必要はありません。編集者に依頼するようにエージェントに話しかけてください。

• 「このエピソードから TikTok 向けの縦型ショート動画を 5 本作ってください：https://youtube.com/watch?v=...」
• 「このインタビューから LinkedIn 向けの正方形クリップを 3 本作ってください。料金について話している部分を中心にしてください。」
• 「昨日の配信からクリップを、良いものから順に見せてください。」
• 「クリップ 2 の字幕を大きくして、少し上に移動し、Beasty スタイルを使ってください。それから MP4 をください。」
• 「先週のポッドキャストで採用について話しているのはどこですか？タイムスタンプ付きの引用をください。」
• 「一番良いクリップ用に YouTube のサムネイルを 2 枚作ってください。」
• 「このクリップ用の Instagram キャプションを書いてください。」気に入ったら、「Instagram に投稿してください。」
• 「このウェビナーから 1 週間分のコンテンツを作ってください。YouTube と LinkedIn 向けに、クリップ 5 本、キャプション、サムネイル、投稿文をお願いします。」
• 「FrameOS のクレジットはあといくつありますか？今月は何に使いましたか？」

用途別にまとめた、すぐ使えるプロンプトはdocs/workflows.mdにあります。

クリップを依頼するとどうなるか

1. エージェントがサインイン済みで、クレジットがあることを確認します。
2. エージェントがリンクを FrameOS に送信します（エージェントからコマンドを実行できる場合はファイルをアップロードします）。その際、クリップの本数、形式、注目する内容などの設定も送ります。
3. レンダリングには通常 10〜30 分かかります。エージェントが所要時間の目安を伝え、自動的に状況を確認します。待機できないチャットアプリでは、後で「FrameOS のレンダリングを確認して」と頼むよう案内します。
4. タイトルまたはフック、長さ、スコア、元動画内の位置、プレビューリンクを含むランキング形式の一覧が届きます。
5. 次に何をするかはあなたが選べます。字幕のスタイル変更、MP4 のエクスポート、サムネイルの作成、投稿文の下書き、コレクションへの追加、投稿などができます。

クレジットの仕組み

• FrameOS のすべてのプランで利用できます。必要なのはクレジットだけです。
• レンダリング料金は元動画の開始 1 分ごとに 1 クレジットです。クリップが納品されたときにのみ請求されます。
• サムネイルは 1 枚につき 10 クレジットです。
• エクスポート、字幕の変更、投稿文の下書き、コレクション、投稿は無料です。
• 残高が動画全体の料金をまかなえる場合にのみレンダリングが始まるため、料金の一部だけを支払った状態でレンダリングが止まることはありません。
• ワークスペースで同時に処理できる動画は最大 3 本です。残りはエージェントがキューに追加し、レンダリングの完了に合わせて送信します。
• この 2 つのルールはサーバー側で適用され（2026-10-06 から稼働中）、スキルにも反映されています。
• いつでもエージェントに「FrameOS のクレジット残高はいくらですか？」と尋ねられます。プランと料金は https://frameos.studio/pricing に掲載されています。エージェントが料金を案内することはありません。

インストール

使用するアプリを選んでください。各ガイドには、具体的な手順、インストールを確認する方法、再度サインインする方法、既知の制限事項が記載されています。Claude Code、Claude（web、Desktop、mobile）、ChatGPT、Codex、Cursor、VS Codeでは、最初から最後までの動作確認を実施済みです。Gemini CLIとPerplexity（2026-10-08以降）、Copilot CLI（2026-10-23以降）はサインインできますが、最初から最後までの動作確認はまだ実施していません。Devinは近日対応予定です（ステータス）。

AI を使う場所	最短の方法	詳細ガイド
Claude Code	claude mcp add --transport http -s user frameos https://frameos.studio/mcp を実行し、続けて claude mcp login frameos を実行します（動作確認済み）。または、スキルを使う場合は、claude plugin marketplace add theSatvik/frameos-plugins を実行し、続けて claude plugin install frameos@frameos を実行します（プラグイン独自の接続を通じたサインインはまだ動作確認していません）	docs/install/claude-code.md
Claude.ai、Claude Desktop、Cowork	https://frameos.studio/mcp を指定してカスタムコネクターを追加します（動作確認済み）。または、スキルを使う場合は、Customize > Plugins > Add > Add marketplace を選び、theSatvik/frameos-plugins を入力します（まだ動作確認していません）	docs/install/claude-ai.md
Codex	codex plugin marketplace add theSatvik/frameos-plugins を実行し、続けて codex plugin add frameos@frameos を実行します	docs/install/codex.md
ChatGPT	開発者モードを有効にし、ChatGPT Pluginsで https://frameos.studio/mcp を追加します	docs/install/chatgpt.md
Cursor	ワンクリックのインストールリンク（動作確認済み）を使うか、プラグインをローカルプラグインとして追加します	docs/install/cursor.md
Gemini CLI	gemini extensions install https://github.com/theSatvik/frameos-plugins を実行します	docs/install/gemini-cli.md
VS CodeとGitHub Copilot	VS Code：https://frameos.studio/mcp を mcp.json に追加します（動作確認済み）。または Chat: Install Plugin From Source を選びます。Copilot CLI（1.0.83以降）：copilot mcp add --transport http frameos https://frameos.studio/mcp を実行し、続けて /mcp auth frameos を実行します（最初から最後までの動作確認はまだ実施していません）	docs/install/vscode-copilot.md
Perplexity	https://frameos.studio/mcp を指定して Account settings > Connectors > + Custom connector > Remote を選びます	docs/install/perplexity.md
DevinとWindsurf（現在のDevin Desktop）	近日対応予定です。DevinはまだFrameOSにサインインできません。対応時期を知りたい場合は、[email protected] にメールしてください	docs/install/devin-windsurf.md
その他のエージェント	npx skills add theSatvik/frameos-plugins とコネクターのURL https://frameos.studio/mcp を使います	docs/install/other-agents.md

動作を確認します。 新しい会話で「FrameOSのクレジット残高はいくらですか？」と尋ねてください。ワークスペース名とクレジット数が表示されます。「接続済み」バッジが表示されるだけでは確認になりません。実際に回答が得られることが確認の条件です。

エージェントにインストールを任せます。 コマンドを実行できるエージェント（Claude Code、Codex、Gemini CLIなど）は、FrameOSをインストールできます。次の内容を貼り付けてください。

Install FrameOS by following https://github.com/theSatvik/frameos-plugins/blob/main/docs/install-protocol.md

できること、できないこと

エージェントでできること：

• リンク（YouTube、Vimeo、Twitch、Kick、一般公開されている Google Drive ファイル、または動画ファイルへの直接 URL）や、エージェントがコマンドを実行できる場合はお使いのコンピューター上のファイルから動画をクリップできます。素材の長さは 30 秒以上である必要があります。
• 動画 1 本につき最大 20 個のクリップを作成できます（デフォルトは 3 個）。この数は上限のため、作成されるクリップはそれより少なくなる場合があります。
• クリップのアスペクト比は、9:16（Shorts、Reels、TikTok）、4:5 または 3:4（フィード）、1:1（正方形）、16:9（横向き）に設定できます。
• トピックに沿ったクリップ作成を指定できます。フォーカスは言葉に基づいて照合されるため、話者が実際に口にする語句（「価格設定」、「採用」など）を使ってください。これは優先事項であり、フィルターではありません。
• 22 種類の字幕スタイル（または字幕なし）、16 種類のフォント、サイズ、位置、17 種類のアニメーションで字幕の見た目を変更し、字幕付きの MP4 を書き出せます。ダウンロードリンクの有効期間は約 1 時間で、必要に応じてエージェントが新しいリンクを取得します。
• コネクターの起動後に処理された動画の全文トランスクリプトを検索し（古いプロジェクトでは、クリップごとのトランスクリプトしかない場合があります）、タイムスタンプ付きで引用を取り出せます。
• リクエストごとに、動画の実際のフレームを使って最大 3 枚のサムネイルをテキストレイアウト付きで作成できます（AI 生成画像ではありません）。
• YouTube、Instagram、Facebook、LinkedIn、TikTok、X 向けに、タイトル、キャプション、ハッシュタグの案を作成できます。
• FrameOS で連携した YouTube（Shorts）、Facebook ページ、Instagram ビジネスアカウント（Reels）、または LinkedIn の個人プロフィールに投稿できます。投稿するたびに、確認してから投稿します。
• クリップをコレクションに整理したり、クリップを複製して試したり、過去 30 日間のクレジット使用量を確認したりできます。

エージェントでは利用できない機能（https://frameos.studio/dashboard の FrameOS ウェブアプリをお使いください。ウェブアプリでもまだ利用できない機能があります）：

• 投稿の予約、共有リンクの作成、検閲やビープ音の追加、吹き替え、自由形式のタイムライン編集。
• クリップの長さの指定、またはクリップを作成せずに動画全体をレンダリングすること。
• 開始済みのレンダリングのキャンセル。
• TikTok または X への投稿（投稿文の作成はエージェントで可能です）。
• ソーシャルアカウントの連携やブランドロゴのアップロード（どちらもウェブアプリで一度だけ行います）。
• コレクションの名前変更や削除、またはコレクションからのクリップの削除。

無料プランで作成したクリップには FrameOS の透かしが入ります。

このプラグインが送信するもの

• 送信するのは 2 つのアドレスだけです。 インストールすると、このプラグインはアプリの接続先として FrameOS コネクター https://frameos.studio/mcp を設定します。また、アカウント連携時に一度だけ表示される FrameOS のサインイン先 https://clerk.frameos.studio も設定します。コネクターから返されるアップロードリンクとダウンロードリンク（エージェントにアップロードを依頼したファイルや、完成した MP4 用）は FrameOS 独自のファイルストレージを参照し、有効期限があります。
• 独自のコードはありません。 このプラグインは、スキル、Gemini CLI コマンド、接続設定からなる指示ファイルであり、フックも、インストール時や使用時に実行されるものもありません。すべてのリクエストは AI アプリが行います。リポジトリの dev/、scripts/、tests/、evals/ フォルダーはメンテナーツールです（起動したときだけ動作し、お使いのコンピューターの外部には何も呼び出さないローカルのモックサーバーと、各種チェックおよびテストが含まれます）。プラグインがこれらを実行することはありません。コマンドを実行できるアプリでは、FrameOS の設定を依頼したときに、スキルによってエージェントがお使いのアプリのインストール手順を実行する場合や、指定した動画ファイルの確認とアップロード、レンダリング状況を確認するまでの待機、依頼した MP4 の保存を行う場合があります。
• トラッキングはありません。 アナリティクスやテレメトリーはありません。プラグインが追加で送信する情報はバージョン番号のみで、対応するアプリでは X-FrameOS-Plugin-Version ヘッダーとして送信されます。
• お客様の許可なく公開されることはありません。 スキルは、投稿を公開する前に、投稿のたびに確認を求めます。

FrameOS による動画およびアカウントの取り扱いについては、プライバシーポリシーと利用規約をご覧ください。お問い合わせ先：[email protected]。

クレジット不要で試す（モックサーバー）

このリポジトリには、本番サーバーと同じ27個のツールと入力項目を備え、エラーも同じ形式で返す、ローカルのモック FrameOS サーバーが含まれています。アカウントもサインインもクレジットも不要なので、本物のアカウントに触れることなく、送信、ポーリング、クリップ、字幕、エクスポート、サムネイル、コピー、偽の投稿まで、一連の流れをすべて確認できます。

git clone https://github.com/theSatvik/frameos-plugins
cd frameos-plugins
uv run --script dev/mock_server.py                        # stdio
uv run --script dev/mock_server.py --http --port 8790     # Streamable HTTP at http://127.0.0.1:8790/mcp
claude --plugin-dir . --mcp-config dev/mock.mcp.json --strict-mcp-config   # Claude Code: these skills + the mock only

モックのリンク先は mock.frameos.invalid なので、実際に何かが作成されることはありません。各エラーを発生させる入力と、詳しい手順については dev/README.md をご覧ください。

このリポジトリのパッケージ

リポジトリのルートがプラグインです。すべてのホストで同じスキルセットを使用し、各ホストはそれぞれのマニフェストを読み込みます。

ファイルまたはフォルダー	内容	読み込み先
skills/	8つのスキル：frameos-setup、frameos-clip、frameos-captions、frameos-find-moments、frameos-thumbnails、frameos-publish、frameos-library、frameos-repurpose。それぞれに references/ と agents/openai.yaml があります。	すべてのホスト、npx skills、スキルの ZIP アップロード
.claude-plugin/	Claude プラグインのマニフェストとマーケットプレイス	Claude Code、claude.ai、Claude Desktop、Cowork。Devin はフォールバックとして使用
.mcp.json	Claude Code 形式の FrameOS 接続設定	Claude Code。Claude 形式のプラグインをインストールする場合は Devin と VS Code
.codex-plugin/、.agents/plugins/marketplace.json	Codex プラグインのマニフェスト、独自の接続ファイル（.codex-plugin/mcp.json）、マーケットプレイス	Codex CLI とアプリ、ChatGPT プラグインディレクトリへの提出
.cursor-plugin/plugin.json	接続設定を含む Cursor プラグイン	Cursor
gemini-extension.json、GEMINI.md、commands/frameos/	Gemini CLI 拡張機能、常時適用されるコンテキスト、/frameos:* コマンド	Gemini CLI
agent-plugin/	Agent Plugins 1.0 パッケージ（その中の skills/ は同期されたコピーです）	VS Code と GitHub Copilot（IDE、CLI、アプリ）、Devin、Cursor
.github/plugin/marketplace.json	agent-plugin/ を参照する Copilot マーケットプレイス	Copilot CLI、VS Code
assets/icon.png	1024 px のアイコン	Codex、Cursor、ディレクトリ
server.json	Official MCP Registry に掲載するコネクターの情報（プラグインの一部ではありません）	MCP Registry と、その内容をコピーするディレクトリ
docs/submission/openai-package.json	OpenAI アップロード用 ZIP に含める掲載文と審査の詳細	ChatGPT および Codex Plugin Directory への提出
dev/	デモとテスト用のモック FrameOS サーバー	ユーザー、メンテナー
docs/	インストールガイド、プロンプトライブラリ、ステータス、提出チェックリスト	全員
scripts/、tests/、evals/	バリデーター、同期、バージョン更新、ZIP ビルダー、テスト、Claude プラグインの評価	メンテナー

claude.ai と Perplexity へのアップロード用スキル ZIP、Upload plugin 用プラグイン ZIP、OpenAI Plugin Directory 用 ZIP は、python3 scripts/build_dist.py を使って dist/ に作成します。

リンク

• FrameOS：https://frameos.studio - ウェブアプリ：https://frameos.studio/dashboard - 料金：https://frameos.studio/pricing
• ヘルプ：https://frameos.studio/contact または [email protected]
• プライバシー：https://frameos.studio/privacy - 利用規約：https://frameos.studio/terms
• ステータス - プロンプトライブラリ - エージェントのインストールプロトコル - 変更履歴
• コントリビューション - リリース - セキュリティ - ライセンス（MIT）