alterlab-yokatlas

YÖK Atlas — トルコの大学プログラム・入試統計

YÖK Atlas（Yükseköğretim Kurulu Atlası — 高等教育評議会のプログラムアトラス）から、トルコのあらゆる学部（lisans）または短期大学部（önlisans）のプログラムについて、定員、合格者数、最低入試得点、合格順位、職位別の教員数といった公式のプログラム単位の統計を取得します。保守されている yokatlas-py パッケージを通じて、APIキー不要のYÖK Atlas JSON APIを利用するため、同じクエリから同じ形式のレコードが得られます。HTMLのスクレイピングは不要で、APIキーも必要ありません。

これは統計スキルです。個々の研究者の履歴書、論文、所属は調べません。それには、別個のアーキテクチャを持つYÖKシステムである alterlab-yok-akademik を使用します（下のルーティング表を参照）。

このスキルを使用する場面

ユーザーがYÖK Atlasのプログラムまたは大学単位の数値を求めている場合に使用します。

YÖK Atlas'tan Boğaziçi Bilgisayar Mühendisliği taban puanını ve başarı sırasını çıkar
Compare the kontenjan and yerleşen counts for all Tıp programs at state universities
What was the minimum SAY score for Hacettepe Elektrik-Elektronik Mühendisliği last year?
List every university in YÖK Atlas and the academic-staff counts for a given program
How many professors vs. araştırma görevlisi does this department have?

→ scripts/yokatlas_lookup.py（yokatlas-py の薄いラッパー）を実行し、JSONを読み取ってから、求められた統計を表にまとめて提示します。データの年と、数値がYÖK Atlasの情報であることを必ず明記してください。

トルコ語の標準用語（初出時に英語の意味を併記）

トルコ語	意味	APIフィールド
kontenjan	定員（募集人数）	kontenjan
yerleşen	入学者数（入学した学生）	yerlesen
taban puan	最低入試得点	min_puan
başarı sırası	合格順位（最後に合格した学生の全国順位）	basari_sirasi
puan türü	得点種別（SAY/SÖZ/EA/DİL/TYT）	puan_turu
lisans / önlisans	学士課程 / 短期大学課程	birim_turu_id 46 / 47
kılavuz kodu	ガイドコード（プログラムの一意なID）	kilavuzKodu

教員の職位別人数は、prof（profesör）、doc（doçent）、dou（doktor öğretim üyesi）、ogr_gor（öğretim görevlisi）、ar_gor（araştırma görevlisi — リサーチアシスタント）として返されます。

⚠️ エンドポイントに関する注意事項（スクレイピングを行う前にお読みください）

2026年4月時点で、YÖK Atlasはサーバー側でレンダリングされるPHPから、JSON APIをバックエンドとするReact SPAに移行しました。従来のPHPエンドポイントは機能していません — lisans.php?y=…、lisans-panel.php、tercih-sihirbazi-*.php は、現在、空のSPAシェルのみを返します。これらをスクレイピングしないでください。 /api/tercih-kilavuz/ 配下のJSON APIのみを使用してください（または、このスキルのように、それをラップする yokatlas-py を使用してください）。エンドポイントとフィールドの詳細は references/api_endpoints.md を参照してください。

対象外 — 以下に振り分けてください

ユーザーが実際に求めているもの…	振り分け先
研究者の履歴書、論文、プロジェクト、指導した学位論文、または公式な所属（akademik.yok.gov.tr）	alterlab-yok-akademik
大学院の学位論文（tez）— 全文、要旨、独自性・新規性の確認（Ulusal Tez Merkezi）	alterlab-yok-tez
学術誌がTR Dizinに収録されているかどうか、または学術誌・論文の検索	alterlab-trdizin
DergiParkで公開されている論文（収集、BibTeX、学術誌の対象範囲）	alterlab-dergipark
doçentlik（准教授資格）の要件ポイントの計算	alterlab-docentlik-eligibility
akademik teşvik（学術奨励）のスコア計算	alterlab-akademik-tesvik
TÜBİTAK ARDEB 1001/1002-Aの提案書のひな形作成	alterlab-tubitak-proposal
著者の出版物メタデータ（DOI、引用数、h-index）	alterlab-research-lookup / alterlab-openalex

このスキルが回答するのは、**「このプログラムまたは大学の入試・定員・教員数はいくつか？」**という質問です。個々の研究者の業績については扱いません。

仕組み

データソース

エンドポイント	返される内容
/api/tercih-kilavuz/universiteler	大学の一覧（{universiteAdi, universiteId}、2026-09-23 時点で 228 件）
/api/tercih-kilavuz/universite-programlar	プログラムグループの一覧（{birimGrupId, birimGrupAdi, puanTuru}、611 件）—大学ごとのプログラムではありません
/api/tercih-kilavuz/universite-iller	県（{ilAdi, ilKodu}）
/api/tercih-kilavuz/search	SearchFilters を使ったプログラム検索

yokatlas-py（MIT、Python ≥3.10、0.7.0 は 2026-07-23 にリリース）では、モジュールレベルの関数 search_programs(filters_dict, size=…)、get_program(kilavuz_kodu)、list_universities() に加え、0.7.0 で追加された list_program_groups()、list_cities()、search_netler()（テストセクションごとの平均正答数、/api/netler/search）を利用できます。また、YokAtlasClient / SearchFilters / Program のオブジェクト API も利用できます。トルコ語の文字（İ/ı、Ş/ş、Ğ/ğ、Ç/ç、Ö/ö、Ü/ü）を正規化するため、"boğaziçi" と "bogazici" のどちらでも検索できます。フィルターとフィールドの完全なリファレンスは references/api_endpoints.md を参照してください。

