Communitygithub.com

playthegameoflife/tiktok-screen-recorder

短い動画の実際の画面録画を行い、フレーム精度で検証します。CAPTURE, RECORD, 画面録画の要求、またはキュー・ファイルからのバッチ処理に使用します。ヘッドレスLinuxボックス上でダウンロードから検証済み出力までの全パイプラインを処理します。

tiktok-screen-recorder とは?

このスキルは、TikTokのショート動画URLの画面録画を、エミュレーションやシミュレーションではなく、実際の画面出力(ピクセル単位の正確さ)で実行し、結果をフレーム精度で検証するための完全な自動化パイプラインを提供します。例えば、Claude CodeやCursorなどのAIエージェントが、ユーザーから「このTikTok動画を録画して」と指示された際に、このスキルを呼び出して信頼性の高い画面録画を実行できます。パイプラインは、`pipeline.sh` という単一のシェルスクリプトで駆動し、内部で `ffmpeg`、`mpv`、`Xvfb`(仮想フレームバッファ)、`PulseAudio` などのツールを適切に連携させ、ダウンロードからトランスコード、画面キャプチャ、トリミング、そして `verify.py` によるフレーム精度検証までを自動実行します。このパイプラインの最大の特徴は、録画が成功的に行われたかを人間の判断やファイルサイズ・再生時間に頼らず、`pipeline.sh` の終了コードと `verify.py` による先頭フレームと最終フレームの比較(MAE: Mean Absolute Error)によって厳密に判定する点です。これにより、録画の最後の1秒が欠落するような「見かけ上成功しているが検証に失敗する」ケースを確実に検出します。また、バッチ処理にも対応しており、キュー・ファイルから複数のURLを逐次処理できます。各ジョブは独自のPIDに基づいた表示番号とPulseAudioインスタンスを使用するため、複数の並行実行も衝突しません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/playthegameoflife/tiktok-screen-recorder/tree/HEAD/hermes/skills/tiktok-capture

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

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

ドキュメント

TikTokキャプチャパイプライン

pipeline.sh を実行してください。ffmpeg、mpv、Xvfb のコマンドを自分で再導出したり、録画が成功したかどうかを目視や再生時間で判断しようとしないでください。

唯一のルール

キャプチャが成功したと絶対に報告しないでください。成功を判断するのは pipeline.sh の終了コードだけです。

これは重要です。なぜなら、最後の1秒が無音で失われる録画でも、再生時間とフレーム数は正確に一致するからです。それを検出できるのは verify.py による先頭フレームと最終フレームの比較だけです。再生時間やファイルサイズをチェックして「問題なし」と判断したくなる誘惑に駆られたなら、まさにこのパイプラインが防止しようとしている失敗が起きています。

単一ジョブの実行

OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"

ソースがセッションを必要とする場合、クッキーを使用:

OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"

バッチ処理

キュー・ファイルから1行に1つのURLを読み取り、ループで処理します。CPUリソースを確認していない限り、逐次実行してください。各ジョブは30fpsを維持しフレーム落ちを防ぐために約2 vCPUを必要とし、各ジョブは自身のPIDに基づいた表示番号とPulseAudioインスタンスを使用するため、並行実行しても衝突しません。

while read -r url; do
    [ -z "$url" ] && continue
    OUT_DIR=/data/out ./pipeline.sh "$url" || echo "FAILED: $url"
done < queue.txt

終了コード

コード意味すべきこと
0検証済み出力パスを記録。他にすることはありません。
3依存関係の欠落停止して報告。再試行不可。
10ダウンロード失敗想定内。ブロック、非公開、または削除済み。ログを記録して次へ進む。
11ソースに音声なしログを記録して次へ進む。
12トランスコード失敗ログを記録。1回再試行後、報告。
13キャプチャ失敗Xvfb/pulseaudio がインストールされ、表示範囲が空いていることを確認。
14トリミング失敗リードインを測定または検証できませんでした。報告。盲目的な再試行はしない。
15検証失敗出力は <output>.rejected にあります。パイプラインの欠陥として報告。

終了コード 10 は日常的なものであり、インシデントではありません。データセンターのIPアドレスでは、多くのURLでこれが想定される結果です。数を報告し、ループ内で再試行しないでください。

繰り返し失敗する場合

終了コード 14 または 15 は、動画ではなくパイプライン自体に問題があることを意味します。実行時の manifest.json の測定値(first_frame_mae と last_frame_mae)が2つのケースを区別します。

  • last frame MAE 高、first frame MAE 低 → リードインの測定が短く、終了部分が切り詰められています。
  • 両方とも高い → キャプチャがずれているか、ディスプレイが更新されていません。

許容値を調整してパスを強制するのではなく、数値を報告してください。--match-threshold を上げて結果を成功にすることは修正ではありません。

関連スキル