Como Exportar Postagens do Mastodon como Texto Simples com Metadados

O Mastodon não inclui uma exportação nativa com um clique para postagens individuais como arquivos de texto simples. A exportação padrão de dados das configurações da conta gera um arquivo JSON difícil de ler sem ferramentas técnicas. Muitos usuários desejam uma cópia limpa em texto de suas postagens que preserve timestamps, configurações de visibilidade e contexto de respostas. Este artigo explica como extrair postagens do Mastodon como texto simples com metadados completos usando o recurso de exportação oficial e uma ferramenta de linha de comando gratuita.

Por que o Mastodon Exporta Postagens como JSON em Vez de Texto Simples

O Mastodon armazena cada postagem como um objeto estruturado em um banco de dados. A função de exportação em Preferências > Importar e exportar > Exportar dados empacota os dados da sua conta em um arquivo JSON. JSON é um formato legível por máquina que preserva todos os campos de dados: conteúdo da postagem, timestamp de criação, nível de visibilidade, anexos de mídia, menções, hashtags e relações de resposta. O formato não foi feito para leitura humana. Abrir um arquivo JSON em um editor de texto mostra dados aninhados brutos com colchetes, dois-pontos e aspas. Arquivos de texto simples, por outro lado, contêm apenas caracteres legíveis e quebras de linha. Para converter o arquivo JSON em texto simples, você precisa de uma ferramenta que analise a estrutura e escreva apenas os campos desejados.

A exportação oficial também inclui metadados de nível de conta, como nome do perfil, biografia e lista de seguidores. A exportação de postagens cobre todos os status, incluindo públicos, não listados, apenas para seguidores e mensagens diretas. O arquivo JSON não filtra por visibilidade. Qualquer ferramenta de conversão que você usar deve permitir escolher quais níveis de visibilidade incluir na saída. A maioria dos usuários deseja apenas postagens públicas e não listadas, excluindo mensagens diretas e postagens apenas para seguidores.

Passos para Exportar Postagens do Mastodon como Texto Simples com Metadados

Este método usa a exportação oficial de dados do Mastodon e um script Python chamado mastodon-archive-to-text. O script está disponível no GitHub e funciona em Windows, macOS e Linux.

Passo 1: Baixe seu Arquivo do Mastodon

1. Faça login na sua instância do Mastodon
   Abra a URL da sua instância em um navegador, por exemplo mastodon.social. Faça login com suas credenciais de conta.
2. Abra o menu Preferências
   Clique no ícone de engrenagem ou no avatar do seu perfil na barra lateral direita. Selecione Preferências no menu suspenso.
3. Navegue até Importar e exportar
   Na barra lateral de Preferências, clique em Importar e exportar na seção Administração.
4. Clique no botão Exportar dados
   Na página Exportar dados, clique no botão Exportar dados. Seu navegador baixa um arquivo chamado mastodon-export-aaaa-mm-dd.zip.
5. Extraia o arquivo ZIP
   Clique com o botão direito no arquivo ZIP baixado e escolha Extrair tudo no Windows ou clique duas vezes no macOS. Dentro você encontrará vários arquivos JSON. O arquivo outbox.json contém todas as suas postagens.

Passo 2: Instale o Python e o Script de Conversão

1. Instale o Python 3
   Acesse python.org e baixe o Python 3.10 ou posterior. Durante a instalação no Windows, marque a caixa Adicionar Python ao PATH. No macOS, o instalador adiciona o Python ao PATH automaticamente.
2. Abra um terminal ou prompt de comando
   No Windows, pressione a tecla Windows + R, digite cmd e pressione Enter. No macOS, abra Terminal em Aplicativos > Utilitários.
3. Baixe o script de conversão
   No terminal, execute o seguinte comando:
   git clone https://github.com/seuusuario/mastodon-archive-to-text.git
   Se o Git não estiver instalado, baixe o ZIP da página do GitHub e extraia manualmente. Substitua a URL pelo link real do repositório.
4. Navegue até a pasta do script
   Digite cd mastodon-archive-to-text e pressione Enter.
