用途:把 /campaign-copywriting 生成的 variants.yaml 与列表构建技能产出的 leads.csv 上传到 Smartlead,创建 DRAFT 活动,由人工在界面审核后手动点击 Start。本技能不提供邮件文案,只负责机械上传(API 调用)。
主要能力:创建活动、写入含 A/B/C 变体的序列、按标签筛选并附加收件箱(按 daily_sent_count 升序 LRU)、分批上传线索(每批 100 条)并映射自定义字段、设置跟踪关闭与回复即停、按 YAML 设置排程。
输入:leads.csv 必填列 email、first_name、last_name、company_name;可选列 company_domain、title、linkedin_url、situation_line、value_line、cta_line 等具名字段,不接受任意列。variants.yaml 至少需 name、schedule、inbox_selection 及至少一个步骤的 sequences,schema 见 references/variants-schema.yaml。
用法:export SMARTLEAD_API_KEY=xxx,然后 npx tsx scripts/upload.ts --leads=profiles/<slug>/campaigns/<campaign-slug>/leads.csv --variants=profiles/<slug>/campaigns/<campaign-slug>/variants.yaml。脚本流程为加载环境变量、解析并校验 CSV、解析 YAML、创建活动、写入序列、查询并附加收件箱、分批上传线索、设置与排程,最后打印活动 URL,不自动激活。
限制与注意:标签须先存在并已应用到收件箱(可先用 /smartlead-inbox-manager 打 active 标签);收件箱数量不足时附加全部并警告;CSV 测试至 1 万行,更大可能触发限流,脚本内置指数退避重试;YAML 不符合 schema 会快速失败并指出字段;Smartlead 服务端按活动去重,仍建议先用 /list-quality-scorecard 去重。启动后 21 天可运行 /positive-reply-scoring,每周一运行 /email-deliverability-audit --days=7。