Lead Contact Finder_知识管理 skill-PHP中文网

Lead Contact Finder

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 Prismfy 驱动的网络搜索查找个人或公司的公开联系方式，如公共邮箱、联系路径、媒体/支持页面等。

联系人发现 : 需要为公司或公司特定人员找到公共联系方式时使用此技能

功能概述

联系人发现 : 需要为公司或公司特定人员找到公共联系方式时使用此技能是一项面向实际任务的技能，主要用于为何它能帮助: 找到公开邮件, 当它们被实际曝光时使用。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

联系人发现（Contact Discovery）

当您需要查找某家公司或该公司中特定人员的公开联系信息时，请使用此技能。

它为何有用：

在公开网页上实际暴露了邮箱地址时，可找到该公开邮箱；
在无直接邮箱可见的情况下，可发现可行的联系路径；
无需猜测即可揭示公司邮箱格式线索；
防止智能体虚构私有联系信息。

最适合以下场景：

外联前的联系人信息挖掘；
查找公开的媒体/支持/团队联系页面；
核查某人是否拥有公开的邮箱痕迹；
为后续人工审核提取公司邮箱格式线索。

需要 API 密钥？

免费搜索权限及您的 API 密钥请前往：https://prismfy.io

安装与配置

安装技能：

openclaw skills install contact-discovery

添加您的 Prismfy API 密钥：

export PRISMFY_API_KEY="ss_live_your_key_here"

如需重启后仍生效，请执行：

echo 'export PRISMFY_API_KEY="ss_live_your_key_here"' >> ~/.bashrc
source ~/.bashrc

预检要求：

PRISMFY_API_KEY 已正确设置；
系统已安装 curl 和 jq。

高级配置（可选）：

若配额查询（quota）接口地址与搜索接口不同，请设置 PRISMFY_API_ROOT 或 PRISMFY_ME_URL。

验证 API 连通性：

cd ~/.openclaw/workspace/skills/contact-discovery
bash contact-find.sh --quota

快速冒烟测试：

cd ~/.openclaw/workspace/skills/contact-discovery
bash contact-find.sh --company "Vercel" --query-family company

导出 JSON 报告：

cd ~/.openclaw/workspace/skills/contact-discovery
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all --out contact_discovery_report.json

可选自动化配置：

# 请从本技能目录下运行：
# ~/.openclaw/workspace/skills/contact-discovery

cp -r hooks/contact-discovery ~/.openclaw/hooks/
find ~/.openclaw/hooks/contact-discovery -maxdepth 1 -type f | sort
openclaw hooks enable contact-discovery
openclaw hooks list

适用场景

当出现以下情况时，请使用本技能：

用户请求某人的公开邮箱或其它公开联系方式；
用户希望获取某人或某公司的有效联系路径；
下一步是发起外联，而联系人信息缺失成为当前瓶颈；
潜在客户（lead）已确认存在，仅缺具体触达方式。

不适用场景

请避免在以下情形中使用本技能：

任务目标是线索甄别（lead qualification），而非联系人发现；
用户明确需要私有邮箱或推测性联系方式；
任务仅需验证公司/人员是否存在，无需获取联系方式；
输入中完全缺乏公司、人员或域名等锚点信息。

输入参数

--company（可选）
--domain（可选）
--person（可选）
--role（可选）
--query-family（可选，取值范围：identity|direct|company|pattern|all）
必须至少提供 --company、--domain、--person 中的一项

关于 query-family 的说明：

仅提供 --person 时，推荐使用 direct、identity 或 all 模式，效果最强；
若仅提供 --person 却指定 company 或 pattern，工具将退化为依赖较弱的公开网页线索，结果应视为低置信度。

输出内容

主聊天输出（Primary chat output）：

简洁明了的自然语言结论；
六种可能的判定状态之一：public_email_found | contact_path_found | company_contact_found | company_email_pattern_found | not_found | ambiguous；
最可靠的公开联系线索；
一个具体可信的来源 URL。

可选产物输出（Optional artifact output）：

当用户明确要求生成文件、导出或机器可读报告时，输出 JSON 格式；
使用 --out 参数可将报告写入磁盘。

若生成 JSON 产物，其必需字段包括：

timestamp_utc
skill_version
entity_type
identity_status
contact_verdict
summary
public_emails[]
contact_paths[]
email_pattern_clues[]
source_urls[]
run_failure_code

执行逻辑

优先完成身份解析（identity resolution）：
- 尽可能确定公司的标准域名（canonical domain）；
- 若聚焦于个人，则尝试匹配“人员 + 公司”组合。
按如下顺序执行 Prismfy 查询族（query families）：
- identity
- direct
- company
- pattern
返回最强且安全的判定结果（strongest safe verdict）：
- public_email_found
- contact_path_found
- company_contact_found
- company_email_pattern_found
- not_found
- ambiguous
首先在聊天界面中回复结论；
仅当用户显式请求或使用 --out 参数时，才输出 JSON。

命令示例：

# 检查配额 / 连通性
bash contact-find.sh --quota

# 公司级联系人发现
bash contact-find.sh --company "Vercel" --query-family company

# 人员 + 公司联合联系人发现
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all

# 导出完整报告
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all --out contact_discovery_report.json

执行契约（Execution contract）：

默认模式：平衡型（balanced）
单次查询最大源链接数：5 个 URL
默认聊天输出模式：简洁、人类可读，不输出原始 JSON
仅当邮箱地址在公开证据中被明确展示时，才认定为“已找到”
不得仅凭邮箱格式线索推断私有邮箱
最强判定结果来自 --query-family all
对高价值外联对象，仍建议人工复核后再行动

查询族说明（Query families）

`identity`

官网主页
联系页 / 关于页 / 团队页
人员 + 公司精确匹配结果

`direct`

人员 + 公司 + 邮箱/联系方式
人员 + 公司 + 作者/媒体页面
人员 + 域名线索

`company`

公司或域名对应的联系页面
媒体/支持/帮助/团队类页面
公司层面通用联系邮箱痕迹
在仅提供人员信息（person-only）模式下，回退至公开联系页/个人资料页发现

`pattern`

公司邮箱格式说明页或相关提及
域名邮箱格式线索
仅含格式线索的证据，供后续人工审查
在仅提供人员信息（person-only）模式下，仅能产出弱线索，须保持保守判断

异常处理（Failure Handling）

使用如下失败代码：

PRISMFY_UNAVAILABLE
PRISMFY_INVALID_RESPONSE
IDENTITY_UNCLEAR
NO_PUBLIC_EVIDENCE
RATE_LIMIT_OR_TIMEOUT

处理建议：

若 Prismfy 不可用，请明确告知用户；
若身份无法清晰界定，请标记为 ambiguous；
若仅有邮箱格式线索，请清晰说明，且不可将其作为真实邮箱呈现；
严禁虚构或猜测个人邮箱。

响应风格（Response Style）

常规聊天中，切勿以 JSON 开头；
首句即为判定结论；
其次展示最佳公开邮箱或最佳联系路径；
保持响应紧凑；
仅当 --out 成功生成文件时，才提及报告文件名。

安全性要求（Safety）

禁止泄露任何 API 密钥；
禁止基于邮箱格式线索猜测个人邮箱；
除非有公开证据支撑，否则不得声称某种联系方式存在；
不得将“可能可送达”等同于“已确认可送达”。

最小化示例（Minimal Example）

输入：

--person：Guillermo Rauch
--company：Vercel

默认聊天输出：

Contact path found.
1. Identity: canonical domain = vercel.com
2. Evidence: emails=0, direct_hits=2, company_hits=3, pattern_hits=1, official_hits=2
3. Path: https://vercel.com/contact
4. Source: https://vercel.com/contact