mcpField
A
alterlab-yok-tez

alterlab-yok-tez

github.com/alterlab-ieu生产力7857 次安装5 周前更新
代码仓库

关于 alterlab-yok-tez

面向研究人员和导师的技能,用于检索土耳其国家论文中心的研究生论文、核查选题是否已有相关记录,并整理引用。它通过 yoktez-mcp 搜索和提取元数据,不用于批量下载全文。

主要功能

  1. 01土耳其语与英语配对检索
  2. 02按主题、作者和导师搜索
  3. 03筛选论文类型、状态与年份
  4. 04提取论文详情和摘要
  5. 05生成土耳其语 APA-7 引用

适用场景

  1. 01为文献综述查找土耳其学位论文
  2. 02在提交提案前核查选题新颖性
  3. 03查找特定导师指导的论文
  4. 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.json
references/
access_legal.md
citation_apa7.md
endpoints.md
search_syntax.md
scripts/
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(艺术专业能力)。它是本技能支持的两项教师工作流的权威来源:

  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。目前维护良好的社区方案是 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。

  1. 搜索能适配子串匹配的词干。 默认匹配方式为 包含,因此 sürdürülebilir 可以找到所有变形形式——但土耳其语中,词尾的 k/ç/t/p 在接后缀前会变为 ğ/c/d/b,所以要截短词尾:okuryazarl 找到了 622 条标题结果,而 okuryazarlık 找到了 277 条(2025 年起,实时检查)。
  2. 每次调用最多使用三个词项,以 and/or 连接(对应网站上的 VE/VEYA)。没有 NOT 运算符——请在本地筛除不需要的结果。
  3. 同时运行土耳其语和英语查询。 英语词项只会匹配英语标题/摘要/关键词字段,因此全土耳其语查询会漏掉以英语编入索引的论文,反之亦然。
  4. 有目的地选择字段。 按主题尽可能全面检索时使用 search_field 7(Tümü);精确检索时使用 1/6/4/5;搜索作者和导师时使用 2/3。

原创性/指导教师核查(可重复使用的流程)

当指导教师询问 “这个论文选题已经有人做过了吗?” 时:

  1. 在 search_field 7 中构建成对的土耳其语 + 英语查询(词干,同义词用 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 会返回土耳其语和英语摘要)。
  • İ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 套件的一部分。

评论

支持 Markdown