mcpField
D
deliverability-test-public

deliverability-test-public

github.com/growthenginenowoslawskiマーケティング・グロース79063 回インストール3 週間前に更新
リポジトリ

deliverability-test-public について

Smartlead APIからメールアカウントの種類別に送信数、返信数、バウンス数を集計するマーケティング向けスキルです。サブクライアントや対象期間を指定でき、結果を表で出力します。

主な機能

  1. 01メールアカウントの種類別集計
  2. 02送信・返信・バウンスの集計
  3. 03サブクライアントと期間の指定
  4. 04比較表の出力

活用シーン

  1. 01GmailとSMTPの返信率の比較
  2. 02バウンスが多い種類の特定
  3. 03期間別の配信データ確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/growthenginenowoslawski/coldoutboundskills --skill deliverability-test-public

インストール後、Claude Code で/deliverability-test-publicを入力して読み込まれたか確認します。

同梱ファイルscripts/inbox-type-compare.ts

詳細

到達率テスト — 受信トレイの種類別比較

Smartlead アカウント全体で、受信トレイの種類（SMTP、Gmail／G Suite、Outlook／Office365）ごとに返信率、バウンス率、肯定的な返信率を比較します。「Gmail の受信トレイは SMTP のものより成果が良いか？」「ある種類の受信トレイで、他よりバウンスが多いのはなぜか？」といった疑問への回答に役立ちます。

このスキルを使う理由

受信トレイの種類によって、メール到達率の特性は異なります。

  • Gmail／G Suite — 信頼性が最も高く、バウンスが最も少なく、返信率も最良になることがよくあります
  • Office365 — 評判は良好ですが、迷惑メールのフィルタリングはより厳格です
  • SMTP（Zapmail、Maildoso、Mailforge、カスタム）— プロバイダーによって大きく異なり、ドメインの運用開始から最初の30日間はバウンスが多くなることがよくあります

キャンペーンで複数の種類の受信トレイを併用している場合、このスキルで、どの種類が役立っているかを確認できます。

必要なもの

  • 環境変数に SMARTLEAD_API_KEY を設定
  • オプション：サブクライアント用の --client-id=<id>
  • オプション：遡る日数を指定する --days=<N>（デフォルトは7）

手順

# Full account, last 7 days
npx tsx scripts/inbox-type-compare.ts

# Specific sub-client, 14-day lookback
npx tsx scripts/inbox-type-compare.ts --client-id=5560 --days=14

# Just show today
npx tsx scripts/inbox-type-compare.ts --days=1

出力

Inbox Type Comparison — last 7 days

Type              Inboxes    Sent     Replies   Bounces    Reply %   Bounce %
---------------   ------   -------   -------   -------    -------   --------
G Suite               12    3,120       42        12        1.35%      0.38%
Office365             24    6,440       65        28        1.01%      0.43%
SMTP                  44   10,780       55        98        0.51%      0.91%
---------------   ------   -------   -------   -------    -------   --------
TOTAL                 80   20,340      162       138        0.80%      0.68%

Takeaways:
- G Suite has the highest reply rate (1.35%) and lowest bounce rate.
- SMTP reply rate is 60% lower than G Suite — investigate domain reputation.
- SMTP bounce rate is 2x average — run /email-deliverability-audit on SMTP domains.

仕組み

  1. /email-accounts API から、ページネーションを使ってすべてのメールアカウントを取得します
  2. type フィールドごと（GMAIL、OUTLOOK、SMTP など）にグループ化します
  3. これらの受信トレイを使用する各キャンペーンについて、/campaigns/{id}/analytics と /campaigns/{id}/sequence-analytics-by-email-account から受信トレイごとの統計を取得します
  4. 各種類のグループ内で、送信数／返信数／バウンス数を集計します
  5. 書式を整えた表を出力します

よくある注意点

  • ここでの返信率は通常の返信率であり、肯定的な返信率ではありません。 より重要な指標である肯定的な返信率を確認するには、/positive-reply-scoring を使ってください。
  • 受信トレイの数が少ない場合、数値のばらつきが大きくなります。 Gmail の受信トレイが2つ、SMTP の受信トレイが40個しかない場合、Gmail の数値に統計的な意味はありません。
  • 受信トレイの種類のラベルは意外な場合があります。 技術的には Gmail 経由であっても、プロバイダーによっては「SMTP」として登録されます。Smartlead が付けたラベルをそのまま信頼してください。

次に行うこと

受信トレイの種類のいずれかで成果が低い場合： /smartlead-inbox-manager を使って問題のあるものを引退させます（retired のタグを付け、ウォームアップを無効にします）。置き換えが必要な場合は、/zapmail-domain-setup-public を使って別の種類のプロバイダーで新しいドメインを用意します。

すべての種類で問題がない場合： /cold-email-weekly-rhythm を使って、毎週のルーティンに戻ります。

または、しばらく待ちます： 種類ごとのサンプル数が少ない（500件未満の送信）場合、数値のばらつきが大きくなります。結果がはっきりしない場合は、データを増やして7日後に再実行してください。

関連スキル

  • /email-deliverability-audit — SPF／DKIM／DMARC、評判、迷惑メールフォルダーへの振り分けを含む総合監査
  • /positive-reply-scoring — 単なる返信率ではなく、重要な指標を確認します
  • /smartlead-inbox-manager — 問題のある受信トレイを入れ替え、パフォーマンス別にタグを付けます

スクリプト

  • scripts/inbox-type-compare.ts — 種類別の数値を取得して比較します

コメント

Markdown 対応