lead-hunting

name: lead-hunting description: 通过自媒体平台按搜集策略探索潜在客户——策略 A 分析帖子发布者画像，策略 B 从评论区挖掘潜客。用于 HEARTBEAT 定时任务。

Lead Hunting 技能

通过自媒体平台搜索特定关键词内容，按搜集策略筛选潜在客户。策略 A 逐一分析创作者主页判定是否为潜在客户；策略 B 扫描帖子评论区，根据评论内容挖掘潜在客户。

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

前置条件

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

• 搜集策略（A 发布者画像匹配 / B 评论区潜客挖掘）
• 目标平台列表及对应的搜索关键词
• 潜在客户判定标准 / 评论筛选标准
• 每次最大探索量
• 反馈形式（列表报告 / Cold Touch 私信 / Email 联系）

执行流程

Step 1: 准备工作

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

Step 2: 逐平台搜索

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

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

Step 3 (策略 A): 逐创作者判定

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

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

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

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

4. 读取创作者主页介绍

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

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

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

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

Step 3 (策略 B): 逐帖子评论区挖掘

对每个搜索到的帖子，按顺序执行：

1. 提取帖子标识（platform, post_url, post_title）

2. 导航到帖子详情页，等待评论区加载

3. 如果支持按时间排序，切换到按时间排序，确保评论从新到旧排列

4. 滚动浏览评论区，查找符合 HEARTBEAT.md 中评论筛选标准的评论：
   - 提取评论者信息：昵称、user_id、IP属地、评论内容、评论日期

5. 对每条符合标准的评论：
   a. 以评论者 user_id 作为 --creator-id 做去重检查：
      ./skills/bd-record/scripts/check-creator.sh --platform <平台> --creator-id <评论者user_id>
      如果 {"exists": true}，则跳过该评论者

   b. 记录到数据库：
      ./skills/bd-record/scripts/record-creator.sh \
        --platform <平台> \
        --creator-id <评论者user_id> \
        --nickname <昵称> \
        --homepage-url <原贴URL> \
        --qualified <1或0> \
        --notes <评论内容及判定理由>

6. 操作间隔：每个帖子之间保持 30-60 秒间隔，避免平台风控

Step 4: 汇总报告

1. 统计本批次结果：
   - 策略 A：探索总数、符合数、跳过数（已记录）
   - 策略 B：扫描帖子数、发现潜客数、跳过数（已记录）

2. 列出所有符合标准的潜在客户：
   - 策略 A：平台、昵称、ID、主页 URL、判定理由
   - 策略 B：平台、昵称、user_id、IP属地、评论内容、评论日期、原贴url

3. 按 HEARTBEAT.md 中配置的反馈形式执行（仅策略 A 支持 Cold Touch 私信 / Email 联系）：
   - **Cold Touch 私信**：逐一给符合标准的创作者发送预设话术私信，使用各平台的私信/消息功能，每个私信之间保持 30-60 秒间隔
   - **Email 联系**：先校验 `email-ops` 所需环境变量是否齐全，若不全则跳过 Email 步骤并记录；齐全则使用 `email-ops` 发送邮件，每个邮件之间保持 30-60 秒间隔

4. 使用 message 工具将汇总报告发送给用户

错误处理