关于 alterlab-yok-tez
面向研究人员和导师的技能,用于检索土耳其国家论文中心的研究生论文、核查选题是否已有相关记录,并整理引用。它通过 yoktez-mcp 搜索和提取元数据,不用于批量下载全文。
主要功能
- 01土耳其语与英语配对检索
- 02按主题、作者和导师搜索
- 03筛选论文类型、状态与年份
- 04提取论文详情和摘要
- 05生成土耳其语 APA-7 引用
适用场景
- 01为文献综述查找土耳其学位论文
- 02在提交提案前核查选题新颖性
- 03查找特定导师指导的论文
- 04整理国家论文中心记录的引用
MCP 相关
通过 yoktez-mcp MCP 服务搜索 YÖK Ulusal Tez Merkezi,获取论文记录、详情及获准论文的页面内容。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alterlab-ieu/ alterlab-academic-skills --skill alterlab-yok-tez安装后在 Claude Code 中输入/alterlab-yok-tez确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/access_legal.mdcitation_apa7.mdendpoints.mdsearch_syntax.mdscripts/yok_tez_query.py详细介绍
YÖK Ulusal Tez Merkezi — 土耳其国家论文检索
YÖK Ulusal Tez Merkezi(高等教育委员会的国家论文中心)是土耳其所有研究生论文的唯一强制存储库——包括yüksek lisans(硕士)、doktora(博士)、tıpta/diş/eczacılıkta uzmanlık(医学/牙科/药学专科)和sanatta yeterlik(艺术专业能力)。它是本技能支持的两项教师工作流的权威来源:
- 文献发现——按主题、danışman(导师)、大学或年份,查找现有土耳其学位论文,以供综述使用。
- 提案前的ö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。目前维护良好的社区方案是 saidsurucu/yoktez-mcp MCP 服务(采用 MIT 许可证);优先使用它,而不要抓取网页。
- 托管连接器:
https://yoktezmcp.fastmcp.app/mcp(YokTezMCP 3.3.1,数据截至 2026-09-23) - 本地:
uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp
YÖK 在 2026 年重新设计了搜索功能:每个查询使用一个字段,最多可输入三个由 VE/VEYA 连接的词项,并提供下拉筛选器。大学/研究所/院系文本筛选器和论文编号查询功能已取消。该连接器提供六个工具(实时 tools/list;仓库 README 仍展示旧版的两个工具):
| 工具 | 用途 |
|---|---|
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ı 代码,每次调用 ≤ 15 个)——用于替代已取消的院系筛选器 |
get_yok_tez_thesis_details | 获取导师、大学 → 研究所 → 院系路径、土耳其语/英语摘要和关键词,以及现成的引文格式——无需下载 PDF |
get_yok_tez_document_markdown | 将一篇 İzinli 论文的一个 PDF 页面转换为 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 可根据纯文本描述(TR/EN 主题、导师、论文类型、年份、原创性模式)离线构建连接器参数并格式化引文;它不会发起网络请求。
搜索技巧(自动应用)
完整规则和示例见:references/search_syntax.md。
- 搜索能适配子串匹配的词干。 默认匹配方式为 包含,因此
sürdürülebilir可以找到所有变形形式——但土耳其语中,词尾的 k/ç/t/p 在接后缀前会变为 ğ/c/d/b,所以要截短词尾:okuryazarl找到了 622 条标题结果,而okuryazarlık找到了 277 条(2025 年起,实时检查)。 - 每次调用最多使用三个词项,以
and/or连接(对应网站上的 VE/VEYA)。没有 NOT 运算符——请在本地筛除不需要的结果。 - 同时运行土耳其语和英语查询。 英语词项只会匹配英语标题/摘要/关键词字段,因此全土耳其语查询会漏掉以英语编入索引的论文,反之亦然。
- 有目的地选择字段。 按主题尽可能全面检索时使用
search_field7(Tümü);精确检索时使用1/6/4/5;搜索作者和导师时使用2/3。
原创性/指导教师核查(可重复使用的流程)
当指导教师询问 “这个论文选题已经有人做过了吗?” 时:
- 在
search_field7中构建成对的土耳其语 + 英语查询(词干,同义词用 OR 连接)。 - 仅当用户提出要求时,才限定
thesis_type(例如2Doktora)和year_start–year_end时间范围。 - 设置
permission_status0(Tümü),以便显示 İzinsiz(受限、仅摘要)论文;同时设置thesis_status0,以便显示 Hazırlanıyor(正在撰写)论文——连接器默认只返回已批准的论文,而受限或正在进行的研究正是简单搜索会漏掉的内容。 - 返回一张去重后的表格——
{thesis_no, year, university, danışman, title, izin, durum},按年份从新到旧排列——对需要关注的条目使用get_yok_tez_thesis_details获取指导教师信息。 - 明确说明这反映的是登记库覆盖情况,而不是抄袭/文本相似度评分(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会返回土耳其语和英语摘要)。 - İzinsiz(受限)论文仅显示元数据和摘要;纸质版可通过大学图书馆的 TÜBESS/馆际互借获取。
- 2006 年前未公开的论文可由作者提交 Tez Yayımlama İzin Belgesi(论文出版许可文件)后开放。
- **法律依据:**第 2547 号法律第 40 条补充条款(由第 7100 号法律第 10 条于 2018 年增补)——除非适用经授权的 gizlilik(保密)决定,否则 YÖK Ulusal Tez Merkezi 会以电子方式开放论文。YÖK 的常见问题解答指出,没有固定的最长禁运期限;不要声称有“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 论文(土耳其语 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 的格式,否则请将其转换为上述格式。也可选择生成 BibTeX @phdthesis / @mastersthesis,并设置 note = {YÖK Ulusal Tez Merkezi, Tez No. NNNNNN}。
报告前自查
- 是否分别进行了土耳其语和英语查询,并使用了能通过子字符串匹配的词干?
- 进行原创性检查时,是否将
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 套件的一部分。