Importación por feed (MRSS, RSS, CSV, JSON)
Conecta feeds externos y extrae nuevos vídeos automáticamente de forma programada.
La importación de feeds (a veces llamada grabbers) mantiene tu biblioteca creciendo por sí sola. Te suscribes a un feed remoto una vez, y TubePress lo comprueba según un horario, importa los videos nuevos y omite lo que ya ha visto.
Se encuentra como una pestaña dentro de la pantalla de importación — abre /admin/import y cambia a Feeds (la URL /admin/feeds redirige allí). A diferencia de una carga puntual de archivos, un feed mantiene tu sitio actualizado a medida que la fuente publica más contenido.
Qué hace la importación de feeds
Cada fuente es una URL de feed más algunos ajustes. Según su horario, TubePress obtiene el feed, normaliza cada entrada y pone en cola las nuevas; una segunda etapa convierte esos elementos en cola en videos. Tú eliges cómo se almacena el contenido multimedia:
- Embed — almacena el enlace del reproductor. Rápido, no usa almacenamiento y el video se transmite desde la fuente.
- Download — descarga el archivo real a tu almacenamiento o CDN y lo transcodifica en tus versiones.
Por fuente también configuras el tipo de video (straight, gay o hentai) y si los videos nuevos se publican automáticamente o se retienen como borradores para revisión.
Formatos de feed compatibles
Se admiten cuatro formatos, detectados automáticamente por el botón Detect & Preview:
| Formato | Mapeo | Notas |
|---|---|---|
| MRSS | Automático | Media RSS — la opción más completa; los campos se asignan automáticamente. |
| RSS | Automático | Elementos RSS estándar. |
| CSV | Manual | Un CSV servido en una URL; tú asignas las columnas. |
| JSON | Manual | Un array JSON servido en una URL; tú asignas las claves. |
Agregar una fuente de feed
- Abre la pestaña Feeds. Ve a
/admin/import, selecciona Feeds y luego Add Feed Source. - Introduce la URL del feed. Debe comenzar con
http://ohttps://. Haz clic en Detect & Preview para detectar automáticamente el formato y previsualizar las primeras entradas. - Ponle nombre y confirma el tipo. Dale un nombre a la fuente y verifica el formato detectado (MRSS, RSS, CSV o JSON) y el tipo de video.
- Elige un modo. Embed para almacenar enlaces de reproductor, o Download para descargar y transcodificar los archivos.
- Asigna las columnas si es necesario. MRSS y RSS se asignan solos; para CSV/JSON, arrastra cada columna al campo correspondiente.
- Configura el horario y las opciones. Elige un intervalo de actualización, la regla de duplicados, la publicación automática y cuántas páginas rastrear.
- Guarda. Usa Fetch now para obtener el feed de inmediato, o deja que el horario se ejecute. Run queue procesa los elementos pendientes bajo demanda.
Mapeo de campos
Los feeds normalizan las entradas en los mismos campos canónicos que usa el importador. Para MRSS/RSS esto es automático; para CSV/JSON asignas tus columnas a:
video_url sirve también como enlace de inserción si no has asignado embed_url, por lo que un feed mínimo solo necesita un título y una URL.Programación & automatización
Una tarea en segundo plano llamada feed_import se ejecuta en el pseudo-cron aproximadamente cada 30 segundos — no se necesita crontab del sistema. Cada fuente solo se obtiene cuando ha transcurrido su propio intervalo:
- Solo manual — nunca se obtiene automáticamente; usa Fetch now.
- Cada 15 minutos, cada hora, cada 6 horas o cada día.
La misma tarea también vacía la cola de importación — los elementos embed se procesan varios a la vez, las descargas se hacen de una en una para que un archivo grande nunca bloquee el resto. El ajuste Max pages (1–50) limita cuánto profundiza una sola obtención en un feed paginado.
Deduplicación & filtros
La deduplicación es automática y funciona en dos niveles:
- Por fuente. Se recuerda el
guidde cada elemento, por lo que al volver a obtener el feed solo se ponen en cola las entradas realmente nuevas (los elementos ya vistos se cuentan y se omiten). - En todo el sitio. En modo Download, el ID del elemento se almacena en el video, por lo que el mismo clip que llega de dos feeds no se descarga dos veces.
La opción On duplicate decide qué ocurre cuando un elemento ya existe: Skip (recomendado) o Update existing.
Solución de problemas con feeds
- «No se pudo reconocer el formato del feed.» La URL no devolvió MRSS/RSS/CSV/JSON válido. Ábrela en un navegador y confirma que ves el feed en bruto, no una página HTML.
- Elementos bloqueados en «importando». Se recuperan solos después de unos 30 minutos y se reintenta; los fallos transitorios se reintentan hasta tres veces antes de marcarse como fallidos.
- Elementos fallidos. Usa Reprocess para volver a poner en cola todo lo que falló para una fuente. Cada fuente muestra su último estado y mensaje.
- El modo Download falla. Download necesita una URL de video directa (no una página de visualización); los hosts privados o internos están bloqueados, y hay un límite de 5 GB por archivo.
- No se importa nada. Comprueba que el horario no esté en Solo manual, que la fuente esté habilitada y que tu sitio reciba tráfico para activar el cron.
Próximos pasos
¿Todavía con dudas?
Abre un ticket desde tu panel y nuestro equipo te ayudará.