找人

搜索先返回档案编号。再调一次才返回档案本身。适合按职位、雇主、地点、职级或技能找人。

先拿 100 个 API Credit。

自己创建 key，免费，不需要绑卡。邮箱验证之后，这台浏览器会打开 API keys，并弹出创建对话框。

创建 API key

然后写成环境变量 METIX_KEY。不要把 key 贴进对话或文件。

给谁用

招聘、研究和需要「先出名单、再读档案」的 agent。只覆盖人这一侧。还要职位或公司时，从 platform assistant 开始。

一次调用做什么

• 结构化查询只用 GET /contract 里的字段，没有起步费。POST /v1/people/query 返回 profile_ids、total 和 next。
• 自然语言（POST /v1/people-search，字段是 text）留给写不进字段的条件。即使没有编号，也收 5 个 API Credit 的起步费。这次打包没有调用这条路由。
• 详情一次最多 100 个编号，地址是 POST /entity/v1/profiles/detail-by-id。用 _source 指定字段。搜索本身不返回档案。
• 联系方式的 probe 和 unlock 在这份技能里，而且要等名单已经收窄。Unlock 需要付费账号。注册赠送的额度解锁任何联系方式都会 403。

运行条件

这份技能、METIX_KEY，以及能访问 https://mira-api.metix.ai。MCP 可选，用同一把 key。页面里的字段名来自公开技能已经在调用的那些。和线上 contract 不一致时，以 contract 为准。

三次实测

三次都在 2026-10-13 对 API 2.1.2 运行。每次搜索只要 1 条（size: 1）。没有请求姓名。

美国的 data engineer

current_title match "data engineer"，location.country eq "United States"

合计 67074。读回的那条当前职位是 Big Data Engineer，国家是 United States。

五年及以上、当前在金融服务公司的 backend engineer

职位、国家、total_experience_months gte 60，以及一段当前经历的行业是 Financial Services

合计 591。没有拉档案。公开技能用这个形状先计数，再决定要不要读详情。

德国的 product manager

current_title match "product manager"，location.country eq "Germany"

合计 41378。读回的那条当前职位是 Product Owner Product Manager，国家是 Germany。

限制

• 精确字段用 eq 或 in，值必须是库存的整段文本。match 只给自由文本。国家写 "United States"，不写国家代码。
• 搜索按 ceil(结果数 / 25) 收 API Credit。上面每次只返回 1 个编号，所以每次搜索是 1。读到 1 条档案的详情也是 1。空的结构化搜索不收费。
• Unlock 按返回的值收费，调用前按最坏情况预留，一次最多 25 人。Probe 一次最多 50 人，按搜索计价。这次都没有调用。
• 技能负责把档案取回来。它不给人打分，也不判断谁适合某个职位。