Importação de feeds (MRSS, RSS, CSV, JSON)

A importação de feed (também chamada de grabbers) mantém sua biblioteca crescendo sozinha. Você assina um feed remoto uma vez, e o TubePress o verifica periodicamente, importa novos vídeos e pula tudo o que já foi visto.

Ela fica como uma aba dentro da tela de importação — abra /admin/import e alterne para Feeds (a URL /admin/feeds redireciona para lá). Ao contrário de um upload único de arquivo, um feed continua abastecendo seu site à medida que a fonte publica mais.

O que a importação de feed faz

Cada fonte é uma URL de feed mais algumas configurações. No seu horário, o TubePress busca o feed, normaliza cada entrada e coloca as novas na fila; uma segunda etapa transforma esses itens enfileirados em vídeos. Você escolhe como a mídia é armazenada:

• Embed — armazena o link do player. Rápido, não usa armazenamento, e o vídeo é transmitido da fonte.
• Download — baixa o arquivo real para seu armazenamento ou CDN e o transcodifica nas suas renderizações.

Por fonte, você também define o tipo de vídeo (hetero, gay ou hentai) e se os novos vídeos são publicados automaticamente ou mantidos como rascunhos para revisão.

Formatos de feed suportados

Quatro formatos são suportados, detectados automaticamente pelo botão Detectar & Visualizar:

Adicionando uma fonte de feed

1. Abra a aba Feeds. Vá para /admin/import, selecione Feeds, depois Adicionar Fonte de Feed.
2. Insira a URL do feed. Deve começar com http:// ou https://. Clique em Detectar & Visualizar para detectar automaticamente o formato e visualizar as primeiras entradas.
3. Nomeie-a e confirme o tipo. Dê um nome à fonte e verifique o formato detectado (MRSS, RSS, CSV ou JSON) e o tipo de vídeo.
4. Escolha um modo. Embed para armazenar links do player, ou Download para baixar e transcodificar os arquivos.
5. Mapeie as colunas se necessário. MRSS e RSS se mapeiam sozinhos; para CSV/JSON, arraste cada coluna para o campo correspondente.
6. Defina o agendamento e as opções. Escolha um intervalo de atualização, a regra de duplicata, publicação automática e quantas páginas rastrear.
7. Salve. Use Buscar agora para importar imediatamente, ou deixe o agendamento rodar. Executar fila processa todos os itens pendentes sob demanda.

Mapeamento de campos

Os feeds normalizam as entradas nos mesmos campos canônicos usados pelo importador. Para MRSS/RSS isso é automático; para CSV/JSON você mapeia suas colunas em:

Agendamento & automação

Uma tarefa em segundo plano chamada feed_import é executada no pseudo-cron aproximadamente a cada 30 segundos — sem necessidade de crontab do sistema. Cada fonte é buscada apenas quando seu próprio intervalo tiver decorrido:

• Somente manual — nunca buscada automaticamente; use Buscar agora.
• A cada 15 minutos, a cada hora, a cada 6 horas ou a cada dia.

A mesma tarefa também esvazia a fila de importação — itens embed vários de uma vez, downloads um de cada vez para que um arquivo grande nunca bloqueie os demais. A configuração Máx. de páginas (1–50) limita o quanto um único fetch rastreia um feed paginado.

Deduplicação & filtros

A deduplicação é automática e funciona em dois níveis:

• Por fonte. O guid de cada item é lembrado, então uma nova busca coloca na fila apenas entradas genuinamente novas (itens já vistos são contados e ignorados).
• Em todo o seu site. No modo Download, o ID do item é armazenado no vídeo, então o mesmo clipe chegando de dois feeds não é baixado duas vezes.

A opção Em duplicata decide o que acontece quando um item já existe: Pular (recomendado) ou Atualizar existente.

Solução de problemas de feeds

• "Não foi possível reconhecer o formato do feed." A URL não retornou MRSS/RSS/CSV/JSON válido. Abra-a em um navegador e confirme que você vê o feed bruto, não uma página HTML.
• Itens presos como "importando". Eles se recuperam automaticamente após cerca de 30 minutos e são reprocessados; falhas temporárias são tentadas novamente até três vezes antes de serem marcadas como falhas.
• Itens com falha. Use Reprocessar para colocar novamente na fila tudo que falhou em uma fonte. Cada fonte mostra seu último status e mensagem.
• O modo Download falha. O Download precisa de uma URL de vídeo direta (não uma página de exibição); hosts privados ou internos são bloqueados, e há um limite de 5 GB por arquivo.
• Nada está sendo importado. Verifique se o agendamento não está em Somente manual, se a fonte está ativa, e se seu site está recebendo tráfego para acionar o cron.

Próximos passos