Cómo importar en masa miles de vídeos a tu tube site con TubePress

Añadir vídeos manualmente uno por uno está bien para una demo, pero un sitio tube real se lanza con un catálogo lleno. Esta guía te muestra cómo importar vídeos en masa a tu sitio tube con TubePress — las diferencias entre CSV y JSON, cómo mapear exactamente tus columnas, un ejemplo realista de CSV que puedes copiar, cómo funcionan la detección de duplicados y la asignación por lotes, y cómo mantener un flujo de contenido fresco de forma programada. TubePress gestiona más de 10.000 vídeos por pasada de importación y escala a bases de datos con más de 500.000 vídeos, por lo que el mismo flujo de trabajo sirve tanto si estás iniciando un sitio nuevo como si estás ampliando uno grande.

TubePress es un CMS 100% gratuito y autohospedado para sitios tube adultos, construido sobre PHP 8.4 moderno sin archivos codificados, sin Composer y sin Node.js. Si aún no lo has instalado, la guía de inicio explica el instalador web de 5 pasos, y puedes explorar la demo en vivo primero.

CSV vs JSON: ¿Qué formato de importación debes usar?

TubePress acepta tanto CSV como JSON para la importación masiva. Producen el mismo resultado: la elección depende de dónde provienen tus datos.

• CSV es la opción predeterminada correcta. Es lo que exportan la mayoría de proveedores de feeds, hojas de cálculo y bases de datos tube existentes; es trivial de editar en cualquier aplicación de hojas de cálculo y se corresponde limpiamente con un vídeo por fila. Usa CSV a menos que tengas una razón específica para no hacerlo.
• JSON es más adecuado cuando tu fuente ya produce datos estructurados — una respuesta de API, la salida de un scraper o un feed con campos anidados. JSON también resulta más natural cuando un vídeo tiene muchas etiquetas o intérpretes, ya que estos se convierten en arrays en lugar de cadenas delimitadas dentro de una celda.

Ambos formatos pasan por el mismo proceso de importación: analizar el archivo, mapear campos, detectar duplicados, aplicar asignaciones por lotes y escribir las filas. Así puedes estandarizar un formato para tu equipo y no volver a pensar en ello.

Mapeo exacto de columnas para una importación de vídeos en TubePress

La fortaleza del importador es que los encabezados de tu archivo no tienen que coincidir con los nombres de campo internos de TubePress. Durante la importación, mapeas cada columna de origen a un campo de TubePress, de modo que un catálogo existente puede importarse tal cual sin reformatear. Los campos que normalmente mapearás cubren la entidad de vídeo principal más las relaciones que TubePress usa para organizar el contenido en sus seis tipos de entidades (vídeos, categorías, etiquetas, intérpretes, estudios, comentarios).

Las categorías, etiquetas, intérpretes y estudios son entidades de primera clase, por lo que cualquier valor que importes que aún no exista se crea y vincula automáticamente. Eso es lo que hace que un único archivo de importación sea suficiente para levantar un sitio completamente organizado.

Un ejemplo realista de CSV

Aquí tienes un CSV pequeño y listo para copiar. Observa la fila de encabezado (que mapeas en la importación), los valores múltiples delimitados por comas dentro de una celda entre comillas, y etiquetas genéricas leves exactamente como las usan los docs del producto:

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"

Las mismas tres filas en JSON simplemente anidan los campos de valores múltiples como arrays:

[
  {
    "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"
  }
]

Si los encabezados de tus columnas ya coinciden con estos nombres de campo, el mapeo es un solo clic. Si no es así, simplemente apuntas cada columna de origen al campo correcto de TubePress en la pantalla de importación, sin necesidad de renombrar columnas en tu hoja de cálculo primero.

Detección de duplicados: importa el mismo feed dos veces de forma segura

Volver a ejecutar un feed es normal — los proveedores añaden nuevos clips a la misma exportación cada semana. La detección de duplicados integrada de TubePress compara las filas entrantes con lo que ya hay en tu base de datos y omite las que ya tienes, de modo que una segunda pasada solo añade los vídeos genuinamente nuevos. Esto es lo que hace prácticas las importaciones programadas y repetidas: puedes apuntar el importador al mismo archivo o feed en crecimiento sin acumular copias del mismo clip.

