---
name: whaleseek
description: 寻鲸 WhaleSeek · B2B 获客 Skill。用户只要说清楚“我卖什么”，就能拿到全球真实企业名单、决策人联系方式、购买意向评分与多语言邮件草稿。适用于找客户、找买家、拓客、出海找客户、生成线索名单、批量触达等场景。
---

# 寻鲸 WhaleSeek · 获客 Skill

把“我卖什么”变成“谁可能买、找谁、怎么开口”。

## 何时使用

当用户出现以下意图时启用：

- “帮我找客户 / 找买家 / 找经销商 / 找代理商”
- “我要出海 / 开发海外市场 / 找海外客户”
- “给我一份 XX 行业的线索名单”
- “这个产品应该卖给谁 / 帮我做客户画像”
- “帮我写开发信 / 批量触达决策人”

不要用于：C 端消费者洞察、纯市场调研报告、竞品分析（这些不是获客任务）。

## 前置条件

需要一个 WhaleSeek API Key（`wk_live_...`），在 `https://www.nexacoreddp.com/console/` 注册后创建。

MCP 接入（HTTP，推荐）：

```json
{
  "mcpServers": {
    "whaleseek": {
      "type": "http",
      "url": "https://www.nexacoreddp.com/mcp",
      "headers": { "Authorization": "Bearer wk_live_xxx" }
    }
  }
}
```

无 MCP 客户端时，也可以直接 HTTP 调用（见文末）。

## 工作流

### 1. 只问一句话：你卖什么

从用户原话中提取，不要追问问卷。缺失时最多补问一个：

> “用一句话说清楚你卖什么，最好带上目标行业或地区，例如：给德国汽车零部件厂供应精密轴承。”

不要一次问五个问题。地域、优势、排序策略都有默认值。

### 2. 调用 `find_customers`

```json
{
  "what_you_sell": "给德国汽车零部件厂供应精密轴承",
  "market": "overseas",
  "regions": ["德国"],
  "advantages": ["交期 4 周", "CE 认证"],
  "sort_strategy": "intent",
  "target_count": 20
}
```

返回：`task_id` + 作战方案（ICP、关键词、搜索式、无效名单规则）。立刻把方案用 3-5 行讲给用户听，再说明“正在检索”。

### 3. 轮询 `get_task_status`

```json
{ "task_id": "ws_xxx", "include_results": true, "offset": 0, "limit": 10 }
```

- 用返回的 `next_poll_after_ms` 控制节奏，不要高频轮询
- `is_done=false` 时展示进度百分比与当前阶段
- `status=completed` 后按 `offset/limit` 分页取全部结果

### 4. 呈现结果

优先展示 A 级线索：企业、国家、行业、规模、意向分、信号、决策人（姓名/职位/邮箱/验证状态）、邮件草稿。

不要把所有字段一次性倒给用户。先给 3-5 条摘要，再问“要不要展开某一条 / 生成触达清单”。

### 5. 触达与跟进

- 邮件草稿只是草稿，**不要声称已发送**
- 用户要“发出去”时，说明需要他们在自己的邮箱或企业发信通道确认
- 建议下一步：加入 CRM / 导出 CSV / 7 天后复检信号

## 工具参考

### find_customers

| 参数 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `what_you_sell` | string，必填 | — | 一句话业务描述，4–200 字 |
| `market` | `global`/`overseas`/`domestic` | `global` | 出海选 `overseas` |
| `regions` | string[] | `[]` | 国家/地区，中英文均可 |
| `advantages` | string[] | `[]` | 产品优势，影响推荐理由与邮件 |
| `sort_strategy` | `intent`/`fit`/`recent_signal`/`company_size` | `intent` | 排序 |
| `target_count` | 5–50 | `20` | 目标线索数（一轮固定 10 积分，与条数无关） |
| `company_size` | string[] | `[]` | `11-50`、`51-200` 等 |
| `exclude_domains` | string[] | `[]` | 排除已有客户/竞品 |
| `contact_channels` | `email`/`linkedin`/`phone` | `["email","linkedin"]` | 联系方式 |
| `auto_write_email` | boolean | `true` | 生成邮件草稿 |
| `email_language` | `auto`/`zh`/`en`/`ja`/`es`/`de`/`fr` | `auto` | 邮件语言 |
| `locale` | `zh-CN`/`en-US` | `zh-CN` | 返回文案语言 |

### get_task_status

| 参数 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `task_id` | string，必填 | — | 任务 ID |
| `include_results` | boolean | `true` | 是否返回线索 |
| `offset` | number | `0` | 分页偏移 |
| `limit` | 1–50 | `10` | 单页条数 |

## 评分怎么解释

- **意向分**：近期采购/合作信号强度（招标、扩招、融资、扩产、系统替换）× 时效 × 是否拿到决策人邮箱
- **匹配分**：行业、地域、规模与 ICP 的吻合度
- **等级**：A ≥ 75，B ≥ 55，其余为 C；C 级与无意向线索会被服务端剔除

对用户解释时，强调“意向分是信号强度，不是成交概率”。

## 积分与错误

| 情况 | 返回 | 处理 |
| --- | --- | --- |
| 积分不足 | `isError=true`，文案含“积分不足” | 告知余额与 10 积分/轮的价格，引导到控制台充值 |
| Key 无效 | HTTP 401 | 让用户到控制台重新创建 |
| 会话过期 | JSON-RPC `-32002` | 重新 `initialize` |
| 任务不存在 | `isError=true` | 任务只保留 2 小时，重新发起 |

## 直接 HTTP 调用（无 MCP 客户端）

```bash
# 1. 建立会话
curl -X POST https://www.nexacoreddp.com/mcp \
  -H "Authorization: Bearer wk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# 2. 带 mcp-session-id 调用工具
curl -X POST https://www.nexacoreddp.com/mcp \
  -H "Authorization: Bearer wk_live_xxx" \
  -H "mcp-session-id: <上一步返回>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"find_customers","arguments":{"what_you_sell":"给德国汽车零部件厂供应精密轴承","target_count":10}}}'
```

## 合规提醒

- 联系方式来自公开渠道，触达前确认符合当地反垃圾邮件法规（如 GDPR、CAN-SPAM）
- 不要一次性群发大量未验证邮箱
- 邮件内容由用户最终确认，Skill 不代替用户做承诺