alterlab-yok-tez

YÖK Ulusal Tez Merkezi — トルコ国立学位論文検索

YÖK Ulusal Tez Merkezi（高等教育評議会の国立学位論文センター）は、トルコのすべての大学院学位論文を収蔵する唯一の必須リポジトリです。対象には、yüksek lisans（修士）、doktora（博士）、tıpta/diş/eczacılıkta uzmanlık（医学・歯学・薬学の専門課程）、およびsanatta yeterlik（芸術実技博士）が含まれます。このスキルが支援する、教員向けの次の2つのワークフローにおける権威ある情報源です。

1. 文献の発見 — トピック、danışman（指導教員）、大学、または年で検索し、既存のトルコ語学位論文をレビュー用に見つけます。
2. 研究計画提出前のözgünlük（独自性）確認 — 指導教員が学生の論文テーマを承認する前に、同じ研究がすでに存在するか、閲覧制限があるか、準備中として登録されているかを調べます。

このスキルが行うのは発見＋メタデータの収集＋引用であり、全文の一括ダウンロードではありません（全文はオンラインでの閲覧のみです。以下のアクセスモデルを参照してください）。

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

YÖK Ulusal Tez Merkezi'nde "sürdürülebilir mimari" konulu tezleri ara
Bir öğrencim "sanal prodüksiyon" üzerine doktora yapmak istiyor; daha önce yapılmış mı?
Find every doctoral dissertation supervised by Prof. X at IEU
Cite this YÖK thesis in APA 7 (Turkish)
Is this thesis topic novel, or has it already been done in Turkey?

→ トルコ語と英語のクエリを組み合わせて作成し、yoktez-mcp コネクターで実行します。結果の重複を除いて {thesis_no, year, university, danışman, title, izin, durum} の表にまとめ、依頼があれば Türkçe APA-7 形式の引用を出力します。

該当しない場合 — 以下のスキルに振り分けてください

リクエスト	適切なスキル
DergiParkでトルコ語の学術誌論文を検索する	alterlab-dergipark
学術誌のTR Dizin収録状況を確認する／国の引用索引を検索する	alterlab-trdizin
YÖK Akademikで研究者のプロフィール／指導した学位論文の一覧／所属を調べる	alterlab-yok-akademik
YÖK Atlasで大学のプログラム入学統計（kontenjan、taban puan）を調べる	alterlab-yokatlas
doçentlik（准教授資格）の適格性ポイントを計算する	alterlab-docentlik-eligibility
akademik teşvik（学術奨励）のスコアを計算する	alterlab-akademik-tesvik
実践的な学位論文の執筆／指導／口頭試問のコーチング（章、口頭試問）	alterlab-thesis-supervisor
生物医学／科学系データベースを対象にPRISMAシステマティックレビューを作成する	alterlab-literature-review
Zotero/BibTeXの参考文献ライブラリを管理する	alterlab-citation-mgmt
一般的なTürkçe APA-7／TR Dizinの投稿規定（学位論文の引用ではない場合）	alterlab-tr-academic-style

このスキルが答えるのは「このトルコ語の学位論文は存在するか／この研究はすでに行われているか、そしてどう引用すればよいか」です。学位論文の執筆、学術誌の評価、キャリアの採点は行いません。

---

データパス：yoktez-mcp

Ulusal Tez Merkezi には公式の公開 API はありません。コミュニティで保守されている経路は、MCP サーバーの saidsurucu/yoktez-mcp（MIT ライセンス）です。スクレイピングではなく、こちらを優先してください。

• ホステッドコネクター： https://yoktezmcp.fastmcp.app/mcp（2026-09-23 時点で YokTezMCP 3.3.1）
• ローカル： uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp

YÖK は2026 年に検索機能を再設計しました。クエリごとに入力欄が 1 つあり、最大 3 つの語句を VE/VEYA で連結し、ドロップダウンで絞り込みます。大学／研究所／学科のテキストフィルターと論文番号検索は廃止されました。コネクターには 6 つのツールがあります（実際の tools/list による確認済み。リポジトリの README には旧バージョンの 2 つが記載されています）。

