HeyReach Connect 是一个用于对接 HeyReach LinkedIn 自动化平台的元技能（meta-skill），主要面向需要通过命令行脚本管理 LinkedIn 外联活动的用户。
用途 该技能用于将 HeyReach 的 LinkedIn 自动化能力集成到工作流中，通过预置的 Python 脚本调用 HeyReach API，完成活动管理、线索添加、数据查看等操作。
触发方式 当用户提及以下关键词时加载：heyreach、heyreach campaigns、linkedin outreach、linkedin automation、list campaigns、show campaigns、campaign stats、campaign metrics、add leads to campaign、campaign leads、linkedin accounts。
使用前检查 每次使用前必须先运行配置检查脚本： python 00-system/skills/heyreach/heyreach-master/scripts/check_heyreach_config.py --json 根据返回结果决定后续动作：若配置正常则继续操作；若缺少 API 密钥，则提示用户提供并保存到 .env 文件。
API 设置步骤
- 登录 HeyReach：https://app.heyreach.io
- 进入 Settings → API
- 复制 API 密钥
- 将密钥粘贴到配置中
主要能力与脚本路由 所有脚本位于 00-system/skills/heyreach/heyreach-master/scripts/ 目录下，按用户意图路由到对应脚本：
- 列出活动：list_campaigns.py，参数 [--limit N] [--json]
- 查看活动详情：get_campaign.py，参数 --campaign-id ID [--json]
- 暂停/恢复活动：toggle_campaign.py，参数 --campaign-id ID --status ACTIVE|PAUSED
- 向活动添加线索：add_leads.py，参数 --campaign-id ID --linkedin-urls URLs
- 查看活动线索：get_leads.py，参数 --campaign-id ID [--limit N]
- 查看对话：get_conversations.py，参数 [--campaign-id ID] [--limit N]
- 列出 LinkedIn 账号：list_accounts.py，参数 [--json]
- 列出线索列表：list_lists.py，参数 [--limit N]
- 创建线索列表：create_list.py，参数 --name NAME
- 获取分析/统计：get_stats.py，参数 [--json]
- 获取活动指标：get_metrics.py，参数 --campaign-id ID
示例工作流 列出活动： python 00-system/skills/heyreach/heyreach-master/scripts/list_campaigns.py --json
添加线索：
python 00-system/skills/heyreach/heyreach-master/scripts/add_leads.py
--campaign-id camp-123
--linkedin-urls "linkedin.com/in/user1,linkedin.com/in/user2"
获取统计： python 00-system/skills/heyreach/heyreach-master/scripts/get_stats.py --json
错误处理
- 401：API 密钥无效，需重新运行设置
- 403：当前订阅不可用该 API
- 404：活动或线索未找到
- 429：触发速率限制（自动重试）
适用场景 适用于需要通过脚本批量管理 LinkedIn 外联活动、添加线索、查看活动数据与对话的用户，尤其是已将 HeyReach 作为 LinkedIn 自动化工具并希望以命令行方式操作的工作流。
限制 使用前必须配置有效的 HeyReach API 密钥；部分 API 功能可能受订阅级别限制（403 错误）；触发速率限制时脚本会自动重试。版本为 1.0。