TubePressでチューブサイトに数千本の動画を一括インポートする方法

動画を1本ずつ手動で追加するのはデモには十分ですが、本物のチューブサイトはコンテンツが揃ったカタログとともにローンチします。このガイドでは、TubePress を使ってチューブサイトに動画を一括インポートする方法を解説します。CSV と JSON の違い、列のマッピング方法、そのままコピーできる CSV のサンプル、重複検出とバッチ割り当ての仕組み、そしてスケジュールを使って新鮮なコンテンツを継続的に取り込む方法についても説明します。TubePress は1回のインポートで10,000本以上の動画を処理でき、50万本以上の動画データベースにも対応しているため、新規サイトへの初期投入でも大規模サイトの補充でも同じワークフローが使えます。

TubePress は、アダルトチューブサイト向けの100%無料の自己ホスト型 CMS です。モダンな PHP 8.4 で構築されており、エンコードされたファイルも、Composer も、Node.js も不要です。まだインストールしていない場合は、入門ガイドで5ステップのウェブインストーラーを説明しています。先に公開中のデモを試してみることもできます。

CSV と JSON: どのインポート形式を使うべきか？

TubePress は一括インポートに CSV と JSON の両方に対応しています。どちらも同じ結果を生成します。選択はデータの元がどこかによって決まります。

• CSV が正しいデフォルトの選択です。ほとんどのフィードプロバイダー、スプレッドシート、既存のチューブデータベースは CSV をエクスポートしており、どのスプレッドシートアプリでも簡単に編集でき、1行1動画というシンプルな対応関係があります。特別な理由がない限り CSV を使用してください。
• JSON は、ソースが構造化データ（API レスポンス、スクレイパーの出力、ネストされたフィールドを含むフィード）をすでに生成している場合に適しています。また、1本の動画に多くのタグやパフォーマーがある場合、セル内の区切り文字列ではなく配列として表現できるため、JSON の方が自然に読めます。

どちらの形式も同じインポートパイプラインを通過します。ファイルの解析、フィールドのマッピング、重複の検出、バッチ割り当ての適用、そして行の書き込みです。チームで1つの形式に統一しておけば、後は気にする必要はありません。

TubePress 動画インポートの正確な列マッピング

インポーターの強みは、ファイルのヘッダーが TubePress の内部フィールド名と一致する必要がないことです。インポート時に各ソース列を TubePress フィールドにマッピングするため、既存のカタログは再フォーマットせずにそのままインポートできます。通常マッピングするフィールドは、コアの動画エンティティと、TubePress が6つのエンティティタイプ（動画、カテゴリ、タグ、パフォーマー、スタジオ、コメント）でコンテンツを整理するために使用するリレーションシップをカバーしています。

カテゴリ、タグ、パフォーマー、スタジオはファーストクラスのエンティティであるため、インポートした値が存在しない場合は自動的に作成されてリンクされます。これにより、1つのインポートファイルだけで完全に整理されたサイトを構築できます。

現実的な CSV のサンプル

そのままコピーできる小さな CSV を示します。ヘッダー行（インポート時にマッピング）、引用符付きセル内のカンマ区切り複数値、そして製品ドキュメントで使われている汎用的なラベルに注意してください：

title,description,video_url,thumbnail_url,duration,categories,tags,performers,studio
"Beach Day POV","Sunny outdoor clip in full HD.",https://cdn.example.com/v/1001.mp4,https://cdn.example.com/t/1001.jpg,612,"Amateur,Outdoor","HD,POV","Alex Rivers","Riverside Media"
"Studio Session 12","Behind-the-scenes set.",https://cdn.example.com/v/1002.mp4,https://cdn.example.com/t/1002.jpg,845,"Studio","HD,Behind The Scenes","Jamie Lin","Riverside Media"
"Late Night Vol 3","Low-light indoor shoot.",https://cdn.example.com/v/1003.mp4,https://cdn.example.com/t/1003.jpg,1207,"Amateur","POV,Verified","Alex Rivers,Jamie Lin","Northside Films"

同じ3行を JSON で表現すると、複数値フィールドは単純に配列としてネストされます：

[
  {
    "title": "Beach Day POV",
    "description": "Sunny outdoor clip in full HD.",
    "video_url": "https://cdn.example.com/v/1001.mp4",
    "thumbnail_url": "https://cdn.example.com/t/1001.jpg",
    "duration": 612,
    "categories": ["Amateur", "Outdoor"],
    "tags": ["HD", "POV"],
    "performers": ["Alex Rivers"],
    "studio": "Riverside Media"
  }
]

列ヘッダーがすでにこれらのフィールド名と一致している場合、マッピングはワンクリックで完了します。一致しない場合は、インポート画面で各ソース列を適切な TubePress フィールドに指定するだけです。スプレッドシートで列の名前を変える必要はありません。

