用途:根据姓名、公司或职位等关键词,查询某个特定人物的公开职业资料,包括当前职位与雇主、过往工作经历、教育背景、所在地、社交档案(如 LinkedIn、Twitter)、技能专长及可获得的联系方式。适合用户询问“某人是谁”、查找其背景或联系方式、做职业人物调研时使用。
主要能力:底层通过 Nyne API 检索人物数据库并聚合职业信息。查询参数为 query(必填),建议组合姓名、公司与职位以提高准确度,例如 “Dario Amodei Anthropic CEO”。响应可返回全名与当前头衔、当前雇主与角色、工作历史、教育、位置、社交档案、技能与专长、联系方式(当可得时)。
使用方式:先从 ~/.gooseworks/credentials.json 读取凭证并设置环境变量:
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")
若凭证文件不存在,需运行 npx gooseworks login。所有端点使用 Bearer 认证。查询示例:
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run
-H "Authorization: Bearer $GOOSEWORKS_API_KEY"
-H "Content-Type: application/json"
-d '{"api":"nyne","path":"/person/search","body":{"query":"Dario Amodei Anthropic"}}'
限制:Nyne /person/search 底层使用 PeopleDataLabs,按返回记录计费,每条约 $0.30,适合单人查询,应避免大结果集。多结果搜索有更便宜替代:Apollo mixed_people/search 每次调用 $0.01($GOOSEWORKS_API_BASE/v1/proxy/apollo/mixed_people/search);Fiber /v1/natural-language-search/profiles 每条 $0.02($GOOSEWORKS_API_BASE/v1/proxy/fiber/v1/natural-language-search/profiles)。Nyne 查询为异步:POST 返回 request_id,需用 GET /person/search?request_id=<id> 轮询至完成,结果可能需数秒。常见错误:404 表示未找到,可换拼写或补充公司;429 为限流,需等待重试;常见姓名可能返回多条,需加公司或职位缩小范围。相同查询有缓存会更快。