用途:查询土耳其高校(YÖK Atlas,高等教育委员会项目图谱)中本科(lisans)与副学士(önlisans)项目层面的官方统计,包括 kontenjan(招生名额)、yerleşen(实际录取人数)、taban puan(最低录取分)、başarı sırası(成功排名)以及按职称统计的教职工人数。仅回答“某项目或某大学的招生/名额/师资数字”,不涉及个人学术履历、论文或发表记录(这些应由 alterlab-yok-akademik、alterlab-yok-tez 等技能处理)。
主要能力:只读 YÖK Atlas 的 JSON API(/api/tercih-kilavuz/ 下),通过 MIT 许可的 yokatlas-py(Python ≥3.10)封装调用,不做 HTML 抓取、不需密钥。可列出大学列表,按分数类型(SAY/SÖZ/EA/DİL/TYT)、大学、项目、省份、院校类型(DEVLET/VAKIF)等过滤条件搜索项目,或按 kılavuz kodu 拉取单个项目多年数据。每个项目最多返回四年(当年及前三年)记录,含 prof/doc/dou/ogr_gor/ar_gor 教师职称计数。
使用方式:运行 scripts/yokatlas_lookup.py,例如搜索:uv run --with yokatlas-py python …/yokatlas_lookup.py search --puan-turu SAY --universite "boğaziçi" --program "bilgisayar mühendisliği" --size 20;列出大学用 universities 子命令;按编码查项目用 program --kod 102210277。脚本输出 JSON 信封(工具、操作、数量、结果),搜索会附带 total_elements、data_year 及无匹配时的说明;网络或包不可用时报结构化错误并非零退出,不伪造数据。
限制:名称解析只取单一匹配项(先精确、再包含、最后近似),如 program="bilgisayar" 会解析为“Bilgisayar Bilimleri”而返回空,需用完整组名或 birim_grup_id;"odtü" 等缩写无法解析。自 0.6.0 起不再提供性别/高中类型等人口统计明细。最低分必须与分数类型一同报告;数据为历史数据,需标明所属年份。推荐使用 yokatlas-py ≥0.6.0(当前 0.7.0)。旧 PHP 端点已失效,切勿抓取。