lead-hunting

name	lead-hunting
description	通过自媒体平台搜索内容创作者，按预设关键词和判定标准筛选潜在客户。用于 HEARTBEAT 定时任务。

Lead Hunting 技能

通过自媒体平台搜索特定关键词内容，逐一分析创作者主页，按预设标准判定是否为潜在客户。

依赖技能：smart-search（构造搜索 URL）、browser-guide（浏览器操作）、email-ops（email 操作）、bd-record（去重记录）

---

前置条件

执行前需确认 HEARTBEAT.md 中已配置以下信息：

• 目标平台列表及对应的搜索关键词
• 潜在客户判定标准
• 每次最大探索量
• 反馈形式（列表报告 / Cold Touch 私信 / Email 联系）

---

执行流程

Step 1: 准备工作

1. 读取 HEARTBEAT.md 获取当前配置（平台、关键词、判定标准、最大探索量）
2. 确保浏览器可用（遵循 browser-guide）
3. 初始化 bd-record 数据库：bash ./skills/bd-record/scripts/init-db.sh

Step 2: 逐平台搜索

对 HEARTBEAT.md 中配置的每个平台，按顺序执行：

1. 使用 smart-search 技能构造该平台的关键词搜索 URL
2. 导航到搜索结果页
3. 等待页面加载完成
4. 收集搜索结果列表中的内容链接（最多取 HEARTBEAT.md 中配置的最大探索量）
   - 内容按由新到旧排序（使用平台默认排序）
   - 提取每个内容的创作者主页链接

Step 3: 逐创作者判定

对每个搜索到的创作者，按顺序执行：

1. 提取创作者标识信息（平台、creator_id、nickname、homepage_url）

2. 去重检查：
   bash ./skills/bd-record/scripts/check-creator.sh --platform <平台> --creator-id <创作者ID>
   如果 {"exists": true}，则跳过该创作者，继续下一个

3. 导航到创作者主页，等待加载

4. 读取创作者主页介绍

5. 浏览创作者前 10 个作品（不足则全部浏览）：
   - 对每个作品读取标题、简介/描述文字
   - 视频内容只需分析视频简介，不下载视频

6. 按 HEARTBEAT.md 中预设的判定标准，判断是否符合潜在客户：
   - 分析创作者定位、内容方向、商业属性
   - 排除同行/竞对（内容与我们相似但非潜在客户）
   - 判定为潜在客户需给出明确理由

7. 记录到数据库（不管是否符合标准）：
   bash ./skills/bd-record/scripts/record-creator.sh \
     --platform <平台> \
     --creator-id <创作者ID> \
     --nickname <昵称> \
     --homepage-url <主页URL> \
     --qualified <1或0> \
     --notes <判定理由>

8. 操作间隔：每个创作者之间保持 30-60 秒间隔，避免平台风控

Step 4: 汇总报告

1. 统计本批次结果：探索总数、符合数、跳过数（已记录）
2. 列出所有符合标准的潜在客户：
   - 平台、昵称、ID、主页 URL、判定理由
3. 按 HEARTBEAT.md 中配置的反馈形式执行：
   - **Cold Touch 私信**：逐一给符合标准的创作者发送预设话术私信，使用各平台的私信/消息功能，每个私信之间保持 30-60 秒间隔
   - **Email 联系**：先校验 `email-ops` 所需环境变量是否齐全，若不全则跳过 Email 步骤并记录；齐全则使用 `email-ops` 发送邮件，每个邮件之间保持 30-60 秒间隔
4. 使用 message 工具将汇总报告发送给用户

---

错误处理

情况	处理
平台搜索结果为空	记录平台名称，跳过该平台，继续下一个
创作者主页无法访问	记录"无法访问"后跳过，不阻塞流程
浏览器异常	不需要重启、不需要报错!等待 30 秒后在原页面继续操作即可。若仍无法操作,再等 30 秒;若还不行,尝试关闭浏览器后重开;只有关闭重开后仍报错才是真的出错,需停止并反馈用户。
平台风控/验证码	停止当前平台操作，记录并继续下一个平台
持续错误	spawn IT Engineer 协助排查，当前任务标记为部分完成