ツール	用途
search_yok_tez_detailed	トピック、タイトル、著者、指導教員の検索：keyword（および keyword_2、keyword_3、operator_1／operator_2 = and／or）、search_field、match_type、コード指定のフィルター thesis_type、permission_status、thesis_status、language、year_start、year_end
list_yok_tez_anabilim_dali → search_yok_tez_by_anabilim_dali	学科（anabilim dalı コード、1 回の呼び出しにつき最大 15 件）に絞り込みます。廃止された学科フィルターに代わるものです
get_yok_tez_thesis_details	論文の PDF をダウンロードせずに、指導教員、大学 → 研究所 → 学科の階層、トルコ語／英語の要約とキーワード、すぐに使える引用表記を取得します
get_yok_tez_document_markdown	İzinli 論文の PDF から 1 ページ分を Markdown として取得します
list_recent_yok_tez	過去 15 日間にアップロードされた論文、または今年の論文コーパスを取得します（キーワード不要）

フィルターコード（実際の動作を確認済み。全表は references/endpoints.md を参照）：search_field は 7 Tümü （デフォルト）／1 Tez Adı／2 Yazar／3 Danışman／4 Konu／5 Anahtar Kelime／6 Özet、match_type は 2 部分一致（デフォルト）／1 完全一致、 thesis_type は 1 Yüksek Lisans、2 Doktora、3 Tıpta Uzmanlık、4 Sanatta Yeterlik、5～7 は専門分野の種類、permission_status は 0 Tümü／1 İzinli／ 2 İzinsiz、thesis_status は 0 Tümü／3 Onaylandı（コネクターのデフォルト） ／1 Hazırlanıyor です。

コネクターが利用できない場合は、実際のブラウザーで検索画面 https://tez.yok.gov.tr/UlusalTezMerkezi/tarama.jsp を操作できます。JSON／REST エンドポイントをでっち上げないでください。公開されているものはありません。

scripts/yok_tez_query.py は、平易な説明（トルコ語／英語のトピック、指導教員、論文の種類、年、独創性モード）からコネクター引数をオフラインで構築し、引用表記を整形します。ネットワークへの接続は行いません。

---

検索のコツ（自動的に適用してください）

詳しいルールと実例については、references/search_syntax.md を参照してください。

1. 部分一致に対応する語幹で検索します。 デフォルトの一致方式は部分一致なので、sürdürülebilir はあらゆる活用形に一致します。ただし、トルコ語では語尾に接尾辞が付くと、末尾の k／ç／t／p が ğ／c／d／b に変化するため、語幹を短くします。2025 年以降の実際の検索では、okuryazarl はタイトルに 622 件ヒットしましたが、okuryazarlık は 277 件でした。
2. 1 回の呼び出しにつき最大 3 つの語句を指定し、and／or（サイトの VE／VEYA）で連結します。NOT 演算子はありません。不要な結果はローカルで除外してください。
3. トルコ語と英語の両方で検索します。 英語の語句は英語のタイトル／要約／キーワード欄にしか一致しません。そのため、トルコ語だけで検索すると英語で索引付けされた論文を見落とし、逆も同様です。
4. フィールドを意図的に選びます。 トピックの検索漏れを減らすには search_field の 7（Tümü）を使い、精度を重視した検索には 1／6／4／5、著者や指導教員の検索には 2／3 を使います。

---

独自性／指導教員による確認（繰り返し使える手順）

指導教員から 「この論文テーマはすでに研究されていますか？」 と尋ねられた場合：

1. search_field 7 で、TR と EN のクエリを組み合わせて作成します（語幹を使い、同義語は OR でつなぎます）。
2. ユーザーから指定があった場合に限り、thesis_type（例：2 Doktora）と year_start～year_end の期間を設定します。
3. permission_status 0（Tümü）を設定して、İzinsiz（制限付き、要旨のみ）の論文も検索結果に含め、thesis_status 0 も設定して、Hazırlanıyor（執筆中）の論文も含めます。コネクターのデフォルトでは承認済みの論文のみが対象となるため、制限付きまたは進行中の研究は、単純な検索では見落とされます。
4. 重複を除いた表（{thesis_no, year, university, danışman, title, izin, durum}、新しい順）を返し、該当する行については get_yok_tez_thesis_details で指導教員を取得します。
5. これはあくまで 登録情報の網羅性 の確認であり、盗用／テキスト類似度スコアではないことを明記します（iThenticate／Turnitin の領域であり、ここでは対象外です）。

特定の大学に所属する指導教員の場合： 指導教員の氏名を指定して search_field 3 で検索し（必要に応じて thesis_type も指定）、university_info が一致する行を残します。各行について get_yok_tez_thesis_details で指導教員を確認してください。同じ氏名が複数の大学に存在することがあります。