重複検出：同じフィードを安全に2回インポートする

フィードの再実行は通常のことです。プロバイダーは毎週同じエクスポートに新しいクリップを追加します。TubePress の組み込み重複検出機能は、受信した行をデータベース内の既存データと比較し、すでに存在するものをスキップするため、2回目の実行では本当に新しい動画だけが追加されます。これにより、スケジュールされた繰り返しインポートが実用的になります。同じ成長中のファイルやフィードをインポーターに向けても、同じクリップのコピーが蓄積されることはありません。

バッチ割り当て：インポート全体を一括でタグ付け

ファイル内の行ごとのカテゴリとタグに加えて、TubePress ではインポート全体にバッチ割り当てを1ステップで適用できます。1つのスタジオからのパックをインポートする場合や、この実行のすべての動画に特定のカテゴリやタグを付けたい場合は、10,000行を編集する代わりにインポート時に一度設定するだけで済みます。カテゴリ、タグ、パフォーマー、スタジオをバッチ割り当てできます。ソース別、ニッチ別、インポート日別にローンチを整理するのに役立ちます。

TubePress カタログ：AI タイトル書き換えによるワンクリックインポート

独自のフィードをまだお持ちでない場合、TubePress カタログはサイトにコンテンツを入れる最速の方法です。厳選された動画パックを閲覧し、ワンクリックでインポートできます。CSV を作成する必要はありません。生のフィードを取り込むよりも優れている点が2つあります：

• AI タイトル書き換えにより、インポートされたすべての動画に対して一意の SEO に最適化されたタイトルが生成されます。これにより、同じパックを使っている他のサイトと重複するタイトルを公開することがなくなります。一意のタイトルは検索において重要です。これが全体的な戦略にどう結びつくかは、チューブサイト SEO ガイドをご覧ください。
• 自動翻訳により、タイトルがサイトで設定された言語にレンダリングされます。これは TubePress の30以上のインターフェース言語とページごとのコンテンツ翻訳と組み合わせて使用できます。

新しい無料アカウントにはカタログインポートを試すための150クレジットが付与されます。TubePress 自体は無料で自己ホスト型であるため、カタログは無料 CMS の上にあるオプションのアクセラレーターであり、機能へのペイウォールではありません。これは有料のエンコードプラットフォームとの意味ある違いです。まだ CMS を選んでいる方は、詳しい比較をご覧ください。

cron を使った定期インポートのスケジューリング

常に新鮮な状態を保つサイトでは、インポートを手動で実行したくないでしょう。TubePress には CronManager 疑似 cron API が同梱されており、プラットフォームはすでにこれを使って CTR ランキングの10分ごとの再計算やスケジュールされた毎日のデータベースバックアップなどのタスクを実行しています。同じスケジューリングシステムに定期インポートを追加することで、新しいコンテンツが自動的に追加されるようになります。

CTR ランキングはここで知っておく価値があります。新鮮なコンテンツの安定した供給を直接報酬として与えるからです。各動画のランクは以下のように計算されます：

ctr_score = (views / (impressions + 50)) * EXP(-0.01 * days_age)

新しい動画は EXP(-0.01 * days_age) 減衰項による年齢ブーストを受け、スコアはボットフィルタリングを伴って10分ごとに再計算されます。スケジュールされたインポートにより、新しい days_age = 0 の動画が継続的にローテーションに入ります。これはまさにランキングが表面化するよう設計された動作です。後でスコアリングをカスタマイズしたい場合は、13個のオーバーライドフックも用意されています。

繰り返し可能なインポートワークフロー

1. カタログを CSV（デフォルト）または JSON としてエクスポートまたは組み立てる。
2. ファイルをアップロードし、各ソース列を対応する TubePress フィールドにマッピングする。
3. 実行全体のバッチ割り当て（スタジオ、ローンチカテゴリ、日付タグなど）を設定する。
4. 重複検出がデータベースにすでにあるものをスキップするようにする。
5. 実行する：約10,000本の動画が追加される。
6. 継続的な新鮮さのために、CronManager 経由でインポートをスケジュールするか、AI で書き換えられたタイトルを持つカタログパックを使用する。

同じループがプロセスを変えることなく、最初のローンチから50万本以上の動画のライブラリまでスケールします。カタログが揃ったら、エネルギーを SEO と 収益化に向けてください。コンテンツ量は単なる基盤に過ぎません。すべてのインポーターとランキングの詳細は機能ページで確認できます。

カタログの一括インポートの準備はできましたか？TubePress を無料でダウンロードして、数分でコンテンツが揃ったチューブサイトを立ち上げましょう。