mcpField
T
tiktok-music-archive-downloader

tiktok-music-archive-downloader

github.com/postplusaiクリエイティブ・メディア27499 回インストール1 日前に更新
リポジトリ

tiktok-music-archive-downloader について

選定済みの TikTok 音楽やサウンドをアーカイブし、ローカル参照ファイルと再現可能なマニフェストを必要とする人向けのスキルです。アクセス可能な投稿をダウンロードして ffmpeg で音声を抽出し、出典とファイルの情報を記録します。利用権が確認されるまでは研究用素材として扱います。

主な機能

  1. 01範囲を絞ったダウンロードマニフェストの作成
  2. 02アクセス可能な TikTok 投稿のダウンロード
  3. 03ffmpeg による音声抽出
  4. 04出典とファイルを結ぶインデックス作成
  5. 05失敗の報告と出典 URL の保持

活用シーン

  1. 01選定した TikTok サウンドを研究用に保存
  2. 02レビュー用のローカル音声参照を準備
  3. 03出典投稿と抽出ファイルを対応付けて管理
  4. 04ダウンロードと抽出の結果を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/postplusai/postplus-skills --skill tiktok-music-archive-downloader

インストール後、Claude Code で/tiktok-music-archive-downloaderを入力して読み込まれたか確認します。

詳細

TikTok Music Archive Downloader

このスキルは、TikTok の音楽またはサウンド候補がすでに選定されており、ユーザーがローカルのサンプルファイル、音声リファレンス、および再現可能なアーカイブマニフェストを必要としている場合に使用します。

postplus-shared の共有ローカル依存関係およびユーザーガイダンスのルールを適用してください。

使用しない場合

  • ユーザーがまだトレンドの音楽を探索している段階である。まず tiktok-research から始めてください。
  • ユーザーがホスト型の TikTok メタデータ収集を必要としている。
  • ユーザーが、ある音声が公開投稿に対して法的にクリアされているかどうかを尋ねている。

必須入力

  • TikTok 投稿ページ URL を含む小規模なダウンロードマニフェスト。
  • ローカル依存関係: yt_dlp を含む python3、および ffmpeg。
  • アーカイブを .postplus/ 配下に書き込むことができる作業フォルダー。

正規化された上流データセットに postPageUrl と直接の動画フィールドの両方が含まれる場合、sourceUrl には正規の TikTok 投稿ページ URL を優先してください。

アクセス境界

ダウンロードは、依存関係チェックに合格した後、ユーザーの現在のローカルブラウザー/IP 環境から到達可能な TikTok 投稿 URL に対してのみサポートされます。TikTok が IP、ブラウザーアクセス、ログイン、または Cookie によって投稿を制限している場合、ローカルツールは必要ですが十分ではありません。

ダウンロードレポートに failureCode: "tiktok_ip_blocked" が含まれている場合は、保持されている sourceUrl、stderr、およびレポートパスとともにブロッカーを報告してください。広範なダウンロードを再試行したり、プロキシを切り替えたり、Cookie/ブラウザーのブートストラップパスをでっち上げたりしないでください。

デフォルトのワークフロー

  1. 選択された動画またはサウンドから、範囲を限定したマニフェストを構築します。
  2. 共有ダウンローダーを実行します:
  --manifest <download-manifest.json> \
  --output-dir <videos-dir> \
  --report <download-report.json> \
  --concurrency 2 \
  --attempts 3
  1. 音声抽出の前に、ダウンロードのブロッカーで停止します。
  2. 成功したダウンロードから ffmpeg で音声を抽出します。
  3. 各ローカルファイルを musicId、musicTitle、sourceVideoUrl、ソースコレクションパス、ダウンロードステータス、ローカル動画パス、およびローカル音声パスにリンクする index.json を書き込みます。

アーカイブレイアウト

以下を使用します:

<work-folder>/.postplus/tiktok-music-archive-downloader/<run-id>/
  manifest/
  videos/
  audio/
  index.json

最終的なアーカイブサマリーまたは選択されたエクスポートは、ユーザーがそれらを検査したり、先方に渡したりする必要がある場合にのみ、.postplus/ の外に置いてください。

検証

  • ダウンロードされたファイルが存在し、空でないことを確認します。
  • 音声ファイルが存在し、空でないことを確認します。
  • 失敗を隠さずに個別に報告します。
  • ダウンロードが失敗した場合でも、マニフェストにソース URL を保持します。
  • TikTok のアクセスによってブロックされたソースセットについては、音声抽出に進まないでください。

権利に関する姿勢

ユーザーが権利またはプラットフォームライセンスに基づく使用を確認しない限り、ダウンロードした TikTok の音楽は研究または参考資料として扱ってください。抽出された音声を商用再利用に対してクリアであると提示しないでください。

引き継ぎ

  • さらに多くの TikTok の音楽またはソース候補が必要 -> tiktok-research。
  • 動画レベルの内訳が必要 -> video-analysis。
  • 文字起こしまたは音声抽出が必要 -> audio-transcription または video-transcription。

公開コマンド境界

  • ユーザー入力から一致する最小のコマンドまたはワークフローを選択し、それを直接実行します。
  • 所有する CLI またはスクリプトコマンドが失敗した場合は、正確なエラーを報告して停止します。メタデータのみの回答、レディネスプロービング、ローカルペイロードの書き換え、フォールバックプロバイダー、または未公開のツールで失敗を回避しないでください。
  • postplus research schema --collection-key <collection-key> --json は、未知のリクエスト形状を構築または修復する場合にのみ使用してください。
  • ホスト型コレクション: postplus research collect --skill tiktok-music-archive-downloader --collection-key <collection-key> --input <hosted-envelope.json> --output <collection-result.json>。
  • 保留中のコレクションを再開する: postplus research collect --run-handle <runHandle> --output <collection-result.json>。
  • 最初のパスは範囲を限定して行い、最初の結果を検査した後にのみ拡張してください。
  • CLI が quote-confirmation チャレンジを返した場合は、postplus quote confirm --json --challenge-file <challenge.json> を実行し、返されたトークンで再試行してください。

コメント

Markdown 対応