名前解決に関する注意点。 universite、program、il はそれぞれ検索候補のエントリー 1 件に解決されます。完全一致を優先し、次にテキストを含む最初のエントリー、それから類似候補を検索し、それ以外の場合は呼び出しに失敗します。program="bilgisayar" のような断片は、気付かないうちにグループ「Bilgisayar Bilimleri」に解決され、Boğaziçi の結果が返されません。完全なグループ名（「bilgisayar mühendisliği」）または birim_grup_id を使ってください。「odtü」のような略称は解決されません（「orta doğu teknik」は解決されます）。結果が空の場合は「このグループに一致するものがない」ことを意味し、「そのようなプログラムが存在しない」という意味ではありません。報告する前に、解決された名前を確認してください。

パイプライン

1. リクエストから操作を選択します。大学一覧の取得、プログラムの検索、または kılavuz kodu（ガイドコード）を指定したプログラム 1 件の取得です。

2. フィルターを作成します。 共通の SearchFilters フィールドは、puan_turu（SAY/SÖZ/EA/DİL/TYT）、universite、program、il（県）、universite_turu（DEVLET/VAKIF）、および başarı sırası の範囲を指定する min_basari_sirasi / max_basari_sirasi です。全項目は references/api_endpoints.md を参照してください。

3. ヘルパーを実行します。

   uv run --with yokatlas-py python \
     skills/turkish-academia/alterlab-yokatlas/scripts/yokatlas_lookup.py \
     search --puan-turu SAY --universite "boğaziçi" --program "bilgisayar mühendisliği" --size 20
   

   その他のサブコマンド：

   # All universities (id + name)
   uv run --with yokatlas-py python .../yokatlas_lookup.py universities
   
   # One program's multi-year statistics by guide code
   uv run --with yokatlas-py python .../yokatlas_lookup.py program --kod 102210277
   

   スクリプトは JSON エンベロープ（{"tool", "operation", "count", "results"}）を出力します。検索結果には、一致がない場合に total_elements、data_year、および note も追加されます。yokatlas-py またはネットワークを利用できない場合、スクリプトは構造化された {"error": …, "manual_instructions": …} を出力してゼロ以外のステータスで終了します。統計情報を捏造することはありません。

4. JSON を読み、結果を報告します。 各プログラムについて、年、kontenjan、yerlesen、min_puan、basari_sirasi、および質問された場合は教職員数を提示します。各 Program には最大 4 年分（current + history）が含まれます。2026-09-23 時点で current は 2026 年の配置年でした。数値がどの年のものかを明記してください。過去の年によってはスコアのみがあり、定員のフィールドが空の場合があります。

5. 話題がそれた場合は関連先に引き継ぎます。 その後、人物の CV や論文について尋ねられた場合は alterlab-yok-akademik に、論文について尋ねられた場合は alterlab-yok-tez に引き継ぎます。

使用例

• プログラムの比較。 universite_turu を DEVLET と VAKIF に切り替えて同じ program を検索し、min_puan / basari_sirasi を並べて表にまとめます。
• 学生への進路相談。 目標とする başarı sırası をもとに、max_basari_sirasi で絞り込み、現実的に合格を狙えるプログラムを一覧表示します。
• 教育機関の調査。 kılavuz kodu でプログラムを取得し、教職員の構成（prof/doc/dou/ogr_gor/ar_gor）と、利用可能な各年の kontenjan から yerleşen への充足率を報告します。

その他の検索例は references/query_recipes.md を参照してください。

注意事項とセルフチェック

• ラッパーのバージョンを固定してください。 yokatlas-py ≥0.6.0（現在は0.7.0）を使用してください。上流の JSON API は2026年4月に一度変更され、従来のスクレイパーがすべて動作しなくなりました。結果の形式が 不正に見える場合は、報告する前にパッケージのバージョンを再確認してください。単に空の場合は、まず上記の 名前解決に関する注意点を確認してください。
• v0.6.0以降、属性別の内訳はありません（性別／高校種別ごとの内訳）。0.7.0でも引き続きありません。これらの フィールドがあると約束しないでください。返されるのは、上記の職員数／定員／得点の各フィールド（および0.7.0の nets）のみです。
• 得点の種類が重要です。 プログラムの min_puan は puan_turu と併せて初めて意味を持ちます。常に両方を報告してください。
• データの年次。 数値は過去のデータです（最新年と、その前の3年間）。年を明記せずに、数値が「現在の入学者選抜」のものだと 示唆しないでください。
• スクリプトはネットワークに接続できましたか？ error エンベロープが返された場合は、その旨を伝え、 manual_instructions を共有してください。記憶を頼りに数値を推測しないでください。

参考資料

• references/api_endpoints.md — /api/tercih-kilavuz/ エンドポイント、SearchFilters の全フィールド一覧、 列挙型（puan türü、大学の種類、birim türü）、返される統計フィールド、および従来のPHP APIが廃止されている旨の注意事項。
• references/query_recipes.md — ベンチマーク、アドバイス、機関調査に関する質問向けの yokatlas_lookup.py の実行例。

AlterLab Academic Skills スイートの一部です。