SkillBoss API Hub — AI 冷邮件生成器

根据潜在客户数据生成个性化的冷邮件序列。SkillBoss API Hub 利用 AI 自动调研目标客户，并基于真实背景撰写独特、相关、高转化率的外联内容，而非套用模板。

配置

1. 在 https://app.skillboss.co/settings 获取您的 API 密钥（进入“集成” → “API 密钥”）
2. 在您的运行环境中设置环境变量 SKILLBOSS_API_KEY

工作原理

该技能调用 SkillBoss API Hub 的统一接口（POST https://api.skillboss.co/v1/pilot），并传入 type: "chat" 参数，为每位潜在客户生成个性化冷邮件序列。AI 会自动分析客户的上下文信息（包括公司、职位及 LinkedIn/官网数据），据此生成高度相关的外联内容。

接口地址

所有请求均发送至 SkillBoss API Hub 统一端点：

POST https://api.skillboss.co/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json

单客户 — 生成邮件序列

为单个潜在客户生成冷邮件序列（每客户 3–5 封邮件）。请求使用 type: "chat" 类型，并在结构化 prompt 中传入客户数据与序列配置选项。

{
  "type": "chat",
  "inputs": {
    "messages": [
      {
        "role": "system",
        "content": "您是一位专业的冷邮件文案专家。请基于潜在客户数据生成个性化冷邮件序列。每封邮件都应具备独特性、相关性与高转化潜力。返回一个包含 'sequence' 数组的 JSON 对象。"
      },
      {
        "role": "user",
        "content": "请为以下潜在客户生成冷邮件序列：nn姓名：{lead.name}n职位：{lead.title}n公司：{lead.company}n邮箱：{lead.email}n公司官网：{lead.company_website}nLinkedIn：{lead.linkedin_url}nn配置选项：n- 邮件数量：{options.email_count}n- 签名档：{options.email_signature}n- 推广切入点：{options.campaign_angle}n- 可用 CTA：{options.approved_ctas}nn请返回 JSON 格式：{"sequence": [{"step": 1, "subject": "...", "body": "..."}, ...]}"
      }
    ]
  },
  "prefer": "quality"
}

成功响应（HTTP 200）：

{
  "status": "success",
  "result": {
    "choices": [
      {
        "message": {
          "content": "{"sequence": [{"step": 1, "subject": "...", "body": "..."}, {"step": 2, "subject": "...", "body": "..."}, {"step": 3, "subject": "...", "body": "..."}]}"
        }
      }
    ]
  }
}

解析响应结果：

import json
raw = response.json()["result"]["choices"][0]["message"]["content"]
sequence = json.loads(raw)["sequence"]

批量处理 — 为多个客户生成邮件序列

如需为多个潜在客户生成邮件序列，可选择以下任一方式：对每位客户单独调用一次接口；或构造一个批量 prompt 并一次性提交：

{
  "type": "chat",
  "inputs": {
    "messages": [
      {
        "role": "system",
        "content": "您是一位专业的冷邮件文案专家。请为每位潜在客户分别生成个性化冷邮件序列。返回一个包含 'leads' 数组的 JSON 对象。"
      },
      {
        "role": "user",
        "content": "请为以下潜在客户生成冷邮件序列：nn{leads_json}nn配置选项：email_count={options.email_count}, list_name={options.list_name}nn请返回 JSON 格式：{"leads": [{"email": "...", "sequence": [{"step": 1, "subject": "...", "body": "..."}]}]}"
      }
    ]
  },
  "prefer": "quality"
}

批量响应解析示例：

raw = response.json()["result"]["choices"][0]["message"]["content"]
result = json.loads(raw)
leads_with_sequences = result["leads"]

Python 示例代码

import requests, os, json

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]
API_BASE = "https://api.skillboss.co/v1"

def pilot(body: dict) -> dict:
    r = requests.post(
        f"{API_BASE}/pilot",
        headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"},
        json=body,
        timeout=60,
    )
    return r.json()

def generate_cold_email_sequence(lead: dict, options: dict = None) -> list:
    """为单个潜在客户生成个性化冷邮件序列。"""
    if options is None:
        options = {}

    email_count = options.get("email_count", 3)
    signature = options.get("email_signature", "")
    angle = options.get("campaign_angle", "")
    ctas = options.get("approved_ctas", [])

    user_content = (
        f"请为以下潜在客户生成冷邮件序列：nn"
        f"姓名：{lead.get('name', '')}n"
        f"职位：{lead.get('title', '')}n"
        f"公司：{lead.get('company', '')}n"
        f"邮箱：{lead.get('email', '')}n"
        f"公司官网：{lead.get('company_website', '')}n"
        f"LinkedIn：{lead.get('linkedin_url', '')}nn"
        f"配置选项：n"
        f"- 邮件数量：{email_count}n"
        f"- 签名档：{signature}n"
        f"- 推广切入点：{angle}n"
        f"- 可用 CTA：{ctas}nn"
        f'请返回 JSON 格式：{{"sequence": [{{"step": 1, "subject": "...", "body": "..."}}, ...]}}'
    )

    result = pilot({
        "type": "chat",
        "inputs": {
            "messages": [
                {"role": "system", "content": "您是一位专业的冷邮件文案专家。请基于潜在客户数据生成个性化冷邮件序列。每封邮件都应具备独特性、相关性与高转化潜力。返回一个包含 'sequence' 数组的 JSON 对象。"},
                {"role": "user", "content": user_content}
            ]
        },
        "prefer": "quality"
    })

    raw = result["result"]["choices"][0]["message"]["content"]
    return json.loads(raw)["sequence"]

潜在客户字段说明

每位潜在客户必须提供有效的 email 字段，该字段用于在处理流程中唯一标识客户。其余字段均为可选，但提供后可显著提升邮件个性化程度。

可选参数

响应格式（SkillBoss API Hub）

错误码

使用示例

“为 Stripe 的销售副总裁生成一封冷邮件”
“为以下 10 位潜在客户创建外联邮件序列”
“撰写一套面向 SaaS 公司市场总监的三封邮件序列”