Como Exportar a Lista de Bloqueios do Mastodon com Paginação

Quando você bloqueia um grande número de contas no Mastodon, sua lista de bloqueios pode se estender por várias páginas. A ferramenta de exportação padrão do Mastodon exporta apenas a primeira página da sua lista de bloqueios. Isso significa que você pode perder entradas ao tentar migrar seus bloqueios para outra instância ou criar um backup. Este artigo explica como exportar sua lista completa de bloqueios do Mastodon, incluindo todas as páginas, usando as ferramentas do desenvolvedor do navegador. Você aprenderá as etapas exatas para capturar todas as contas bloqueadas sem perder nenhuma entrada.

Por que a Exportação da Lista de Bloqueios do Mastodon Mostra Apenas Uma Página

O Mastodon usa paginação para todas as listas que podem conter muitos itens. A lista de bloqueios não é exceção. Quando você usa a ferramenta de exportação padrão em Preferências > Importar e Exportar > Exportar, o Mastodon gera um arquivo CSV. Esse arquivo CSV contém apenas as primeiras 80 contas bloqueadas por padrão. A ferramenta de exportação não percorre automaticamente toda a lista. Esta é uma limitação da interface de usuário atual do Mastodon, não um bug.

O endpoint da API que serve a lista de bloqueios é /api/v1/blocks. Por padrão, ele retorna 40 itens por página. Você pode aumentar para no máximo 80 itens por página usando o parâmetro limit. Para obter a próxima página, você deve enviar o parâmetro max_id, que é o ID da última conta na página atual. A ferramenta de exportação padrão não lida com essa lógica de paginação. Para exportar todas as contas bloqueadas, você deve escrever um script que percorra as páginas ou capturar manualmente cada página usando as ferramentas do desenvolvedor do navegador.

Passos para Exportar Sua Lista Completa de Bloqueios do Mastodon

O método abaixo usa as ferramentas do desenvolvedor do navegador para capturar a resposta bruta da API para cada página da sua lista de bloqueios. Esta abordagem funciona em qualquer instância do Mastodon e não requer software adicional. Você precisará de um editor de texto para combinar os resultados em um único arquivo CSV.

1. Abra a página de bloqueios do Mastodon no seu navegador
   Navegue até Preferências > Moderação > Bloqueios. Esta página mostra suas contas bloqueadas. Role até o final da página para ver os botões de paginação.
2. Abra as Ferramentas do Desenvolvedor e vá para a aba Network
   Pressione F12 no Windows ou Cmd+Option+I no Mac. Clique na aba Network. Marque a caixa que diz “Preservar log” para que o log permaneça mesmo após recarregar a página.
3. Recarregue a página de bloqueios
   Pressione F5 para recarregar a página. Na aba Network, você verá muitas requisições. Procure por uma requisição que contenha api/v1/blocks no nome. Clique nessa requisição.
4. Veja a aba Response da requisição da API
   No painel direito, clique na aba Response. Você verá um array JSON de contas bloqueadas. Cada objeto contém os campos id, acct e display_name. Copie toda a resposta JSON e cole em um editor de texto. Salve como blocks_page1.json.
5. Encontre o max_id para a próxima página
   Na mesma requisição da API, clique na aba Headers. Procure pela URL da requisição. Ela será algo como https://suainstancia.social/api/v1/blocks?limit=80. Se a resposta incluir um cabeçalho Link, procure pelo parâmetro max_id nesse cabeçalho. Se não houver cabeçalho Link, encontre o último valor de id na resposta JSON que você copiou. Esse ID é o seu max_id para a próxima página.
6. Construa a URL para a próxima página
   Em uma nova aba do navegador, digite a seguinte URL, substituindo suainstancia.social e valor_max_id pelo domínio da sua instância e o max_id encontrado:
   https://suainstancia.social/api/v1/blocks?limit=80&max_id=valor_max_id. Pressione Enter.
