Exportar Lista de Silenciados do Mastodon: Como Fazer Backup Sem a Interface de Configurações

Você quer exportar sua lista de silenciados do Mastodon, mas a interface de Configurações não tem o botão de exportação, ou você não consegue acessar a interface web. Isso acontece porque a API do Mastodon ainda expõe os dados de silenciamento mesmo quando o front-end oculta a opção de exportação específica para silenciados. Este artigo mostra como recuperar sua lista de silenciados usando a API do Mastodon diretamente do terminal ou do navegador, sem precisar da interface de Configurações.

O Mastodon armazena registros de silenciamento por conta e os disponibiliza através do endpoint da API /api/v1/mutes. A interface web não fornece um botão de exportação dedicado para silenciados, mas a API retorna a lista completa em formato JSON. Você pode salvar essa saída em um arquivo para backup ou migração.

Você aprenderá dois métodos: usando uma simples requisição no navegador enquanto está logado no Mastodon, e usando a ferramenta de linha de comando toot para scripts automatizados. Ambos os métodos funcionam no Windows, macOS e Linux.

Por que o Mastodon Oculta a Exportação de Silenciados nas Configurações

A interface de Configurações do Mastodon em Preferências > Importar e Exportar > Exportar fornece downloads CSV para seguindo, bloqueios, bloqueios de domínio e favoritos. Silenciados não estão incluídos nessa lista. A equipe de desenvolvimento do Mastodon não adicionou um botão de exportação dedicado para silenciados na interface web, provavelmente porque listas de silenciados são menos necessárias para migração do que seguidores ou bloqueios.

A API, no entanto, trata silenciados da mesma forma que outras listas. O endpoint /api/v1/mutes retorna um array JSON paginado de objetos de conta. Cada objeto contém o ID da conta, nome de usuário, nome de exibição e outros metadados. Esses dados estão disponíveis para qualquer cliente autenticado que possua um token de acesso válido com o escopo read:mutes.

O que a Resposta da API Contém

A saída JSON do endpoint de silenciados inclui para cada conta silenciada:

• id – o ID numérico da conta na instância
• username – o nome de usuário da conta (sem @)
• acct – o handle completo (username@instância para contas remotas)
• display_name – o nome de exibição do usuário
• url – a URL do perfil
• avatar – URL da imagem do avatar

Esses dados são suficientes para reconstruir a lista de silenciados em outra instância ou arquivá-la localmente.

Método 1: Exportar Silenciados Usando as Ferramentas do Desenvolvedor do Navegador

Este método funciona em qualquer navegador moderno (Chrome, Edge, Firefox, Brave). Você não precisa instalar nenhum software. Basta estar logado na sua instância do Mastodon no navegador.

1. Abra sua instância do Mastodon e faça login
   Navegue até a página inicial da sua instância e certifique-se de que está logado com a conta cujos silenciados deseja exportar.
2. Navegue até a página de Usuários Silenciados
   Vá para Preferências > Privacidade e alcance > Usuários silenciados. Esta página lista todas as contas que você silenciou. O navegador enviará requisições à API para carregar esta lista.
3. Abra as Ferramentas do Desenvolvedor
   Pressione Ctrl+Shift+I no Windows ou Cmd+Option+I no macOS. Clique na aba Network. Certifique-se de que o botão de gravação (círculo vermelho) está ativo.
4. Atualize a página de Usuários Silenciados
   Pressione F5 ou clique no botão de recarregar do navegador. A aba Network capturará todas as requisições que a página fizer.
5. Encontre a requisição da API de silenciados
   Na aba Network, digite mutes no campo de filtro. Procure por uma requisição com nome como mutes e status 200. Clique nela.
6. Copie a resposta JSON
   Clique na aba Response dentro do painel de detalhes da requisição. Você verá o array JSON das contas silenciadas. Selecione todo o texto (Ctrl+A), copie (Ctrl+C) e cole em um arquivo de texto. Salve o arquivo como mastodon-mutes.json.

