Gerador de JSON Feed v1.1

JSON Feed: a resposta nativa em JSON para RSS e Atom

O JSON Feed foi publicado em maio de 2017 por Brent Simmons (NetNewsWire) e Manton Reece (micro.blog) com uma motivação: para desenvolvedores, JSON é dramaticamente mais fácil de gerar e parsear que XML. A revisão atual é a versão 1.1 (jsonfeed.org/version/1.1), lançada em 2020, que adicionou language no nível raiz, um array authors e ajustes menores. O formato cobre a mesma superfície conceitual de RSS e Atom — uma lista de itens datados e endereçáveis — mas o formato no fio é um objeto JSON com chaves de string previsíveis em vez de elementos XML com namespaces.

Um feed válido mínimo é assim:

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Meu Feed",
  "home_page_url": "https://exemplo.com/",
  "feed_url": "https://exemplo.com/feed.json",
  "language": "pt-BR",
  "items": [
    {
      "id": "https://exemplo.com/post-1",
      "url": "https://exemplo.com/post-1",
      "title": "Primeiro post",
      "content_html": "<p>Olá</p>",
      "date_published": "2024-01-01T12:00:00Z"
    }
  ]
}

Por que o JSON Feed existe

Feeds XML carregam décadas de casos de borda acumulados: formatos de data incompatíveis (RFC 822 vs RFC 3339), seções CDATA, choques de namespace entre extensões e parsers que mastigam entidades silenciosamente. O JSON Feed escapa de tudo isso. Datas são sempre RFC 3339, texto sempre UTF-8, o id pode ser qualquer string única (em geral uma URL) e não existem namespaces — extensões ficam em chaves de nível raiz prefixadas com underscore (por exemplo _microblog).

Adoção e ferramentas

A adoção do JSON Feed é menor que RSS/Atom, mas constante. Suporte nativo: Inoreader, NetNewsWire, Reeder, micro.blog e várias bibliotecas de validação de feed. Geradores de site estático que emitem JSON Feed junto com RSS e Atom: Eleventy (pacote eleventy-plugin-rss), Hugo (via output format customizado) e Jekyll (plugin jekyll-feed). No ecossistema aberto de podcasts, JSON Feed não substitui nada — Apple Podcasts, Spotify e o resto exigem RSS 2.0 com o namespace itunes:.

JSON Feed vs RSS vs Atom

• Ergonomia: JSON Feed é, de longe, o mais fácil de gerar a partir de uma string templated ou de um JSON.stringify.
• Ecossistema: RSS domina podcasts e leitores legados; Atom é o spec mais rigoroso; JSON Feed tem a menor base de ferramentas, mas com apoio entusiasmado da comunidade dev.
• Extensibilidade: Atom usa namespaces XML; JSON Feed usa chaves de nível raiz com underscore (sem schema externo para consultar).
• Anexos binários: os três suportam enclosures (no JSON Feed, via array attachments em cada item).

Perguntas frequentes

JSON Feed substitui o RSS? Não, coexiste. A maioria dos sites que publica JSON Feed também publica RSS e Atom a partir do mesmo template. Substituir o RSS quebraria milhares de leitores legados e todo o ecossistema de podcasts.

JSON Feed é mais simples que RSS? Para desenvolvedores, sim — não há parsing de XML, não há namespaces e não há ambiguidade no formato de data. Para o usuário final é invisível: a assinatura no leitor é igual.

Posso usar JSON Feed para podcast? Não. Apple Podcasts e Spotify só aceitam RSS 2.0 com o namespace itunes:. Overcast, Pocket Casts e Castro também recusam qualquer outro formato.

Quais campos são obrigatórios na 1.1? Apenas version, title e items no nível raiz, mais id em cada item. Todo o resto (home_page_url, feed_url, authors, language) é recomendado, mas opcional.