关于 alterlab-dergipark
alterlab-dergipark 是用于从 TÜBİTAK ULAKBİM 的期刊平台 DergiPark 可复现地获取元数据和文章文件的技能。它面向需要期刊记录、文章引文、PDF 或期刊范围信息的研究者,通过 OAI-PMH 和文章页面获取数据,而非访问受验证限制的搜索页。
主要功能
- 01通过 OAI-PMH 收集期刊记录
- 02将文章元数据解析为 BibTeX 或 RIS
- 03获取文章 PDF 链接
- 04读取期刊宗旨与范围
- 05查看期刊自述的收录列表
适用场景
- 01收集某期刊的文章档案
- 02将文章引文导出为 BibTeX 或 RIS
- 03获取 DergiPark 文章 PDF
- 04查看期刊范围和自述收录情况
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alterlab-ieu/ alterlab-academic-skills --skill alterlab-dergipark安装后在 Claude Code 中输入/alterlab-dergipark确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/endpoints.mdindexing.mdoai-cookbook.mdscripts/article_meta.pydergipark_oai.pyjournal_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 的交叉核查提示。
防止错误答案的三条规则
- 出版日期 ≠ OAI 时间戳。 OAI
<datestamp>表示平台的重新索引时间,而不是出版日期。要按出版年份筛选,先采集,再在本地按dc:date过滤——不要依赖from/until。 - PDF ID ≠ 文章 ID。 从页面的
citation_pdf_url元标签中获取 PDF 链接(例如,文章/10对应/en/download/article-file/9);切勿根据文章 ID 拼出 PDF 链接。 - 托管 ≠ 收录。 文章托管在 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 套件。