competitor-engagers

竞争对手互动者

找出在 LinkedIn 上积极与竞争对手互动的人——他们是最有意向的陌生外联潜在客户。

必需步骤：使用 /icp-prompt-builder 进行筛选（请勿跳过）

收集互动者 CSV 后，抽取约 50 行样本，并在扩大处理规模前运行 /icp-prompt-builder。仅有 LinkedIn 互动并不能保证符合 ICP——对手帖子下的互动者可能是同行、求职者、学生，也可能是真正的买家。筛选条件有助于区分这些人。

**为何这是必需步骤：**未经筛选的互动者名单通常有 30-50% 的行不符合 ICP（粉丝、同行、招聘人员、学生）。对 50 行样本运行 /icp-prompt-builder 并调整筛选提示词，然后将其应用于完整名单，可减少不必要的丰富数据和发送成本。需要 10-15 分钟。

设置（仅首次需要）

运行前，请确保已在 ~/.env 中设置这些环境变量：

RAPIDAPI_KEY=<your key from https://rapidapi.com/apibuilderz/api/realtime-linkedin-bulk-data>
OPENROUTER_API_KEY=<your key from https://openrouter.ai/keys>

测试你的凭据：

npm run competitor-engagers -- --check-auth

步骤

1. 解析用户输入。用户必须提供网站 URL（例如，“clay.com”）。询问：

   • 要发现多少个竞争对手（默认值：20）
   • 每家公司要处理多少条帖子（默认值：30）
   • 是否要包含任何指定的竞争对手 LinkedIn URL

   如果用户只说“运行吧”或只提供 URL，则使用所有默认值。

2. 运行身份验证预检：

   npm run competitor-engagers -- --check-auth
   

   如果失败，请协助用户设置 API 密钥。

3. 运行主脚本：

   npm run competitor-engagers -- --url={domain} --competitors={count} --posts={postsPerCompany} {--extra-competitor=URL ...} --verbose
   

4. 脚本会显示实时进度。完整运行（20 个竞争对手 × 200 名员工 × 收集互动数据）可能需要 30-120 分钟。如果中断，请使用 --resume 重新运行：

   npm run competitor-engagers -- --url={domain} --resume
   

5. 完成后，从 ~/output/competitor-engagers/ 读取输出 CSV，并提供：

   • 找到的互动者总人数（去重后）
   • 最活跃的 10 位互动者（按 total_engagements 排序）
   • 按竞争对手划分的明细
   • 输出文件路径

6. 提供后续操作选项：

   • “要筛选出互动次数达到 3 次或以上的人吗？”
   • “要为他们补充电子邮件地址吗？”
   • “要针对另一家公司运行吗？”
   • “要先启动一次试运行，以验证竞争对手名单吗？”

CLI 参考

--url=<domain>            Target company domain (required)
--competitors=<n>         AI-discovered competitor count (default: 20)
--posts=<n>               Posts per company (default: 30)
--extra-competitor=<url>  Add a competitor manually (repeatable)
--dry-run                 Discover competitors only, skip engagement scraping
--resume                  Resume from checkpoint after interruption
--verbose                 Detailed per-request logging
--check-auth              Test API credentials and exit

注意事项

• 跳过受雇于目标公司或任何竞争对手公司的人
• 仅收集评论和表情回应（不收集转发）
• 帖子回溯时间范围为 90 天
• 每个竞争对手最多获取 200 名员工
• 输出中每人占一行（去重并按互动次数排序）
• 检查点保存在 ~/output/competitor-engagers/{domain}-checkpoint.json

---

接下来该做什么

运行 /icp-prompt-builder，处理互动者 CSV 的 50 行样本（必需步骤——仅有 LinkedIn 互动并不能保证符合 ICP）。然后对筛选后的名单运行 /list-quality-scorecard。

**或者等待：**如果样本中有大量不符合 ICP 的噪声（粉丝／同行／招聘人员占比 >50%），你选择的竞争对手可能范围太广。使用更严格的竞争对手筛选条件重新运行此技能。

相关技能

• /icp-prompt-builder — 对此技能输出执行必需的筛选
• /list-quality-scorecard — 对筛选后的名单评分
• /list-builder（Phase 5，电子邮件）— 如果 LinkedIn 互动数据不包含电子邮件
• /campaign-copywriting — 撰写提及其具体互动模式的文案