用途:面向 SmartLead 冷邮件外联的审计与运营。它通过 smartlead-pp-cli 驱动 API,并在本地 SQLite 镜像上回答跨活动、跨周的问题,单次 API 调用无法给出的历史对比由镜像完成。
主要能力:health 输出所有活动的反弹率、回复率、沉默线索数、发件数及过期标记;silent 找出已发邮件但 N 天未回复的线索;dupes 扫描全量线索镜像,查找出现在两个及以上活动中的邮箱或域名,--domain 可打印某站点的完整接触记录;drift 按每 7 天窗口计算回复、打开、反弹的周环比变化;sender-health 按收件箱预热落地率、SMTP/IMAP 连接健康度与发送利用率综合排名发件账号;warmup-gate 按阈值检查各发件账号,配合 --strict 在任一账号不达标时以非零码退出,可作启动门禁。
使用方式:需先安装 CLI,默认安装在 macOS/Linux 的 $HOME/.local/bin、Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin,并确保安装目录在 $PATH:npx -y @mvanhorn/printing-press-library install smartlead --cli-only;验证 smartlead-pp-cli --version。若 npx 安装失败,可用 Go 1.26.6 及以上直接安装:go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/smartlead/cmd/smartlead-pp-cli@latest。鉴权使用 API Key 作为 api_key 查询参数,设置环境变量 SMARTLEAD_API_KEY,运行 smartlead-pp-cli doctor 验证。命令加 --agent 等价于 --json --compact --no-input --no-color --yes,可用 --select 缩减字段、--dry-run 预览、--deliver 路由到 stdout、file 或 webhook。读取本地或 API 的命令使用 meta/results 信封,需解析 .results 取数据、.meta.source 判断来源。
适用场景:晨间活动分诊、启动前去重、构建跟进名单、按周判断活动衰减、筛选拖累送达率的发件账号、以脚本门禁阻止未预热账号投用。
限制:本资料未提供收费、价格与额度信息。本地镜像与离线能力依赖 sync 与本地 SQLite 存储;warmup-gate 的 --min-days、--min-inbox-rate 具体默认值未提供;反馈默认仅本地存储,仅在设置 SMARTLEAD_FEEDBACK_ENDPOINT 且使用 --send 或 SMARTLEAD_FEEDBACK_AUTO_SEND=true 时才会外发。