Publicar um feed RSS ou Atom no Bluesky
Pré-visualize novas entradas antes de publicar. Este tutorial oferece um importador RSS/Atom reutilizável e uma fila local, com passos explícitos de envio e recuperação.
Por A equipa do Bluesky.bot
- Publicado:
- Atualizado:
- Revisto:
O que vai construir
Transforme novos artigos de um feed RSS 2.0 ou Atom 1.0 numa pequena fila de publicações no Bluesky. Comece pela pré-visualização, registe o histórico existente sem o publicar e só depois ative o envio. É RSS para Bluesky, não um feed personalizado do Bluesky nem uma forma de ler uma conta num leitor RSS.
Precisa de Python 3.11 ou posterior, disco local persistente, uma conta que controle e autorização para redistribuir os links do feed. O exemplo publica texto e um link. Imagens, respostas, menções, URLs relativos e títulos HTML complexos exigem outra implementação. O Bluesky.bot fornece o guia e os ficheiros; o programa é executado na sua máquina.
1. Transferir e testar o kit reutilizável
Transfira as receitas com licença MIT e extraia-as para uma pasta nova. Incluem fila, importador, exemplos RSS/Atom e testes locais. Não contêm credenciais nem workflows ativados.
tar -xzf bluesky-bot-recipes.tar.gz
cd bluesky-bot-recipes
python3 -m unittest -v test_recipes.pyOs testes simulam publicação e recuperação. Não demonstram um envio autenticado na sua conta. A pré-visualização funciona sem instalar o SDK do Bluesky.
2. Registar o histórico inicial sem o publicar
Inicialize o RSS de exemplo e pré-visualize o documento Atom com uma entrada nova:
python3 rss_to_queue.py sample-rss.xml --feed-id my-blog --db .state/rss.sqlite3 --baseline
python3 rss_to_queue.py sample-atom.xml --feed-id my-blog --db .state/rss.sqlite3O primeiro comando regista duas identidades sem criar publicações. O segundo prepara uma entrada Atom e escolhe o link do artigo, não o anexo áudio. Um GUID ou ID Atom é opaco: não tem de ser um URL.
No feed real, transfira o XML para feed.xml e inicialize uma única vez, numa base separada. Escolha um --feed-id estável. Repetir a inicialização em cada consulta ocultaria as novidades.
curl --fail --location --max-time 20 --max-filesize 5242880 "https://example.org/feed.xml" --output feed.xml
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --baselineSubstitua o endereço pelo do seu feed. O importador lê XML local, sem iniciar sessão. Limite a transferência e use um feed de confiança.
3. Pré-visualizar e colocar novidades na fila
Depois de uma alteração, transfira o XML novamente e inspecione a pré-visualização:
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --enqueue
python3 posting_queue.py --db .state/live.sqlite3 run--enqueue grava uma tarefa pendente e a identidade da entrada na mesma transação. Ainda não publica. Reimportar a mesma entrada mantém uma só tarefa. run sem opções mostra os textos vencidos sem alterar o estado de entrega.
Comece com uma entrada por execução. --limit 5 é um limite máximo, não uma frequência recomendada. Num feed normalmente ordenado do mais recente para o mais antigo, o lote começa na entrada desconhecida mais antiga ainda presente; não é uma garantia geral de ordem cronológica. Consulte o feed antes de os artigos desaparecerem.
São ignorados títulos ou links em falta, links que não sejam HTTP(S) absolutos e textos acima do limite conservador de 300 pontos de código. Encurte o título deliberadamente, sem cortar o URL. O analisador aceita até 5 MiB e rejeita DTD, entidades e bytes NUL. Não transfere artigos completos nem produz imagens.
As datas do feed (pubDate, published e updated) não agendam envios neste kit. As entradas novas válidas recebem a hora de observação. Para um embargo ou data futura, prepare uma tarefa com data explícita seguindo o tutorial de agendamento.
4. Ligar o seu bot e verificar uma publicação
Siga o guia de palavras-passe de aplicação. Use uma credencial dedicada ao bot, não a palavra-passe principal. Um serviço que liga contas de outras pessoas deve utilizar OAuth.
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txtDefina BLUESKY_HANDLE e BLUESKY_APP_PASSWORD no ambiente local ou num ficheiro protegido. Se a conta não estiver alojada em bsky.social, indique o PDS HTTPS atual em BLUESKY_SERVICE. Não guarde segredos no feed, na fila JSON, no Git, em capturas ou no histórico do terminal.
python3 posting_queue.py --db .state/live.sqlite3 run --publish
python3 posting_queue.py --db .state/live.sqlite3 status--publish abre uma sessão e tenta enviar uma tarefa vencida. Uma resposta confirmada fica em sent com o URI at://. Verifique a publicação e o link no Bluesky antes de automatizar. A base fica associada ao DID do bot; use uma base por conta.
5. Conservar o estado e rever envios incertos
O tutorial completo de agendamento explica persistência, cron, fusos horários, cancelamento e reinício. Um ambiente CI novo não conserva automaticamente o estado anterior.
A fila confirma publishing antes da chamada de rede. Outro worker não reserva a mesma tarefa. Uma exceção ou resposta perdida passa a review; uma interrupção pode deixar publishing. Não há repetição automática: o servidor pode ter aceite a publicação antes de a resposta se perder. A chave do registo mantém-se para uma eventual tentativa explícita.
python3 posting_queue.py --db .state/live.sqlite3 status
python3 posting_queue.py --db .state/live.sqlite3 cancel JOB_IDSó é possível cancelar uma tarefa pending. Para review ou publishing, pare o worker e consulte o registo público na chave de status com o explorador de repositórios. Confirme o conteúdo antes de resolver o estado. Se não souber o resultado, mantenha a revisão. O README descreve os comandos; o kit não garante entrega exatamente uma vez após perda da base.
Diagnóstico e verificações de lançamento
- Sem tarefas: confirme inicialização única, ID do feed, base persistente, XML atualizado e links de artigos.
- Artigo repetido: verifique se o editor muda o GUID em cada correção. Mudar identidades ou apagar a base invalida o acompanhamento.
- Artigo em falta: leia os avisos e confirme se já tinha saído do feed antes da consulta. Um feed não é um histórico completo.
- Falha de autenticação: confirme conta, credencial e PDS. O primeiro bot em Python explica o SDK.
- Limite ou resposta incerta: pare, consulte o estado e respeite as indicações do servidor. Não force novas tentativas com IDs novos ou sucessivos inícios de sessão.
Antes de deixar o bot autónomo: registe o histórico, pré-visualize uma novidade, publique um teste deliberado, confira o link, faça cópia de segurança e simule um reinício. Identifique a automatização e siga as boas práticas. Cite os autores originais; um URL RSS não autoriza copiar artigos inteiros.
Pode reutilizar código, exemplos e testes sob MIT, sem backlink obrigatório. Citações voluntárias são bem-vindas; disponibilizar um recurso não garante links, posições ou tráfego.