O ciclo
Cinco passos, e o agente executa-os a todos sem precisar de orientação em cada um.
Obter um endereço
Uma chamada reserva um endereço de utilização única e indica ao agente em que idioma deve escrever o plano de correção. O endereço aceita exatamente uma mensagem e expira ao fim de uma hora.
Enviar-lhe a mensagem real
Não um resumo, nem uma versão abreviada. Metade das verificações lê cabeçalhos adicionados pela plataforma de envio, e um corpo de mensagem colado não inclui nenhum deles.
Esperar
Uma chamada bloqueante. Devolve o resultado quando a análise estiver concluída, pelo que o agente não tem de fazer consultas periódicas nem corre o risco de configurar incorretamente um ciclo de espera.
Corrigir o que identifica
Cada resultado inclui a secção da RFC e a página da documentação da Google que o fundamentam, para que o agente possa verificar a afirmação em vez de confiar nela.
Enviar novamente
Um novo endereço, a mensagem corrigida, uma segunda pontuação para comparar com a primeira. Os ganhos esperados são calculados através de uma nova avaliação, mas não são cumulativos, e o segundo relatório apresenta o valor real.
Configurar
O servidor MCP requer uma linha no Claude Code:
claude mcp add --transport http email-spam-tester https://email-spam-tester.com/mcp
Ou, para um cliente que aceite JSON:
{
"mcpServers": {
"email-spam-tester": {
"type": "http",
"url": "https://email-spam-tester.com/mcp"
}
}
}
São incluídas quatro ferramentas: reservar um endereço, aguardar pelo relatório, ler um relatório existente através do respetivo slug e obter a origem da mensagem exatamente como foi entregue.
O ficheiro de skill
O MCP fornece as ferramentas ao agente. Isto fornece-lhe o discernimento: quando deve utilizá-las, como interpretar um estado de omissão em relação a um estado de aprovação e quais dos resultados são registos DNS que a pessoa tem de alterar, em vez de texto que o agente pode editar. Adicione-o e o agente deixa de perguntar.
Guarde-o como .claude/skills/mail-vet/SKILL.md ou cole-o no que o seu cliente designar como equivalente.
Sem um agente
Dois pedidos, sem chave. O primeiro reserva o endereço, o segundo lê o relatório: 202 enquanto nada tiver chegado, 200 com tudo assim que chegar.
# reserve a single-use address curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en&utm_source=agent' # {"address":"test-<slug>@email-spam-tester.com","slug":"<slug>",...} # send the message there, then read it back curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>' # 202 while nothing has arrived, 200 with the report once it has
A resposta inclui report_url, que é a página que uma pessoa pode consultar. Forneça-a em vez de uma parede de JSON.
Ler o relatório
Dois números, e não são duas opiniões sobre a mesma coisa.
Pontuação da caixa de entrada, de 0 a 100
O nosso modelo. A autenticação e a infraestrutura têm a maior parte do peso, porque determinam a entrega antes de um filtro ler uma palavra do texto.
Pontuação clássica, de 0 a 10
Reproduz o número ao estilo do SpamAssassin que as pessoas já usam para comparação. Está aqui para que o relatório seja comparável ao que alguém viu noutro local, não porque faça uma medição melhor.
Uma verificação passa, apresenta um aviso, falha, é ignorada ou dá erro. Ignorada não significa aprovada: significa que a verificação não se aplicava, por não haver anexos para analisar ou nenhuma parte HTML para avaliar. Um erro significa que não foi possível determinar o resultado, o que deve ser dito claramente em vez de atribuir uma pontuação como se o tivéssemos determinado.
O que o rascunho não pode corrigir
Algumas conclusões dizem respeito ao DNS, não ao conteúdo, e o agente deve dizê-lo claramente em vez de editar a mensagem até a pontuação mudar:
- Registos SPF, DKIM e DMARC, e se estão alinhados com o domínio From
- DNS inverso do IP de envio, e se tem confirmação direta
- Registos MX, TLS no anfitrião de envio e entradas em listas de bloqueio
- MTA-STS, relatórios TLS, DNSSEC e BIMI
Todo o resto faz parte do rascunho: assunto, pré-cabeçalho, peso do HTML, parte de texto, texto alternativo das imagens, encurtadores de ligações, cabeçalhos de anulação da subscrição.
Quatro hábitos que vale a pena ensinar-lhe
Teste aquilo que vai enviar
Uma amostra reescrita avalia a amostra.
Envie a partir da plataforma, não do seu próprio cliente
Testar uma campanha do Mailchimp a partir de uma conta pessoal avalia essa conta.
Volte a testar depois de corrigir
As correções interagem. O único número que tem isso em conta é o do segundo relatório.
Não teste o e-mail de outra pessoa sem pedir autorização
O relatório mostra o assunto, o remetente, o endereço de devolução e o código-fonte completo a qualquer pessoa que tenha a ligação.
Primeiro, teste um manualmente
Demora cerca de um minuto e mostra-lhe o que o agente irá ler.