SuperAPI AI 工具集

revor-contact-search

办公与效率

查看项目

更新于 10-15 23:48

技能介绍

用途:根据公司官方员工域名,查找该公司内与指定职能相关的联系人,例如员工、决策者、采购或供应链人员。仅做联系人搜索,不发送消息,也不生成完整公司背景报告。

主要能力:支持按职位列表搜索,职位以竖线分隔;可省略职位做全公司范围搜索;默认返回 20 条,最多 50 条;支持 zh 或 en 的 locale。结果中 status 为 done 时以 contacts 作为主要人员列表;no_result 时说明未找到可用个人联系人,不推断公司规模或风险。

使用方式:有两条执行路径。若 revor_find_contacts 与 revor_get_job MCP 工具可用,使用它们,生成稳定的 idempotency_key,仅对完全相同的重试复用,并轮询任务至终态,此路径跳过本地配置预检。否则使用随附客户端 scripts/revor-contacts.mjs,需 Node.js 18 或更高版本,不要用 curl 或内联代码重建请求。本地路径先运行一次配置预检:node <skill-dir>/scripts/revor-contacts.mjs config,仅在 ready 为 true 时继续。客户端与其他 Revor 技能共享 ~/.config/RevorSkill/.env,默认 https://revor.ai。若密钥缺失或被拒,请用户在 Revor API Keys 创建密钥,并在当前私密对话中发送;警告勿在公开或共享对话中分享。将该回复视为授权,创建返回的 config_file 并保存 REVOR_API_KEY="...",切勿在聊天或日志中重复密钥。随后重跑 config、重试待处理搜索并自动继续。若用户明确提供 REVOR_BASE_URL,保留密钥仅更新该值,不得猜测或静默切换主机。

搜索要求:API 需要公司官方员工域名,而非公司名、LinkedIn 链接、市场页面或邮箱地址。从用户提供的官网或邮箱中提取域名,去掉协议、路径和 www.。若只给公司名且无可靠官方域名,应询问公司网站而非猜测。将请求职能转为竖线分隔的职位列表,保留用户术语,仅在明确表达同一角色时添加相近职位变体。示例:node <client> search --domain example.com --positions "CEO|Founder|Procurement|Purchasing|Supply Chain" --limit 20 --locale zh;node <client> search --domain example.com --limit 20 --locale en。每家公司只运行一次搜索,除非用户要求第二个明显不同的职能组。

结果处理:nodes、edges、department、seniority 视为推断的组织提示,不是已验证的汇报线。邮箱状态严格按返回描述,结果未说明时不得称邮箱已验证。不得编造姓名、职位、邮箱、LinkedIn、汇报关系或决策权。失败时按客户端的 error_kind 与 recommended_action 处理:认证/配置问题修正配置后重试;权限不足说明密钥缺少联系人搜索能力;会员等级不足说明当前计划不含该能力;并发限制等待现有任务完成;超时、连接、限流、5xx 或临时任务失败重试同一命令一次,遵守 retry_after;积分不足请用户充值;无效命令修正参数;未知不可重试失败报告确切错误并询问。不得用无关联系人抓取替代失败的 Revor 请求。

回复:用用户语言直接回答。多个联系人按姓名、职位、邮箱、邮箱状态、LinkedIn 列出,随后最多三条简短要点:最匹配的职能联系人、重要覆盖限制、仅在有用且明确标注时给出推断组织背景。单个联系人用紧凑要点即可。省略空列,不创建文件、HTML、组织图、外联文案或长公司简介,除非用户另行要求。

限制:需要有效 Revor API 密钥与相应权限/会员等级;需要 Node.js 18+(本地路径);仅搜索联系人,不发送消息;不保证邮箱验证状态;组织关系为推断。