7. Capture a resposta da próxima página
   O navegador exibirá a resposta JSON bruta para a próxima página. Copie esse JSON e salve como blocks_page2.json. Repita os passos 5 a 7 até que a API retorne um array vazio []. Isso significa que você chegou à última página.
8. Combine todos os arquivos JSON em um único CSV
   Abra cada arquivo JSON. Cada arquivo contém um array de objetos. Extraia o campo acct de cada objeto. No Mastodon, o campo acct é o identificador da conta (por exemplo, @usuario@instancia.social). Crie um único arquivo CSV com uma linha de cabeçalho account e uma linha por conta bloqueada. Salve o arquivo como full_blocks.csv.
9. Importe o CSV para outra instância do Mastodon
   Na sua nova instância, vá para Preferências > Importar e Exportar > Importar. Em “Tipo de importação”, selecione “Bloqueio”. Envie seu arquivo full_blocks.csv. Clique em Enviar. O Mastodon processará a importação e bloqueará todas as contas na lista.

O que Evitar ao Exportar Bloqueios com Paginação

Usar a Ferramenta de Exportação Padrão para Listas Grandes de Bloqueios

A ferramenta de exportação padrão em Preferências > Importar e Exportar > Exportar > blocks.csv exporta apenas as primeiras 80 entradas. Se você tiver mais de 80 contas bloqueadas, este arquivo está incompleto. Não confie nesta exportação para backups completos ou migrações. Sempre verifique o número de linhas no CSV em comparação com o número mostrado na sua página de bloqueios.

Copiar Manualmente da Interface Web

Copiar nomes de conta um por um da página de bloqueios é propenso a erros e demorado. A interface web mostra apenas 40 contas por página por padrão. Se você tiver centenas de contas bloqueadas, a cópia manual levará muito tempo e você pode perder entradas. Use o método da API descrito acima.

Não Verificar o Cabeçalho Link

Algumas instâncias do Mastodon incluem um cabeçalho Link na resposta da API que contém a URL para a próxima página. Se você ignorar este cabeçalho e adivinhar manualmente o max_id, pode pular páginas. Sempre verifique a aba Headers nas Ferramentas do Desenvolvedor primeiro para o cabeçalho Link. Se existir, use o max_id desse cabeçalho em vez do último ID na resposta.

Importar Entradas Duplicadas

Se você acidentalmente exportar a mesma página duas vezes, seu CSV conterá identificadores de conta duplicados. O Mastodon lida com duplicatas durante a importação pulando-as, mas isso desperdiça tempo de processamento. Remova duplicatas antes de importar. Você pode fazer isso em uma planilha selecionando a coluna de conta e usando o recurso Remover Duplicatas.

Paginação Manual vs Script Automatizado: Métodos de Exportação Comparados

Item	Paginação Manual (Ferramentas do Desenvolvedor)	Script Automatizado (Python, curl)
Tempo de configuração	Nenhuma instalação necessária, funciona em qualquer navegador	Requer Python ou curl instalado e configurado
Esforço para 100+ bloqueios	Repetir passos para cada página, 5-10 minutos	Execução única do script, menos de 1 minuto
Risco de erro	Maior se você pular uma página ou copiar dados errados	Menor se o script lidar corretamente com a paginação
Token de acesso necessário	Não, usa sua sessão existente do navegador	Sim, requer criar um token de acesso da API do Mastodon

Este artigo explicou como exportar sua lista completa de bloqueios do Mastodon usando paginação manual com as ferramentas do desenvolvedor do navegador. Agora você sabe como capturar cada página da resposta da API e combinar os resultados em um arquivo CSV completo. Para usuários com mais de 500 contas bloqueadas, considere escrever um pequeno script que use a API do Mastodon com um token de acesso para automatizar o processo. O detalhe chave a lembrar é que o parâmetro max_id controla a paginação e a exportação padrão fornece apenas as primeiras 80 entradas.