Asignación por lotes: etiqueta toda la importación a la vez

Además de las categorías y etiquetas por fila en tu archivo, TubePress te permite aplicar asignaciones por lotes a toda la importación en un solo paso. Si estás importando un paquete que proviene de un solo estudio, o quieres que cada vídeo de esta ejecución lleve una categoría o etiqueta específica, configúralo una vez en el momento de la importación en lugar de editar 10.000 filas. Puedes asignar por lotes categorías, etiquetas, intérpretes y estudios, lo cual es útil para organizar un lanzamiento por fuente, por nicho o por fecha de importación.

El Catálogo de TubePress: importación con un clic y reescritura de títulos con IA

Si aún no tienes tu propio feed, el Catálogo de TubePress es la forma más rápida de llenar un sitio. Exploras paquetes de vídeos curados y los importas con un clic, sin necesidad de construir un CSV. Dos cosas hacen que esto sea mejor que insertar un feed sin procesar:

• La reescritura de títulos con IA genera títulos únicos y optimizados para SEO para cada vídeo importado, de modo que no publicas los mismos títulos duplicados que tienen otros sitios que ejecutan el mismo paquete. Los títulos únicos importan para el posicionamiento en buscadores; consulta la guía de SEO para sitios tube para ver cómo encaja esto en tu estrategia general.
• La traducción automática renderiza los títulos en los idiomas configurados de tu sitio, lo que se combina con los más de 30 idiomas de interfaz de TubePress y la traducción de contenido por página.

Las nuevas cuentas gratuitas reciben 150 créditos gratuitos para probar las importaciones del Catálogo. Como TubePress en sí es gratuito de usar y autohospedado, el Catálogo es un acelerador opcional sobre el CMS gratuito, no una barrera de pago alrededor de las funciones. Ese es un contraste significativo con las plataformas de pago y codificadas; consulta la comparación completa si todavía estás eligiendo un CMS.

Programar importaciones recurrentes con cron

Para un sitio que debe mantenerse actualizado, no querrás ejecutar importaciones manualmente. TubePress incluye una API pseudo-cron CronManager que la plataforma ya utiliza para tareas como recalcular su clasificación CTR cada 10 minutos y ejecutar copias de seguridad programadas diarias de la base de datos. Puedes colgar importaciones recurrentes del mismo sistema de programación para que el nuevo contenido llegue automáticamente.

Vale la pena conocer la clasificación CTR aquí porque recompensa directamente un suministro constante de contenido fresco. La clasificación de cada vídeo se calcula como:

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

Los vídeos más nuevos obtienen un impulso de antigüedad mediante el término de decaimiento EXP(-0.01 * days_age), y la puntuación se recalcula cada 10 minutos con filtrado de bots. Una importación programada mantiene un flujo de nuevos vídeos con days_age = 0 entrando en la rotación, que es exactamente el comportamiento que el ranking está diseñado para destacar. También hay 13 hooks de anulación si deseas personalizar la puntuación más adelante.

Un flujo de trabajo de importación repetible

1. Exporta o ensambla tu catálogo en CSV (predeterminado) o JSON.
2. Sube el archivo y mapea cada columna de origen al campo correspondiente de TubePress.
3. Configura las asignaciones por lotes (un estudio, una categoría de lanzamiento, una etiqueta de fecha) para toda la ejecución.
4. Deja que la detección de duplicados omita lo que ya está en la base de datos.
5. Ejecuta la pasada: aterrizan aproximadamente 10.000 vídeos.
6. Para mantener la frescura continua, programa la importación mediante CronManager y/o usa paquetes del Catálogo con títulos reescritos por IA.

Ese mismo bucle escala desde el primer lanzamiento hasta una biblioteca con más de 500.000 vídeos sin cambiar tu proceso. Una vez que tu catálogo esté cargado, enfoca tu energía en SEO y monetización — el volumen de contenido es solo la base. Puedes revisar todos los detalles del importador y del ranking en la página de funciones.

¿Listo para importar tu catálogo en masa? Descarga TubePress gratis y ten un sitio tube poblado en vivo en minutos.