利用 Bouncer 來清理電子報的無效用戶

MCP

Bouncer 最近推出官方 MCP！ 未來不用自己串 API 也不用一直打開 Bouncer 介面驗證 Email

下面用 Claude Desktop 示範

官方說明看 Bouncer Email Verification MCP Server

加入 Bouncer MCP

在 Claude Desktop 開 Settings → Connectors 按 Add custom connector 名稱填 bouncer 網址填這個：

按 Continue connecting 就會進到 Bouncer 的授權頁

授權後測試 Email

授權頁會寫明 Claude 可以驗證 Email、執行 batch verification 和檢查 toxicity 這些操作會使用 Bouncer 的 credits

畫面也提醒會產生一把專用 API key 之後可以到 API 頁面停用它

按 Allow access 完成授權

授權完成後就能回到ㄓ Claude Desktop 測試了

我的測試情境是用我的 gmail 但故意輸入錯誤的 domain darrell.tw.martech@gmaiil.com

畫面回覆 Risky 原因是 low_quality 分數是 10/100 毒性標記是 toxicity: 4 建議修正成 gmail.com

使用的情境

未來有蒐集到一批新的 email 想要快速排查哪些是否可能違規的時候 就能先整理這批名單 (建議先過濾正確的 domain，例如真的 gmail.com 大部分就不需要放入)

或是你的發信平台有標示一批用戶好像收不到信 那就蠻值得用 bouner 來檢測的

API

文件:Bouncer API

Bouncer 的 API 串接也是非常簡單

1. 首先要先取得 API Key

2. 選擇要用哪種 API

• Single
  • 單一 Email 驗證，這個 API 的 Rate Limit 是 1000 requests 每分鐘，所以要是想要短時間內驗證大量 Emails，就要考慮下面的 Batch 或是 Batch Sync
• Batch
  • 批次 Email 驗證，非同步，會回傳一個 batchId，可以透過 batchId 用其他 API 確認狀況和結果
• Batch Sync
  • 批次 Email 驗證並且是同步方式，會直接回傳結果 (注意: 如果 Server 的計費方式使有 CPU 啟用時間，那這隻 request 會佔用較長的 CPU 啟用時間，而產生較高的 Server 費用)

得到的結果

[
    {
        "email": "darrellwang@gmail.com",
        "status": "deliverable",
        "reason": "accepted_email",
        "domain": {
            "name": "gmail.com",
            "acceptAll": "no",
            "disposable": "no",
            "free": "yes"
        },
        "account": {
            "role": "no",
            "disabled": "no",
            "fullMailbox": "no"
        },
        "dns": {
            "type": "MX",
            "record": "gmail-smtp-in.l.google.com."
        },
        "provider": "google.com",
        "score": 100,
        "toxic": "no"
    },
    {
        "email": "darrellwang@gmaii.com",
        "status": "unknown",
        "reason": "unknown",
        "domain": {
            "name": "gmaii.com",
            "acceptAll": "unknown",
            "disposable": "no",
            "free": "no"
        },
        "account": {
            "role": "no",
            "disabled": "unknown",
            "fullMailbox": "unknown"
        },
        "dns": {
            "type": "MX",
            "record": "localhost."
        },
        "provider": "other",
        "didYouMean": "darrellwang@gmail.com",
        "toxic": "unknown"
    }
]

// 結果的名詞可以參考下方的解釋

串接 - Klaviyo

Bouncer 在串接 Klaviyo 非常方便! 算是我們先前在串接文章中提到的 內建串接 只需要將 Klaviyo 的 API Key 填入 Bouncer 即可

再來只要到 Bouncer 的 Integration 頁面中設定 Klaviyo 的 API Key 就好

串接完成後，就可以在 Bouncer 看到 Klaviyo 的 Email List 了!

從列出的 Email List 中選擇一個，並且執行驗證 後續等一下(可能會視 Email List 大小而有不同時間)，就可以在 Bouncer 看到驗證後的結果

這是個小型的測試用 List 還好結果看來非常乾淨，名單中沒有問題的 Email

Bouncer 結果名詞解釋

想參考官方文件原文介紹的可以到這

Terminology

Status

Reason

Domain details

Account details

Other