---

アクセスモデル（適切な期待値を設定）

• İzinli（許可済み）の論文はオンラインでの閲覧のみ可能です。ブラウザーで閲覧できますが、コピーや一括ダウンロードはできません。get_yok_tez_document_markdown は許可済みの論文でのみ機能します。
• 全文が制限されている場合でも、要旨（özet）は利用できます（get_yok_tez_thesis_details は TR と EN の要旨を両方返します）。
• İzinsiz（制限付き）の論文では、メタデータと要旨のみが表示されます。印刷版は、大学図書館を通じた TÜBESS／図書館間貸出で入手できます。
• 2006年より前の非公開論文は、著者が Tez Yayımlama İzin Belgesi（論文公開許可書）を提出すると公開できます。
• 法的根拠： 2547 sayılı Kanun Ek Madde 40（Law 7100、第10条により追加、2018年）。認可された gizlilik（機密保持）の決定が適用されない限り、論文は YÖK Ulusal Tez Merkezi により電子的に閲覧可能になります。YÖK の FAQ には禁輸期間の固定された上限はないと記載されています。「12か月の上限」があるとは述べないでください。

詳細は references/access_legal.md を参照してください。

---

上限と一括取得

• バッチあたり約2,000件です。 total_results_found がそれを上回る場合でも、YÖK が返す行数は最大で約2,000件（results_in_batch）です。合計がその近辺またはそれ以上の場合は、年度範囲、論文種別、または学科で分割して、ローカルで統合してください。
• コミュニティミラーの tezara.org は、大量のメタデータ取得に役立つ可能性がありますが、エクスポート機能や上限回避に関する主張は未検証です。詳しくは references/endpoints.md を参照してください。
• トルコ語↔英語のクエリ拡張、指導教員名の正規化、CSV の重複排除といった反復的でプライバシーに影響しない作業は、ローカルモデルまたは短いスクリプトに適しています。

---

YÖK の論文を引用する（Türkçe APA-7）

YÖK の Tez No を APA の Yayın No.（出版番号）に直接対応付けます。 scripts/yok_tez_query.py cite モードはどちらの状態も整形します。ルールと追加の例については references/citation_apa7.md を参照してください。

• 出版済み／許可済み（Yayın No. がある場合）：

  Soyad, A. (Yıl). Tez başlığı (Yayın No. NNNNNN) [Tez türü, Üniversite Adı]. YÖK Ulusal Tez Merkezi.

• 未出版／制限付き：

  Soyad, A. (Yıl). Tez başlığı [Yayımlanmamış tez türü tezi]. Üniversite Adı.

get_yok_tez_thesis_details は YÖK 独自の APA 形式の文字列（姓が大文字、「Tez No.」を使用）も返します。雑誌から YÖK の形式を指定されていない限り、上記の形式に変換してください。必要に応じて、note = {YÖK Ulusal Tez Merkezi, Tez No. NNNNNN} を含む BibTeX の @phdthesis／@mastersthesis を出力できます。

報告前のセルフチェック

• トルコ語と英語の両方で、部分文字列マッチングでも一致する語幹を使って検索しましたか？
• 独自性を確認するため、permission_status を 0、thesis_status を 0 に設定し、制限付きおよび準備中の論文も検索結果に含めましたか？
• いずれかの検索が約2,000件のバッチ上限に近づきましたか？ 近づいた場合は、検索を分割して再実行してください。
• 2026年の検索画面にはなくなったフィルターがあると想定せず、返されたフィールドを使って大学・指導教員との一致を絞り込みましたか？
• 引用には、適切な「刊行済み」または「未刊行」の形式で、Tez No → Yayın No. を使用していますか？
• 登録データの網羅性は、テキスト類似度や盗用のスコアとは異なることを明記しましたか？

---

参考資料

• references/endpoints.md — 2026年の検索画面、yoktez-mcp のライブツール一覧とフィルターコード、結果の形式、バッチ上限、tezara.org。
• references/search_syntax.md — 語幹と子音交替、and/or の語、トルコ語と英語の併用、フィールドの選択、検索例。
• references/access_legal.md — İzinli/İzinsiz、TÜBESS、2006年以前の公開、法的根拠となる 2547 Ek Madde 40、エンバーゴの事実。
• references/citation_apa7.md — トルコ語の APA-7 論文形式、Tez No → Yayın No. の対応、YÖK 独自の引用文字列。

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