フィードインポート(MRSS、RSS、CSV、JSON)
外部フィードを接続し、スケジュールに沿って新しい動画を自動で取り込みます。
フィードインポート(グラバーとも呼ばれます)は、ライブラリを自動的に成長させ続けます。リモートフィードに一度登録すると、TubePress がスケジュールに従ってチェックし、新しい動画を取り込み、すでに取得済みのものはスキップします。
これはインポート画面内のタブとして存在します — /admin/import を開き、フィード タブに切り替えてください(/admin/feeds URL はそこにリダイレクトされます)。一回限りのファイルアップロードとは異なり、フィードはソースが新しいコンテンツを公開するたびにサイトを補充し続けます。
フィードインポートの機能
各ソースはフィード URL といくつかの設定で構成されます。スケジュールに従い、TubePress はフィードを取得し、すべてのエントリを正規化して新しいものをキューに追加します。次の段階でキューのアイテムが動画に変換されます。メディアの保存方法は以下から選択できます:
- 埋め込み — プレイヤーリンクを保存します。高速でストレージを消費せず、動画はソースからストリーミングされます。
- ダウンロード — 実際のファイルをストレージまたは CDN に取得し、レンディションにトランスコードします。
ソースごとに動画タイプ(ストレート、ゲイ、またはヘンタイ)と、新しい動画を自動公開するか、レビュー用の下書きとして保留するかを設定します。
対応フィード形式
4つの形式に対応しており、検出 & プレビュー ボタンで自動検出されます:
| 形式 | マッピング | 備考 |
|---|---|---|
| MRSS | 自動 | Media RSS — 最も豊富なオプション。フィールドは自動的にマッピングされます。 |
| RSS | 自動 | 標準 RSS アイテム。 |
| CSV | 手動 | URL で提供される CSV。列をマッピングします。 |
| JSON | 手動 | URL で提供される JSON 配列。キーをマッピングします。 |
フィードソースの追加
- フィードタブを開きます。
/admin/importに移動し、フィードを選択して、フィードソースを追加をクリックします。 - フィード URL を入力します。
http://またはhttps://で始まる必要があります。検出 & プレビューをクリックして形式を自動検出し、最初のエントリをプレビューします。 - 名前を付けてタイプを確認します。 ソースに名前を付け、検出された形式(MRSS、RSS、CSV または JSON)と動画タイプを確認します。
- モードを選択します。 プレイヤーリンクを保存するには埋め込み、ファイルを取得してトランスコードするにはダウンロードを選択します。
- 必要に応じて列をマッピングします。 MRSS と RSS は自動的にマッピングされます。CSV/JSON の場合は、各列を対応するフィールドにドラッグします。
- スケジュールとオプションを設定します。 更新間隔、重複ルール、自動公開、クロールするページ数を選択します。
- 保存します。 今すぐ取得を使用して即時取得するか、スケジュールに任せます。キューを実行すると、保留中のアイテムをオンデマンドで処理します。
フィールドマッピング
フィードは、インポーターが使用する標準フィールドにエントリを正規化します。MRSS/RSS の場合は自動です。CSV/JSON の場合は、列を以下にマッピングします:
embed_url をマッピングしていない場合、video_url 1つが埋め込みリンクとしても機能します。最小限のフィードはタイトルと URL 1つだけで済みます。スケジュール & 自動化
feed_import という名前のバックグラウンドタスクが擬似 cron 上でおよそ30秒ごとに実行されます — システムの crontab は不要です。各ソースは設定された間隔が経過したときのみ取得されます:
- 手動のみ — 自動取得されません。今すぐ取得を使用してください。
- 15分ごと、1時間ごと、6時間ごとまたは毎日。
同じタスクはインポートキューも消化します — 埋め込みアイテムは複数同時に処理し、ダウンロードは1件ずつ処理するため、大きなファイルが他の処理をブロックすることはありません。最大ページ数設定(1–50)は、ページネーションされたフィードを1回の取得でどこまでクロールするかを制限します。
重複排除 & フィルター
重複排除は自動的に行われ、2つのレベルで機能します:
- ソースごと。 各アイテムの
guidが記憶されるため、再取得時に本当に新しいエントリのみがキューに追加されます(既に見たアイテムはカウントされてスキップされます)。 - サイト全体。 ダウンロードモードでは、アイテムの ID が動画に保存されるため、2つのフィードから同じクリップが届いても2度ダウンロードされることはありません。
重複時オプションは、アイテムがすでに存在する場合の動作を決定します:スキップ(推奨)または既存を更新。
フィードのトラブルシューティング
- 「フィード形式を認識できませんでした。」 URL が有効な MRSS/RSS/CSV/JSON を返しませんでした。ブラウザで開き、HTML ページではなく生のフィードが表示されることを確認してください。
- アイテムが「インポート中」のまま停止している。 約30分後に自動回復して再試行されます。一時的な失敗は最大3回再試行された後、失敗としてマークされます。
- 失敗したアイテム。 再処理を使用して、ソースで失敗したすべてのアイテムを再キューイングします。各ソースは最後のステータスとメッセージを表示します。
- ダウンロードモードが失敗する。 ダウンロードには直接の動画 URL(視聴ページではなく)が必要です。プライベートまたは内部ホストはブロックされ、ファイルあたり5 GB の上限があります。
- 何もインポートされない。 スケジュールが手動のみに設定されていないこと、ソースが有効になっていること、cron を動作させるためにサイトがトラフィックを受け取っていることを確認してください。