5. Instale as bibliotecas Python necessárias
   Execute pip install -r requirements.txt. O script precisa das bibliotecas json e datetime, que já vêm com o Python. Este passo garante que todas as dependências estejam presentes.

Passo 3: Execute a Conversão

1. Coloque o arquivo outbox.json na pasta do script
   Copie outbox.json do arquivo extraído para a pasta onde o script está localizado.
2. Execute o comando de conversão
   No terminal, digite:
   python convert.py outbox.json --output posts.txt --include public unlisted
   Substitua convert.py pelo nome exato do script. A flag --include filtra por visibilidade. Omita --include para exportar todas as postagens.
3. Abra o arquivo de saída
   O script cria um arquivo chamado posts.txt na mesma pasta. Abra-o com qualquer editor de texto. Cada postagem aparece como um bloco com cabeçalhos de metadados.

Passo 4: Verifique os Metadados na Saída

1. Verifique o formato do cabeçalho de metadados
   O script escreve um cabeçalho acima de cada postagem que inclui o timestamp no formato ISO 8601, a visibilidade, o ID da postagem e o ID da postagem respondida, se aplicável.
2. Revise o conteúdo da postagem
   O conteúdo em texto simples aparece abaixo do cabeçalho. Menções e hashtags permanecem como texto simples. URLs de anexos de mídia são listados em uma linha separada após o conteúdo.
3. Teste com uma pequena amostra primeiro
   Execute o script com o argumento --limit 5 para exportar apenas as primeiras cinco postagens. Verifique o formato de saída antes de exportar todo o arquivo.

O que Evitar ao Exportar Postagens do Mastodon

Usar a Função Imprimir do Navegador para Salvar Postagens

O recurso Imprimir para PDF ou Imprimir para texto do navegador captura apenas a visualização renderizada de uma única postagem na tela. Ele não inclui metadados como o horário exato de criação ou contexto de resposta. Para mais do que algumas postagens, este método é lento e propenso a erros. Use a exportação de arquivo e o script de conversão.

Esquecer de Filtrar Postagens Privadas

A exportação inclui mensagens diretas e postagens apenas para seguidores. Se você executar o script de conversão sem a flag --include, essas postagens privadas aparecerão no arquivo de texto simples. Para evitar vazar conteúdo privado, sempre especifique os níveis de visibilidade desejados. Use --include public unlisted para exportar apenas postagens não privadas.

Modificar o Arquivo JSON Manualmente

Editar o arquivo outbox.json com um editor de texto antes de executar o script pode quebrar a estrutura JSON. Mesmo uma vírgula ou aspas faltando faz com que o script falhe com um erro de análise. Se precisar remover postagens específicas, use as opções de filtro do script em vez de editar o arquivo JSON diretamente.

Métodos de Exportação do Mastodon: Arquivo JSON vs Script de Texto Simples

Item	Arquivo JSON Oficial	Texto Simples com Script
Formato de saída	JSON (legível por máquina)	Texto simples (legível por humanos)
Metadados incluídos	Todos os campos (timestamps, visibilidade, IDs, mídia, respostas)	Campos selecionados pelo usuário (timestamps, visibilidade, IDs, URLs de mídia)
Filtragem de privacidade	Nenhuma (todas as postagens exportadas)	Filtrar por visibilidade com a flag --include
Facilidade de uso	Um clique em Preferências	Requer Python e conhecimento de linha de comando
Exportação em lote	Sim, conta inteira	Sim, conta inteira após conversão

Agora você pode exportar suas postagens do Mastodon como arquivos de texto simples que incluem timestamps, visibilidade e metadados de resposta. Comece baixando seu arquivo em Preferências > Importar e exportar > Exportar dados. Em seguida, execute o script de conversão Python para produzir um arquivo .txt legível. Para um teste rápido, use o argumento --limit 5 para verificar o formato de saída. Se precisar incluir URLs de mídia nos metadados, consulte a documentação do script para a flag --include-media. Este método oferece um backup permanente e pesquisável de suas postagens fora da plataforma Mastodon.