Mail Vet

Quy trình

Năm bước, và tác nhân tự thực hiện tất cả mà không cần được hướng dẫn từng bước.

1. Lấy một địa chỉ

   Một lệnh gọi đặt trước một địa chỉ dùng một lần và cho tác nhân biết cần viết kế hoạch khắc phục bằng ngôn ngữ nào. Địa chỉ chỉ nhận đúng một thư và hết hạn sau một giờ.

2. Gửi thư thực đến địa chỉ đó

   Không phải bản tóm tắt, không phải phiên bản rút gọn. Một nửa số phép kiểm tra đọc các tiêu đề do nền tảng gửi thêm vào, và nội dung được dán không chứa bất kỳ tiêu đề nào trong số đó.

3. Chờ

   Một lệnh gọi chặn duy nhất. Lệnh trả về khi quá trình phân tích hoàn tất, vì vậy tác nhân không cần thăm dò và không có vòng lặp chờ nào có thể bị xử lý sai.

4. Sửa những gì được nêu

   Mỗi phát hiện đều đi kèm mục RFC và trang tài liệu Google làm căn cứ, để tác nhân có thể kiểm tra nhận định thay vì tin ngay.

5. Gửi lại

   Một địa chỉ mới, thư đã sửa, một điểm số thứ hai để so sánh với điểm đầu tiên. Mức cải thiện dự kiến được tính bằng cách chấm điểm lại, nhưng chúng không cộng dồn, và báo cáo thứ hai là con số trung thực.

Kết nối

Máy chủ MCP chỉ cần một dòng cho Claude Code:

claude mcp add --transport http email-spam-tester https://email-spam-tester.com/mcp

Hoặc, với máy khách nhận JSON:

{
  "mcpServers": {
    "email-spam-tester": {
      "type": "http",
      "url": "https://email-spam-tester.com/mcp"
    }
  }
}

Bốn công cụ đi kèm: đặt trước một địa chỉ, chờ báo cáo, đọc báo cáo hiện có theo slug và lấy nguồn thư đúng như khi được chuyển phát.

Tệp kỹ năng

MCP cung cấp công cụ cho tác nhân. Phần này cung cấp khả năng phán đoán: khi nào cần dùng chúng, cách hiểu trạng thái skip so với trạng thái pass và phát hiện nào là bản ghi DNS mà người dùng phải thay đổi thay vì phần văn bản tác nhân có thể sửa. Đặt tệp này vào và tác nhân sẽ ngừng hỏi.

Lưu tệp dưới dạng .claude/skills/mail-vet/SKILL.md, hoặc dán tệp vào vị trí tương ứng trong máy khách của bạn.

Không dùng tác nhân

Hai yêu cầu, không cần khóa. Yêu cầu đầu tiên đặt trước địa chỉ, yêu cầu thứ hai đọc báo cáo: 202 khi chưa có thư nào đến, 200 với đầy đủ mọi thứ sau khi thư đến.

# 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

Phản hồi chứa report_url, là trang mà người dùng có thể đọc. Hãy chuyển trang đó thay vì một bức tường JSON.

Đọc báo cáo

Hai con số, và chúng không phải là hai ý kiến về cùng một thứ.

Một kiểm tra có thể đạt, cảnh báo, không đạt, bị bỏ qua hoặc gặp lỗi. Bị bỏ qua không có nghĩa là đạt: điều đó có nghĩa là kiểm tra không áp dụng, do không có tệp đính kèm để quét hoặc không có phần HTML để đánh giá. Lỗi có nghĩa là chúng tôi không thể xác định, điều này nên được nói rõ thay vì chấm điểm như thể chúng tôi đã xác định được.

Những gì bản nháp không thể khắc phục

Một số phát hiện thuộc về DNS, không phải nội dung, và tác nhân nên nói rõ điều đó thay vì tiếp tục chỉnh sửa thư cho đến khi điểm thay đổi:

• Các bản ghi SPF, DKIM và DMARC, và việc chúng có căn chỉnh với miền From hay không
• DNS ngược cho IP gửi, và việc nó có được xác nhận bằng phân giải xuôi hay không
• Các bản ghi MX, TLS trên máy chủ gửi và các mục trong danh sách chặn
• MTA-STS, báo cáo TLS, DNSSEC và BIMI

Mọi thứ còn lại là bản nháp: tiêu đề, preheader, dung lượng HTML, phần văn bản, văn bản thay thế của hình ảnh, trình rút gọn liên kết, tiêu đề hủy đăng ký.

Bốn thói quen đáng để dạy cho tác nhân