Todos os artigos

Como converter um arquivo MBOX para CSV (endereços de e-mail, nomes e contagens)

··3 min de leitura

Para converter um arquivo MBOX para CSV, abra-o na ferramenta MBOX para CSV. Ela lê só os cabeçalhos das mensagens, no seu navegador, e lista cada endereço From, To e Cc com o nome mais usado, em quantas mensagens ele aparece e quando apareceu pela primeira e pela última vez, pronto para baixar como CSV. Nada é enviado.

Converta um arquivo MBOX para CSV →

Converta com a ferramenta

  1. Exporte o seu e-mail como .mbox: Google Takeout para o Gmail (escolha Mail), o complemento ImportExportTools NG no Thunderbird, ou Mailbox › Export Mailbox (Caixa de correio › Exportar caixa de correio) no Apple Mail. Descompacte primeiro o download do Takeout.
  2. Abra a ferramenta MBOX para CSV e escolha o arquivo .mbox. Vários arquivos ou mensagens .eml avulsas também funcionam.
  3. Adicione os seus próprios endereços para que fiquem de fora.
  4. Clique em Extract addresses (extrair endereços). Uma exportação de vários gigabytes é lida em partes, com um contador de progresso.
  5. Filtre os remetentes no-reply, ou fique só com as pessoas para quem você escreveu, e baixe o CSV com nomes, contagens e datas de primeira e última aparição.

Converta com um script

Isto usa só a biblioteca padrão do Python. Ele decodifica nomes codificados como =?UTF-8?Q?Ren=C3=A9?= e conta quantas vezes cada endereço aparece em From, To e Cc:

import csv, mailbox, sys
from collections import Counter
from email.header import decode_header, make_header
from email.utils import getaddresses

counts, names = Counter(), {}
for msg in mailbox.mbox(sys.argv[1]):
    fields = [str(make_header(decode_header(v))) for h in ("From", "To", "Cc") for v in msg.get_all(h, [])]
    for name, addr in getaddresses(fields):
        addr = addr.strip().lower()
        if "@" in addr:
            counts[addr] += 1
            names.setdefault(addr, name)

with open("addresses.csv", "w", newline="") as f:
    w = csv.writer(f)
    w.writerow(["email", "name", "messages"])
    for addr, n in counts.most_common():
        w.writerow([addr, names[addr], n])

Salve como mbox2csv.py e rode python3 mbox2csv.py your-export.mbox. Ele lê cada mensagem, então uma exportação grande demora um pouco.

Para uma lista rápida só com endereços, o grep funciona, mas perde cabeçalhos quebrados em uma segunda linha e não decodifica nomes:

grep -E -i "^(From|To|Cc):" export.mbox \
  | grep -E -o "[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}" \
  | tr 'A-Z' 'a-z' | sort | uniq -c | sort -rn > addresses.txt

Antes de usar o CSV

  • Remova os seus próprios endereços e os remetentes automáticos (no-reply, notificações, mailer-daemon).
  • Permissão: ter trocado e-mails com alguém não é consentimento para marketing. Veja GDPR e cold email B2B.
  • Idade: endereços de conversas de anos atrás dão mais bounce. Veja enviar para uma lista de e-mails antiga.

A página de ajuda do Takeout do Google (lida em 8 de novembro de 2026) também observa que "each message's labels are preserved in a special X-Gmail-Labels header in your download file" (os marcadores de cada mensagem são preservados em um cabeçalho especial X-Gmail-Labels no arquivo baixado), que você pode ler com msg["X-Gmail-Labels"] no script se quiser filtrar por marcador.

Próximo passo: verifique os endereços

Envie o CSV em /verify. Cada endereço recebe uma checagem de caixa postal ao vivo sem enviar mensagem, e você pode exportar separadamente as linhas válidas, arriscadas e inválidas. As primeiras 100 checagens são grátis com login do Google, sem cartão.

Pro, US$ 39 por mês: verificação de e-mails ilimitada.* Nunca medida, nunca cortada. Veja os preços.

*Uso justo: as primeiras 100.000 verificações do mês em velocidade máxima, depois mais devagar, nunca cortado.

Leia também: exportar do Gmail os endereços para os quais você enviou e-mail, remover e-mails duplicados.

Perguntas frequentes

Como converto um arquivo MBOX para CSV?

Abra o arquivo .mbox na ferramenta MBOX para CSV, adicione os seus próprios endereços para que fiquem de fora, clique em Extract addresses e baixe o CSV. Ela roda no seu navegador, então o arquivo não é enviado.

O conversor lê o conteúdo dos e-mails?

Não. Ele lê só os cabeçalhos das mensagens (From, To, Cc e datas) para montar a lista de endereços.

Ele aguenta uma exportação grande do Gmail?

Sim. Uma exportação de vários gigabytes é lida em partes, com um contador de progresso. Descompacte primeiro o download do Takeout.

Posso converter MBOX para CSV com um script?

Sim. O script em Python deste post usa só a biblioteca padrão (mailbox, email.header, email.utils, csv) e grava e-mail, nome e número de mensagens.

Verifique e-mails por USD 39,00/mês, sem bloqueio

Checagem SMTP real da caixa postal. Sem créditos e sem cobrança por e-mail.

Começar agora

Leia o original em inglês