SignalHire联系人拓展

技能简介

该技能通过SignalHire API提供三种核心能力：查询账户剩余信用额度、搜索候选人档案、以及批量获取完整联系信息（邮箱、电话、社交资料）。适用于需要大规模拓展潜在客户或候选人联系渠道的场景。

业务背景

销售与招聘团队常面临找对人却联系不上的困境。本技能通过SignalHire API打通候选人数据库，让业务人员按需检索目标人群档案并批量获取真实联系方式，解决线索获取瓶颈，将拓客效率从手动逐个查找提升至自动化批量处理。

落地案例：某猎头顾问需为金融科技岗位储备100位候选人。先调用"Check remaining credits"确认账户额度充足，再用"Search for profiles"按"风控总监+上海+互联网金融"条件筛选，获取档案列表后提交批量获取请求，15分钟内即可收到含手机、邮箱的完整联系表，直接导入CRM跟进，无需逐一手动搜索。

能做什么

• 实时查询账户可用信用额度，避免任务中断
• 按职位、地点、关键词等条件搜索候选人档案（不消耗信用）
• 批量获取100条以内的完整联系信息，支持LinkedIn链接、邮箱、电话或UID作为输入
• 自动处理异步回调结果并持久化到CSV文件

使用说明

1. 环境准备：需配置两个环境变量——SIGNALHIRE_API_KEY（API密钥）和SIGNALHIRE_CALLBACK_URL（公网可访问的回调地址，用于接收异步结果）
2. 安装指令：将技能部署至OpenClaw平台，确保连接器服务可通过隧道或反向代理暴露至公网
3. 执行前检查：调用”Check remaining credits”动作确认额度充足，若余额低于待处理数量需拆分任务
4. 搜索阶段：使用”Search for profiles”动作，注意并发限制为3个同时请求，首次搜索后15秒内需发起滚动请求获取后续页面
5. 丰富阶段：使用”Enrich contacts”动作提交最多100条记录，监听回调URL接收处理结果，每个回调需在10秒内返回HTTP 200，否则SignalHire将重试最多3次
6. 速率控制：Person API限制为每分钟600个元素，需实现节流逻辑

输入与输出

见下方输入与输出表格。

风险提示

• Search API需联系SignalHire官方开通权限，未授权调用将失败
• 回调地址必须公网可达且响应及时，网络不稳定可能导致数据丢失
• 超出速率限制会导致请求被拒绝，需自行实现队列和重试机制
• 信用额度耗尽时任务将中断，建议在自动化流程中加入前置检查
• scrollId有效期仅15秒，分页获取需及时处理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ms-youssef/signalhire-skill/SKILL.md
来源类型：GitHub仓库