Communitygithub.com

アップロード事前チェック

ユーザーが縦型動画をレンダリングまたはエクスポートした際に、TikTok、YouTube Shorts、Instagram Reels、Facebook Reelsがその動画を受け入れるかどうか、またはアップロードやスケジュール投稿が失敗した理由を確認します。ffprobeを使用した公開済みチェッカーを実行し、失敗ごとにFFmpegの修正コマンドを提示します。

アップロード事前チェック とは?

このスキルは、レンダリングされた動画が一見問題なく見えても、各プラットフォームのAPIや公開ルールによって拒否される可能性がある場合に、事前に問題を検出して修正するためのツールです。`shortform-preflight`というNode.jsベースのチェッカーをnpx経由で実行し、ffprobeで動画ファイルを読み取り、TikTok、YouTube Shorts、Instagram Reels、Facebook Reelsの各アプリが公開している仕様(フレームレート、コーデック、ファイルサイズ、長さなど)と照合します。チェックが失敗したすべての項目に対して、1つのFFmpegコマンドに変換して修正方法を提示します。また、各アプリのアップロードルート(アプリ内アップロード、Webアップロード、公開API)に応じてルールを切り替えることができ、スケジューラー経由や独自コードでの投稿にも対応します。JSON出力を読み取り、どのアプリがどの理由で失敗したかをテーブル形式で表示し、修正後は再度チェックを実行して問題が解決したことを確認します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/viewgum/skills/tree/HEAD/skills/upload-preflight

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アップロード事前チェック は何をしますか?

問題なく見えるレンダリングでも、APIが許容しないフレームレート、投稿ツールが拒否するオーディオコーデック、サイズ制限を超えたファイル、アプリが許容する長さを超えたクリップなど、拒否されたり再処理されたりすることがあります。このスキルは、GitHub上の https://github.com/viewgum/shortform-preflight をファイルに対して実行します。これは ffprobe でファイルを読み取り、各アプリが公開している数値と照合し、すべての失敗を1つのFFmpegコマンドに変換します。

対象外: フレーム内のテキストの位置(short-form-specsを使用)や、動画の内容。

ワークフロー

  1. 必要に応じてスコープを明確にします。デフォルト: 4つすべてのアプリ、および各アプリでのアップロードルール(--route app)。TikTokのWebアップロードには --route web を使用します。ユーザーがスケジューラーや独自コードで投稿する場合は、公開APIルール(--api)を使用します。これはFacebook ReelsとInstagramでより厳しくなります。TikTokのDirect Postの場合は、アカウントの制限(TikTokのクリエイター情報からの max_video_post_duration_sec)を --tiktok-endpoint direct --tiktok-max-seconds <n> として渡します。これがない場合は、長さが未確認であることを伝えます。
  2. ツールを確認します: ffprobe -version(FFmpeg)、node -v(18以降)、npx --version。初回実行時はGitHubからチェッカーをダウンロードするため、ネットワークアクセスも必要です。不足しているものがあれば、どれかを伝え、インストール方法を説明し、中断します。
  3. 各行を読み取れるようにJSON形式で実行します: npx -y github:viewgum/shortform-preflight <file> --json(必要に応じて --api または --platform tiktok,youtube-shorts を追加)。 終了コード0はチェック失敗なし、1はチェック失敗または必要な数値が読み取れなかった(アプリが不完全と表示されます。どの測定値が不足しているかを伝えます)、2は不正な入力です。
  4. 各失敗について、およびユーザーが遭遇しそうな各警告について、原因を1行で、行が引用するソース、および1つの修正方法を示します。一般的な修正方法(パスを調整し、ファイルの残りの部分はそのままにします):
    • フレームレートが範囲外: ffmpeg -i in.mp4 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy -movflags +faststart -use_editlist 0 out.mp4
    • コーデック、クロマ、またはプロファイルが拒否された: ffmpeg -i in.mp4 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4
    • Moovアトムが末尾にある、または編集リストがある(InstagramのAPIは両方を拒否): ffmpeg -i in.mp4 -c copy -movflags +faststart -use_editlist 0 out.mp4
    • オーディオのサンプルレート、チャンネル数、またはビットレート(Facebook Reels APIは48 kHzステレオ、128 kbps以上をリストしています。エンコーダーが正確に128kに設定されている場合、平均が少し下回ることがよくあります): ffmpeg -i in.mp4 -c:v copy -c:a aac -b:a 192k -ar 48000 -ac 2 -movflags +faststart -use_editlist 0 out.mp4
    • 長すぎる: カットします。ffmpeg -i in.mp4 -t 89.9 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4(-t は制限より少し短めに設定します。カットは1フレーム長くなることがあります)。
    • 複数の行が同時に発生する: パスを連鎖させるのではなく、例のように1回の再エンコードでオプションを組み合わせます。
    • すべての再エンコードで: 30 fpsの場合は -g 90(24の場合は -g 72)を追加して、キーフレームが3秒ごとに来るようにします。FacebookのAPIは2~5秒のクローズドGOPを要求しますが、チェッカーではテストできません。ffprobe -v error -select_streams v -skip_frame nokey -show_entries frame=pts_time -of csv=p=0 out.mp4 で確認します。
    • 大きすぎる: 解像度ではなく、品質設定(より高い -crf)を下げます。
    • 9:16ではない: ユーザーが望む場合にのみ、1080 x 1920にパディングまたはクロップします。失われるものを伝えます。
  5. 修正後、新しいファイルで再度チェッカーを実行し、その行が合格することを示します。

出力形式

**ファイル:** demo.mp4 · 1080 x 1920 · 95 s · 23.976 fps · H.264 · AAC
**ルール:** 公開API

| アプリ | 結果 | 失敗または警告の行 |
|---|---|---|
| Facebook Reels | 失敗 | 長さ95秒(APIは3~90秒まで); フレームレート23.976(24~60が必要); 44.1 kHzモノラル(48 kHzステレオがリストされている、警告) |
| Instagram Reels | 失敗 | 編集リストあり(許可なし); Moovアトムがメディアの後(先頭にある必要あり) |

### 修正
すべての行のための1回の再エンコード: `ffmpeg -i demo.mp4 -t 89.9 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -ar 48000 -ac 2 -g 90 -movflags +faststart -use_editlist 0 fixed.mp4`
(ソース: Meta for Developers、Reels Publishing API、IG User Media)

**修正後:** 失敗なし。
  • チェッカー自身の行を引用します。制限を記憶から言い直さないでください。
  • 使用されたルール(アプリアップロード、Webアップロード、公開API)を伝えます。
  • 情報行(推奨ビットレート、測定ラウドネスなど)は失敗ではありません。ユーザーが尋ねた場合のみ言及します。

よくある落とし穴

  • リマックスで修正できる場合は再エンコードしないでください。-c copy と +faststart で品質を保持します。
  • ユーザーが尋ねない限り、解像度やアスペクト比を変更しないでください。まず尋ねます。クロッピングは画像を失うためです。
  • 警告を拒否として扱わないでください。アプリが何をするか(再処理、API経由での拒否)は、ソースが述べているとおりにのみ伝えます。
  • 元のファイルに対してFFmpegを実行しないでください。常に新しいファイルを作成します。
  • チェッカーが非公開として報告する制限を推測しないでください。アプリが公開していないことを伝えます。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル