用途:对用户提供的姓名或公司名单做人员与公司信息补充,或按条件检索符合特征的人与公司,适用于合法且比例适当的研究场景,不用于直接抓取领英。
主要能力:单一脚本 scripts/enrich.py 提供五个子命令。person-enrich 一对一匹配指定人物并返回档案与工作经历(每次匹配 1 额度);person-identify 在匹配含糊时返回多个带 Match score 的候选;person-search 按条件检索人物(每条返回 1 额度);company-enrich 匹配公司并返回企业画像(每次匹配 1 额度);company-search 按条件检索公司(每条返回 1 额度)。检索成本随 --size 增长,单次上限 100。
使用方式:先安装 pip install openpyxl(HTTP 用标准库 urllib),并配置 PDL_API_KEY,解析顺序为环境变量 → 当前目录 .env → 脚本旁 .env,密钥不得写入技能或脚本。示例:python scripts/enrich.py person-enrich --input people.csv --output out.xlsx;person-search --company "Northwind Capital" --title director --size 25;company-search --industry "real estate" --country singapore --size 50。检索前可加 --dry-run 做预检,验证输入并估算最大额度且不需密钥;--self-test 离线运行,生成样例表以便预览格式。
限制与注意:免费套餐下邮箱与电话等 PII 字段以布尔值返回,需查看 Email status / Phone status 列;姓名常见时易误配,可用 --min-likelihood(1–10)提高阈值或补充公司、邮箱等上下文列。输出为待人工复核的研究草稿,不作结论;未匹配或需复核的行应标记,不得臆测身份。.env 视为机密,不得打印、提交或上传;数据会发送至 PDL 第三方,无法令牌化。实际计费以 PDL 端点条款与返回记录为准,试运行仅为估算。