コンテンツへスキップ
TubePress — 無料・セルフホスト & 積極的メンテナンス
コンテンツのインポート

フィードインポート(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 配列。キーをマッピングします。
自動と手動の違い。 MRSS と RSS は自動的に認識されます。CSV と JSON は汎用形式のため、列を一度マッピングする必要があります — 以下のフィールドマッピングを参照してください。

フィードソースの追加

  1. フィードタブを開きます。 /admin/import に移動し、フィードを選択して、フィードソースを追加をクリックします。
  2. フィード URL を入力します。 http:// または https:// で始まる必要があります。検出 & プレビューをクリックして形式を自動検出し、最初のエントリをプレビューします。
  3. 名前を付けてタイプを確認します。 ソースに名前を付け、検出された形式(MRSS、RSS、CSV または JSON)と動画タイプを確認します。
  4. モードを選択します。 プレイヤーリンクを保存するには埋め込み、ファイルを取得してトランスコードするにはダウンロードを選択します。
  5. 必要に応じて列をマッピングします。 MRSS と RSS は自動的にマッピングされます。CSV/JSON の場合は、各列を対応するフィールドにドラッグします。
  6. スケジュールとオプションを設定します。 更新間隔、重複ルール、自動公開、クロールするページ数を選択します。
  7. 保存します。 今すぐ取得を使用して即時取得するか、スケジュールに任せます。キューを実行すると、保留中のアイテムをオンデマンドで処理します。

フィールドマッピング

フィードは、インポーターが使用する標準フィールドにエントリを正規化します。MRSS/RSS の場合は自動です。CSV/JSON の場合は、列を以下にマッピングします:

title
必須。タイトルのないエントリはスキップされます。
video_url
直接ダウンロード可能なファイル — ダウンロードモードで使用されます。
embed_url
プレイヤー URL — 埋め込みモードで使用されます。
guid
重複排除に使用される一意の ID。
thumbnail, description, duration, published_at, views
動画のオプションメタデータ。
categories, tags, performers, channels
カンマ区切りの名前。存在しない場合は作成されます。
URL は1つで十分です。 埋め込みモードでは、embed_url をマッピングしていない場合、video_url 1つが埋め込みリンクとしても機能します。最小限のフィードはタイトルと URL 1つだけで済みます。

スケジュール & 自動化

feed_import という名前のバックグラウンドタスクが擬似 cron 上でおよそ30秒ごとに実行されます — システムの crontab は不要です。各ソースは設定された間隔が経過したときのみ取得されます:

  • 手動のみ — 自動取得されません。今すぐ取得を使用してください。
  • 15分ごと1時間ごと6時間ごとまたは毎日

同じタスクはインポートキューも消化します — 埋め込みアイテムは複数同時に処理し、ダウンロードは1件ずつ処理するため、大きなファイルが他の処理をブロックすることはありません。最大ページ数設定(1–50)は、ページネーションされたフィードを1回の取得でどこまでクロールするかを制限します。

cron にはトラフィックが必要です。 擬似 cron はサイトにアクセスがあった場合にのみ動作します。新しいサイトやアクセスがないサイトでは、ページを読み込んでトリガーするか、正確なタイミングのために実際の cron ジョブを設定してください(cron & CLI を参照)。

重複排除 & フィルター

重複排除は自動的に行われ、2つのレベルで機能します:

  • ソースごと。 各アイテムの guid が記憶されるため、再取得時に本当に新しいエントリのみがキューに追加されます(既に見たアイテムはカウントされてスキップされます)。
  • サイト全体。 ダウンロードモードでは、アイテムの ID が動画に保存されるため、2つのフィードから同じクリップが届いても2度ダウンロードされることはありません。

重複時オプションは、アイテムがすでに存在する場合の動作を決定します:スキップ(推奨)または既存を更新

キーワードフィルターなし。 フィードには含める/除外するキーワードフィルターがありません — ソースのカテゴリまたはタグ固有の URL を指定することでフィードの対象を絞り込み、最大ページ数で深さを制限してください。ソースのアイテムをクリアすると重複排除のメモリはリセットされますが、すでにインポートした動画は削除されません。

フィードのトラブルシューティング

  • 「フィード形式を認識できませんでした。」 URL が有効な MRSS/RSS/CSV/JSON を返しませんでした。ブラウザで開き、HTML ページではなく生のフィードが表示されることを確認してください。
  • アイテムが「インポート中」のまま停止している。 約30分後に自動回復して再試行されます。一時的な失敗は最大3回再試行された後、失敗としてマークされます。
  • 失敗したアイテム。 再処理を使用して、ソースで失敗したすべてのアイテムを再キューイングします。各ソースは最後のステータスとメッセージを表示します。
  • ダウンロードモードが失敗する。 ダウンロードには直接の動画 URL(視聴ページではなく)が必要です。プライベートまたは内部ホストはブロックされ、ファイルあたり5 GB の上限があります。
  • 何もインポートされない。 スケジュールが手動のみに設定されていないこと、ソースが有効になっていること、cron を動作させるためにサイトがトラフィックを受け取っていることを確認してください。

次のステップ

まだお困りですか?

ダッシュボードからチケットを送信してください。サポートチームがお手伝いします。

ライブデモを試す → TubePress をダウンロード →