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. 01比较 Gmail 与 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

详细介绍

投递能力测试——收件箱类型对比

按收件箱类型（SMTP、Gmail / G Suite、Outlook / Office365）对比 Smartlead 账户中的回复率、退信率和正向回复率。可用它回答“我的 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。
  • 收件箱数量较少时，数据波动较大。 如果你只有 2 个 Gmail 收件箱和 40 个 SMTP 收件箱，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