Como Importar Milhares de Vídeos em Massa para o Seu Site Tube com o TubePress

Adicionar vídeos manualmente um de cada vez funciona bem para uma demonstração, mas um site tube real é lançado com um catálogo populado. Este guia mostra como importar vídeos em massa para o seu site tube com o TubePress — as diferenças entre CSV e JSON, como mapear suas colunas com precisão, um exemplo de CSV realista que você pode copiar, como funcionam a detecção de duplicatas e a atribuição em lote, e como manter um fluxo constante de conteúdo novo em um agendamento. O TubePress suporta mais de 10.000 vídeos por passagem de importação e escala para bancos de dados com mais de 500.000 vídeos, então o mesmo fluxo de trabalho funciona independentemente de você estar iniciando um site novo ou abastecendo um grande.

O TubePress é um CMS 100% gratuito e auto-hospedado para sites tube adultos, construído em PHP 8.4 moderno, sem arquivos codificados, sem Composer e sem Node.js. Se você ainda não o instalou, o guia de início apresenta o instalador web de 5 etapas, e você pode explorar a demonstração ao vivo primeiro.

CSV vs JSON: Qual Formato de Importação Usar?

O TubePress aceita tanto CSV quanto JSON para importação em massa. Eles produzem o mesmo resultado — a escolha depende de onde seus dados vêm.

• CSV é o padrão mais adequado. É o que a maioria dos provedores de feeds, planilhas e bancos de dados tube existentes exportam; é trivial de editar em qualquer aplicativo de planilha e mapeia claramente para um vídeo por linha. Use CSV a menos que tenha um motivo específico para não usar.
• JSON é mais adequado quando sua fonte já produz dados estruturados — uma resposta de API, a saída de um scraper ou um feed com campos aninhados. JSON também é mais natural quando um único vídeo tem muitas tags ou performers, pois esses se tornam arrays em vez de strings delimitadas dentro de uma célula.

Ambos os formatos passam pelo mesmo pipeline de importação: analisar o arquivo, mapear campos, detectar duplicatas, aplicar atribuições em lote e gravar as linhas. Assim, você pode padronizar um formato para sua equipe e nunca mais precisar pensar nisso.

Mapeamento Exato de Colunas para Importação de Vídeos no TubePress

O ponto forte do importador é que os cabeçalhos do seu arquivo não precisam corresponder aos nomes de campos internos do TubePress. Durante a importação, você mapeia cada coluna de origem para um campo do TubePress, portanto, um catálogo existente pode ser importado sem reformatação. Os campos que você normalmente mapeará cobrem a entidade central de vídeo, além dos relacionamentos que o TubePress usa para organizar o conteúdo em seus seis tipos de entidades (vídeos, categorias, tags, performers, estúdios, comentários).

Categorias, tags, performers e estúdios são entidades de primeira classe, portanto, qualquer valor importado que ainda não exista é criado e vinculado automaticamente. É isso que faz com que um único arquivo de importação seja suficiente para levantar um site totalmente organizado.

Um Exemplo Realista de CSV

Aqui está um CSV pequeno e pronto para copiar. Observe a linha de cabeçalho (que você mapeia na importação), valores múltiplos delimitados por vírgula dentro de uma célula entre aspas e rótulos genéricos suaves exatamente como os documentos do produto os utilizam:

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"

As mesmas três linhas em JSON simplesmente aninham os campos de múltiplos valores 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"
  }
]

Se os cabeçalhos das suas colunas já corresponderem a esses nomes de campo, o mapeamento é feito com um clique. Se não corresponderem, basta apontar cada coluna de origem para o campo TubePress correto na tela de importação — sem necessidade de renomear colunas na planilha primeiro.

Detecção de Duplicatas: Importe o Mesmo Feed Duas Vezes com Segurança

Reexecutar um feed é normal — os provedores adicionam novos clipes à mesma exportação toda semana. A detecção de duplicatas integrada do TubePress compara as linhas recebidas com o que já está no seu banco de dados e pula as que você já possui, portanto, uma segunda passagem adiciona apenas os vídeos genuinamente novos. É isso que torna as importações programadas e repetidas práticas: você pode apontar o importador para o mesmo arquivo ou feed crescente sem acumular cópias do mesmo clipe.

