SuperAPI AI 工具集

openjobs-jobs-search

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:在 OpenJobs AI 职位数据库中搜索与发现职位,支持结构化过滤条件。

主要能力:搜索接口 /v1/job-fast-search 支持 title、description、company_name、functions、country_iso_2、location、state、city、industries、seniority、employment_type、size 等字段;其中 title、description、company_name、functions 为模糊或短语匹配,seniority、employment_type、location、state、city、industries 为模糊文本过滤。country_iso_2 必须为 ISO 3166-1 alpha-2 代码(如 US)。搜索先返回字符串 job_ids,再用 /entity/v1/jobs/detail-by-id 批量获取完整职位文档,单次最多 100 个 ID。

使用方式:所有受保护请求使用 POST 与 Authorization: Bearer ${MIRA_KEY} 及 Content-Type: application/json。MIRA_KEY 须来自本地环境或密钥注入,切勿粘贴到对话或写入文件。运行前可安全检测 MIRA_KEY 是否存在,并检查 https://mira-api.openjobs-ai.com/version,若版本高于 2.1.2 需通过官方安装器更新。配额方面,job-fast-search 计 5 点(job_ids 非空时计费),detail-by-id 每次找到大于 0 时计 3 点,单次批量上限 100 个 ID。探索性搜索默认 size 为 10,公共 API 密钥最大可请求 1000。

适用场景:按职称、公司、地点、资历、雇佣类型、职能或行业查找在招职位;先搜索 ID 再按需获取详情展示。

限制:所有职位数据仅来自 OpenJobs AI 数据库,不得用外部招聘网站、LinkedIn、网页搜索或模型知识补充。搜索不支持日期过滤;posted、created_at、updated_at 需在详情中获取。地理位置过滤(country_iso_2、location、state、city)覆盖可能稀疏,若返回零结果,应先去掉地理过滤重试一次,再从详情字段核实地理位置。搜索返回的 ID 在详情中可能返回 not_found,属正常状态。某地无匹配时,应说明在 OpenJobs AI 数据库中未找到匹配职位。