Como exportar listas do Mastodon e recriá-las em uma nova instância

Ao migrar sua conta do Mastodon para uma nova instância, sua lista de seguidores não é a única coisa que precisa ser transferida. As listas que você organizou cuidadosamente para filtrar postagens de diferentes comunidades ou tópicos não são transferidas automaticamente. A API do Mastodon não inclui uma exportação nativa para listas, então você precisa usar um processo manual para salvá-las e recriá-las. Este artigo explica como exportar suas listas existentes do Mastodon usando uma ferramenta do navegador e depois recriá-las na sua nova instância.

Por que as listas do Mastodon não são transferidas durante a migração de conta

A migração de conta do Mastodon move seus seguidores, seguidos e algumas configurações de perfil. As listas são armazenadas localmente no banco de dados da instância e não são incluídas na exportação ou migração padrão. A ferramenta de exportação oficial do Mastodon gera um arquivo CSV dos seus seguidos, mas não exporta a estrutura das listas nem a associação de cada lista. Para preservar suas listas, você precisa capturar os dados manualmente antes de sair da sua instância antiga.

Cada lista no Mastodon tem um ID numérico único atribuído pela instância. As contas em uma lista são associadas a esse ID. Quando você migra para uma nova instância, esses IDs não existem no novo servidor. Você precisa criar novas listas e adicionar as mesmas contas a elas. O processo envolve três etapas: exportar os nomes das listas, exportar as contas de cada lista e recriar tudo na nova instância.

Passos para exportar nomes de listas e membros da sua instância antiga

Passo 1: Abra a interface web do Mastodon e faça login na sua instância antiga

1. Abra sua instância antiga do Mastodon em um navegador
   Use Chrome, Firefox ou Edge. Faça login com sua conta atual do Mastodon.
2. Pressione F12 para abrir as Ferramentas do Desenvolvedor
   Clique na guia Network no painel das Ferramentas do Desenvolvedor. Certifique-se de que o botão de gravação está vermelho e ativo.
3. Filtre as requisições de rede
   Na caixa de filtro, digite api/v1/lists. Isso mostrará apenas requisições relacionadas a listas.
4. Navegue até a página de listas
   Na interface do Mastodon, clique no ícone de Listas na barra lateral esquerda. Isso dispara uma requisição GET para /api/v1/lists.
5. Clique na requisição na guia Network
   Selecione a requisição chamada lists. No painel direito, clique na guia Response. Você verá um array JSON contendo todas as suas listas com seus id e title.
6. Copie a resposta JSON
   Selecione todo o texto da resposta e copie para um arquivo de texto. Salve como mastodon-lists.json.

Passo 2: Exporte as contas de cada lista

1. Limpe o log de rede
   Clique no botão de limpar na guia Network para remover entradas anteriores.
2. Clique no nome de uma lista na interface do Mastodon
   Isso abre a visualização detalhada da lista e dispara uma requisição GET para /api/v1/lists/{id}/accounts.
3. Encontre a requisição de contas na guia Network
   Procure por uma requisição chamada accounts com o ID da lista na URL. Clique nela e veja a guia Response.
4. Copie o array JSON de contas
   Cada objeto de conta contém id, username e acct. O campo acct mostra o handle completo (ex.: @user@instance.social). Copie esses dados e salve com um nome de arquivo que corresponda ao nome da lista, como list-tech-accounts.json.
5. Repita para cada lista
   Percorra cada lista na sua interface do Mastodon e salve o JSON de contas separadamente. Essa etapa é essencial porque a API não retorna todas as listas de uma vez.

Passos para recriar listas na nova instância

Passo 1: Crie a estrutura de listas na nova instância

1. Faça login na sua nova instância do Mastodon
   Abra a interface web e entre com sua conta migrada.
2. Clique no ícone de Listas na barra lateral esquerda
   Se você ainda não tem listas, a página mostrará um estado vazio.
3. Clique no botão Criar lista
   Digite o mesmo título exato que você usou na instância antiga. O Mastodon permite títulos de lista duplicados, mas mantê-los idênticos ajuda na organização.
4. Repita para cada lista do seu arquivo JSON
   Crie todas as listas antes de adicionar membros. Isso torna o próximo passo mais rápido.

Passo 2: Adicione contas a cada lista

1. Abra a primeira lista que você criou
   Clique no nome da lista na barra lateral para abrir sua visualização detalhada.
2. Clique no botão Editar lista
   Isso mostra uma caixa de busca onde você pode digitar handles de contas.
3. Digite o handle completo da primeira conta do seu JSON salvo
   Use o campo acct exatamente como aparece, por exemplo @user@instance.social. O Mastodon mostrará contas correspondentes enquanto você digita.
4. Clique no nome da conta para adicioná-la
   A conta aparece na lista de membros abaixo da caixa de busca.
5. Repita para cada conta no arquivo JSON desta lista
   Trabalhe nas contas uma por uma. Esta é a parte mais demorada do processo.
6. Mude para a próxima lista e repita
   Abra cada lista, clique em Editar lista e adicione seus membros usando os dados JSON salvos.

O que fazer se contas estiverem ausentes ou não forem encontradas

Contas que não existem mais

Se um handle de conta da sua lista antiga não retornar resultados na nova instância, essa conta pode ter sido excluída ou movida. O Mastodon não mantém contas excluídas em seu índice de busca. Você pode pular essas contas ou procurá-las pelo handle atual se elas se mudaram para uma instância diferente.

Contas privadas ou suspensas

Algumas contas podem ser privadas ou suspensas na nova instância. Se a conta for privada e você não a seguir, o Mastodon não a mostrará nos resultados da busca. Você precisa seguir a conta primeiro e depois adicioná-la à lista.

Listas grandes com muitos membros

Se uma lista tiver mais de 50 membros, o processo de adição manual pode levar muito tempo. Considere usar uma ferramenta de automação de navegador, como um snippet JavaScript simples no console, para adicionar contas em massa. No entanto, o Mastodon limita a taxa de requisições da API, então você deve adicionar contas lentamente para evitar ser bloqueado temporariamente.

Métodos de exportação de listas do Mastodon: manual vs ferramentas de terceiros

Item	Exportação manual via Ferramentas do Desenvolvedor	Ferramentas de terceiros (ex.: extensões de exportação de listas do Mastodon)
Dados capturados	Nomes das listas e handles completos das contas	Nomes das listas e handles das contas, às vezes com status de seguimento
Requer conhecimento das DevTools do navegador	Sim, compreensão básica da guia Network	Não, geralmente um botão de um clique
Funciona em todas as instâncias do Mastodon	Sim, porque usa a API oficial	Depende da compatibilidade da ferramenta com a versão da sua instância
Risco de perda de dados	Baixo, você controla o processo de cópia	Médio, a ferramenta pode perder algumas contas se a paginação não for tratada
Tempo necessário para exportação	5–10 minutos para 5 listas	1–2 minutos

Agora você pode exportar suas listas do Mastodon de qualquer instância e recriá-las em uma nova usando o método manual descrito aqui. O processo requer apenas um navegador e alguns minutos de trabalho por lista. Para migrações futuras, mantenha seus arquivos JSON armazenados em segurança para que você possa reutilizá-los. Se você tiver muitas listas, considere usar uma extensão de navegador de terceiros que automatize a etapa de exportação, mas sempre verifique a saída antes de excluir sua conta antiga.