mcpField
A
alterlab-dergipark

alterlab-dergipark

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

关于 alterlab-dergipark

alterlab-dergipark 是用于从 TÜBİTAK ULAKBİM 的期刊平台 DergiPark 可复现地获取元数据和文章文件的技能。它面向需要期刊记录、文章引文、PDF 或期刊范围信息的研究者,通过 OAI-PMH 和文章页面获取数据,而非访问受验证限制的搜索页。

主要功能

  1. 01通过 OAI-PMH 收集期刊记录
  2. 02将文章元数据解析为 BibTeX 或 RIS
  3. 03获取文章 PDF 链接
  4. 04读取期刊宗旨与范围
  5. 05查看期刊自述的收录列表

适用场景

  1. 01收集某期刊的文章档案
  2. 02将文章引文导出为 BibTeX 或 RIS
  3. 03获取 DergiPark 文章 PDF
  4. 04查看期刊范围和自述收录情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alterlab-ieu/alterlab-academic-skills --skill alterlab-dergipark

安装后在 Claude Code 中输入/alterlab-dergipark确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
endpoints.md
indexing.md
oai-cookbook.md
scripts/
article_meta.py
dergipark_oai.py
journal_info.py

详细介绍

DergiPark — 国家期刊收录器(TÜBİTAK ULAKBİM)

DergiPark(https://dergipark.org.tr)是 TÜBİTAK ULAKBİM 的国家级期刊托管平台——截至其主页(2026-09)所示,平台基于 OJS 基础设施,收录了 3,000 多种土耳其学术期刊。此技能通过唯一稳定的机器接口——平台级 OAI-PMH(开放档案计划元数据收割协议)端点以及开放的文章页面,以可复现的方式收录元数据、摘要和全文 PDF。它绝不猜测书目信息——每个字段都来自实时端点,并根据解析后的元标签在本地生成 BibTeX/RIS。

交互式搜索页面设有人机验证挑战,因此此技能不会通过普通 HTTP 抓取搜索结果。通过 OAI 集合收录和直接获取文章页面是可靠的途径(参见 references/oai-cookbook.md)。

何时使用此技能

当请求涉及从 DergiPark 获取数据时,使用此技能:

  • 收录 / 获取某份土耳其(DergiPark)期刊的所有文章
  • 列出期刊存档或查找其 slug
  • 获取 DergiPark 文章的 BibTeX 或 RIS(一种导出格式)
  • 下载 DergiPark 全文 PDF
  • 阅读期刊的宗旨与范围(öz/kapsam — 摘要/范围)或其自我声明的索引列表

你可能会看到的标准土耳其语术语:öz(摘要)、kapsam(范围)、dergi(期刊)、künye(引文/刊头)。所有面向用户的字符串都应保留土耳其语变音符号(例如 Mülkiye Dergisi)。

不会触发此技能 — 将相关请求转给对应的其他技能
请求实际涉及……转给
期刊是否被 TR Dizin 收录(国家引文索引)/其 TR Dizin 状态alterlab-trdizin
查找/搜索研究生论文(YÖK Ulusal Tez Merkezi)alterlab-yok-tez
学者的个人资料 / 隶属机构(YÖK Akademik)alterlab-yok-akademik
大学专业录取统计数据(YÖK Atlas)alterlab-yokatlas
计算 doçentlik(副教授资格)资格分数alterlab-docentlik-eligibility
计算 akademik teşvik(学术激励)分数alterlab-akademik-tesvik
将稿件/数据存入 Aperta(TÜBİTAK 开放存档)alterlab-aperta
验证引用的参考文献是否存在 / 幻觉审查alterlab-citation-verifier
土耳其 APA / TR Dizin 写作风格规范alterlab-tr-academic-style

工作原理 — 三个脚本

所有脚本均在技能目录中通过 uv run python 运行。无需 API 密钥。每个脚本都优先使用 requests(如果已安装),否则回退到标准库 urllib。完整操作指南和注意事项请参见 references/oai-cookbook.md;经核实的端点表请参见 references/endpoints.md。

1. scripts/dergipark_oai.py — OAI 收录(主要途径)
# The slug (== OAI setSpec) is in the journal URL: dergipark.org.tr/en/pub/{slug}
# list-journals only sees the first 100 sets — ListSets stopped paging (2026-09-23)
uv run python scripts/dergipark_oai.py list-journals --tsv | rg -i "mülkiye"

# Harvest a whole journal (follows resumptionToken paging automatically)
uv run python scripts/dergipark_oai.py harvest mulkiye --prefix oai_dc --out mulkiye.json

# One article's structured oai_dc record
uv run python scripts/dergipark_oai.py get 10 --prefix oai_dc

动词:Identify / ListSets / ListRecords / GetRecord。前缀: oai_dc(解析为简洁字段)和 oai_mods / oai_marc / oai_etdms (以原始记录 XML 返回,供需要更丰富架构的调用方使用)。

2. scripts/article_meta.py — 单篇文章 → BibTeX / RIS
uv run python scripts/article_meta.py /en/pub/mulkiye/article/10 --format bibtex
uv run python scripts/article_meta.py /en/pub/mulkiye/article/10 --format ris
uv run python scripts/article_meta.py /en/pub/mulkiye/article/10 --format json

解析页面的 citation_* + DC.* 元标签,并在本地生成 BibTeX/RIS ——不会调用站点上的任何导出后端(该途径未经核实)。JSON 输出包含已解析的 pdf_url。

3. scripts/journal_info.py — 宗旨与范围 + 自我声明的索引
uv run python scripts/journal_info.py mulkiye --lang en

返回宗旨与范围文本和 /indexes 页面;后者附有 DISCLAIMER 免责声明以及指向 TR Dizin 和 DOAJ 的交叉核查提示。

防止错误答案的三条规则

  1. 出版日期 ≠ OAI 时间戳。 OAI <datestamp> 表示平台的重新索引时间,而不是出版日期。要按出版年份筛选,先采集,再在本地按 dc:date 过滤——不要依赖 from/until。
  2. PDF ID ≠ 文章 ID。 从页面的 citation_pdf_url 元标签中获取 PDF 链接(例如,文章 /10 对应 /en/download/article-file/9);切勿根据文章 ID 拼出 PDF 链接。
  3. 托管 ≠ 收录。 文章托管在 DergiPark 上,并不能说明其质量或是否被 TR Dizin 收录。/indexes 页面内容为自行声明,未经 DergiPark 核实。要获取权威的 TR Dizin 状态判定,请转至 alterlab-trdizin。参见 references/indexing.md。

优雅降级

网络故障会在 stderr 上显示为 network_unavailable / oai_error JSON 对象(退出码为 1)——这些脚本绝不会伪造记录或判定。如果端点无法访问,请如实说明并停止;不要凭记忆编造元数据。

参考资料

  • references/endpoints.md — 所有已验证的端点、前缀和标识符方案(并注明明确标记为 UNVERIFIED 的内容);于 2026-06-06 实时观测。
  • references/oai-cookbook.md — 可直接复制粘贴的操作示例:slug 查询、完整采集、按年份筛选、PDF 下载,以及通过 Playwright 绕过搜索限制的方法。
  • references/indexing.md — DergiPark 与 TR Dizin 的区别,以及如何对照 TR Dizin 和 DOAJ 核查实际收录情况。

属于 AlterLab Academic Skills 套件。

评论

支持 Markdown