Atribuição em Lote: Marque a Importação Inteira de Uma Vez

Além das categorias e tags por linha no seu arquivo, o TubePress permite aplicar atribuições em lote a toda a importação em uma única etapa. Se você estiver importando um pacote que seja todo de um estúdio, ou quiser que cada vídeo nesta execução tenha uma categoria ou tag específica, defina uma vez no momento da importação em vez de editar 10.000 linhas. Você pode atribuir em lote categorias, tags, performers e estúdios — útil para organizar um lançamento por origem, por nicho ou por data de importação.

O Catálogo TubePress: Importação com Um Clique e Reescrita de Títulos por IA

Se você ainda não tem seu próprio feed, o Catálogo TubePress é a maneira mais rápida de preencher um site. Você navega por pacotes de vídeos curados e os importa com um clique — sem necessidade de construir um CSV. Dois aspectos tornam isso melhor do que inserir um feed bruto:

• Reescrita de títulos por IA gera títulos únicos e otimizados para SEO para cada vídeo importado, para que você não publique os mesmos títulos duplicados que outros sites usando o mesmo pacote têm. Títulos únicos são importantes para a busca; veja o guia de SEO para sites tube para saber como isso se encaixa na sua estratégia geral.
• Tradução automática renderiza os títulos nos idiomas configurados do seu site, o que se complementa com os 30+ idiomas de interface do TubePress e a tradução de conteúdo por página.

Novas contas gratuitas recebem 150 créditos grátis para experimentar as importações do Catálogo. Como o TubePress em si é gratuito e auto-hospedado, o Catálogo é um acelerador opcional além do CMS gratuito — não um paywall em torno de funcionalidades. Isso é um contraste significativo com plataformas pagas e codificadas; veja a comparação completa se você ainda está escolhendo um CMS.

Agendamento de Importações Recorrentes com Cron

Para um site que deve se manter atualizado, você não quer executar importações manualmente. O TubePress inclui uma API pseudo-cron CronManager que a plataforma já utiliza para tarefas como recalcular seu ranking CTR a cada 10 minutos e executar backups diários programados do banco de dados. Você pode conectar importações recorrentes ao mesmo sistema de agendamento para que novos conteúdos cheguem automaticamente.

O ranking CTR vale a pena conhecer aqui porque recompensa diretamente um fornecimento constante de conteúdo novo. O ranking de cada vídeo é calculado como:

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

Vídeos mais novos recebem um impulso de idade pelo termo de decaimento EXP(-0.01 * days_age), e a pontuação é recalculada a cada 10 minutos com filtragem de bots. Uma importação agendada mantém um fluxo de novos vídeos com days_age = 0 entrando na rotação, que é exatamente o comportamento que o ranking foi projetado para destacar. Há também 13 hooks de substituição se você quiser personalizar a pontuação mais tarde.

Um Fluxo de Trabalho de Importação Repetível

1. Exporte ou monte seu catálogo como CSV (padrão) ou JSON.
2. Faça upload do arquivo e mapeie cada coluna de origem para o campo TubePress correspondente.
3. Defina quaisquer atribuições em lote — um estúdio, uma categoria de lançamento, uma tag de data — para toda a execução.
4. Deixe a detecção de duplicatas ignorar o que já está no banco de dados.
5. Execute a passagem: aproximadamente 10.000 vídeos são carregados.
6. Para atualização contínua, agende a importação via CronManager e/ou use pacotes do Catálogo com títulos reescritos por IA.

O mesmo ciclo escala desde um primeiro lançamento até uma biblioteca com mais de 500.000 vídeos sem alterar seu processo. Depois que seu catálogo estiver carregado, direcione sua energia para SEO e monetização — o volume de conteúdo é apenas a base. Você pode revisar todos os detalhes do importador e do ranking na página de recursos.

Pronto para importar seu catálogo em massa? Baixe o TubePress gratuitamente e tenha um site tube populado no ar em minutos.