Se você tiver muitos silenciados, a API pode retornar resultados paginados. Verifique a aba Headers por um cabeçalho Link que aponte para a próxima página. Você pode clicar nessa URL em uma nova aba do navegador para obter o próximo lote e repetir o processo de cópia.

Método 2: Exportar Silenciados Usando a Ferramenta de Linha de Comando Toot

A ferramenta toot é um cliente CLI do Mastodon baseado em Python. Funciona no Windows, macOS e Linux. Este método é ideal para scripts e automação, pois você pode redirecionar a saída diretamente para um arquivo.

1. Instale o toot
   Abra um terminal e execute pip install toot. No Windows, use o Prompt de Comando ou PowerShell como administrador. No macOS ou Linux, talvez seja necessário usar pip3 em vez de pip.
2. Autentique o toot com sua conta do Mastodon
   Execute toot login. Siga as instruções: digite a URL da sua instância (por exemplo, https://mastodon.social), depois abra a URL fornecida no navegador, autorize o aplicativo e copie o código de autorização de volta para o terminal.
3. Exporte a lista de silenciados para um arquivo
   Execute o comando toot mutes > mastodon-mutes.txt. Isso salva a lista de silenciados em formato de texto simples. Cada linha mostra o handle completo da conta silenciada.
4. Exporte como JSON para uso programático
   Se precisar dos dados JSON estruturados, execute toot mutes --json > mastodon-mutes.json. A flag --json gera a resposta bruta da API.

O comando toot mutes lida automaticamente com a paginação. Ele busca todas as páginas e combina os resultados em uma única saída.

Problemas Comuns ao Exportar Silenciados Sem a Interface de Configurações

A API Retorna um Array Vazio

Se a API retornar [], você não tem contas silenciadas. Verifique a página de Usuários Silenciados nas Configurações para confirmar. Se você vir contas silenciadas lá, mas a API retornar vazio, pode estar usando um token de acesso com escopos insuficientes. Regere o token com o escopo read:mutes.

As Ferramentas do Desenvolvedor Não Mostram Requisição de Mutes

Algumas instâncias do Mastodon carregam a lista de silenciados usando JavaScript do lado do cliente que não dispara uma requisição de rede separada. Nesse caso, use o método toot. Alternativamente, tente usar a API do Mastodon diretamente digitando https://suainstancia.com/api/v1/mutes na barra de endereços do navegador enquanto estiver logado. O navegador exibirá a resposta JSON.

Resultados Paginados Estão Faltando Contas

A API do Mastodon retorna no máximo 40 registros por página. Se você tiver mais de 40 silenciados, a resposta inclui um cabeçalho Link com a URL da próxima página. Ao usar o método do navegador, siga manualmente essa URL para cada página. A ferramenta toot lida com isso automaticamente.

Ferramentas do Desenvolvedor vs Toot CLI: Métodos de Exportação Comparados

Item	Ferramentas do Desenvolvedor	Toot CLI
Instalação necessária	Nenhuma	Python e pip
Tratamento de paginação	Manual	Automático
Formato de saída	Apenas JSON	Texto simples ou JSON
Melhor para	Exportação única	Backups recorrentes e scripts
Suporte a plataformas	Todos os navegadores	Windows, macOS, Linux

Agora você tem dois métodos confiáveis para exportar sua lista de silenciados do Mastodon sem depender da interface de Configurações. O método das ferramentas do desenvolvedor do navegador funciona instantaneamente para um backup único. O método CLI do toot é melhor para exportações automatizadas e recorrentes. Após exportar, armazene o arquivo JSON com segurança e considere importá-lo para uma nova instância usando o endpoint da API /api/v1/mutes com uma requisição POST. Para usuários avançados, combine a exportação com um cron job ou agendador de tarefas para executar toot mutes --json semanalmente e sobrescrever seu arquivo de backup.