用途
Paper Lookup 让使用者通过 10 个学术论文数据库的 REST API 检索研究论文、预印本和学术文章。其核心任务是判断哪些数据库最适合用户的查询，调用它们并返回结果。
主要能力
覆盖的数据库分为四类：
- 生物医学文献：PubMed（3700 万+ 生物医学引文、摘要、MeSH 词）、PMC（1000 万+ 全文生物医学文章，JATS XML，支持 ID 转换）。
- 预印本服务器：bioRxiv（生物学预印本，按日期/DOI 浏览，无关键词搜索）、medRxiv（健康科学预印本，按日期/DOI 浏览，无关键词搜索）、arXiv（物理、数学、计算机、生物、经济学预印本，支持关键词搜索，返回 Atom XML）。
- 多学科索引：OpenAlex（2.5 亿+ 作品、作者、机构、主题、引用数据）、Crossref（1.5 亿+ DOI 元数据、期刊、资助方、参考文献）、Semantic Scholar（2 亿+ 论文、引用图、AI 生成的 TLDR、推荐）。
- 开放获取与全文：CORE（全球 OA 仓库 3700 万+ 全文）、Unpaywall（任意 DOI 的 OA 状态与 PDF 链接）。
使用方式
核心工作流为：理解查询（按 DOI 找特定论文、按主题找论文、找作者出版物、找开放获取 PDF、找全文）→ 选择数据库（可多库并行）→ 阅读 references/ 下对应参考文件（含端点细节、查询格式、示例调用）→ 发起 API 调用 → 返回结果。
返回内容始终包括：每个数据库的原始 JSON 响应（arXiv 为解析后的 XML）、所查询数据库及具体端点列表；若某查询无结果，会明确说明而非省略。
不同平台使用不同的 HTTP 抓取工具：Claude Code 用 WebFetch（回退 curl via Bash）、Gemini CLI 用 web_fetch（回退 curl via shell）、Windsurf 用 read_url_content（回退 curl via terminal）、Cursor/Codex CLI/Cline 无专用抓取工具，使用 curl。
适用场景
- 生物医学主题论文：PubMed，可辅以 Semantic Scholar、OpenAlex。
- 生物医学文章全文：PMC，可辅以 CORE。
- 生物学/健康预印本：bioRxiv、medRxiv，可辅以 Semantic Scholar、OpenAlex。
- 物理、数学、CS 预印本：arXiv。
- 全领域论文：OpenAlex、Semantic Scholar、Crossref。
- 按 DOI 找特定论文：Crossref，可辅以 Unpaywall、Semantic Scholar。
- 找开放获取 PDF：Unpaywall，可辅以 CORE、PMC。
- 引用图、作者出版物、论文推荐：Semantic Scholar，可辅以 OpenAlex。
- 任意领域全文：CORE；生物医学全文：PMC。
- 期刊/出版商元数据、资助方信息：Crossref、OpenAlex。
- PMID/PMCID/DOI 互转：PMC（ID Converter）。
- 按日期找近期预印本：bioRxiv、medRxiv、arXiv。
跨库查询示例：论文全貌（元数据+引用+OA）用 Crossref + Semantic Scholar + Unpaywall；综合文献检索用 PubMed + OpenAlex + Semantic Scholar；查找并阅读论文用 PubMed（查找）+ Unpaywall（OA 链接）+ PMC 或 CORE（全文）；预印本及其发表版本用 bioRxiv/medRxiv + Crossref；作者概览与引用指标用 Semantic Scholar + OpenAlex。
标识符与访问
常用标识符格式：DOI（10.xxxx/xxxxx，所有数据库）、PMID（整数，PubMed/PMC/Semantic Scholar）、PMCID（PMC+数字，PMC/Europe PMC）、arXiv ID（YYMM.NNNNN，arXiv/Semantic Scholar）、OpenAlex ID（W+数字）、Semantic Scholar ID（40 位十六进制）、ORCID、ISSN。Semantic Scholar 接受 DOI、PMID、PMCID、arXiv ID 前缀；OpenAlex 接受 DOI 和 PMID 前缀；PMC ID Converter 可在 PMID、PMCID、DOI 间转换。
API 密钥：NCBI（PubMed、PMC）的 NCBI_API_KEY 非必需（无密钥 3 req/s，有密钥 10 req/s）；CORE 的 CORE_API_KEY 全文访问必需；Semantic Scholar 的 S2_API_KEY 非必需；OpenAlex 的 OPENALEX_API_KEY 推荐。bioRxiv/medRxiv、arXiv、Crossref、Unpaywall 完全开放无需密钥。密钥加载顺序：先检查环境变量，再回退 .env，最后在低速率限制下继续并告知用户缺失的密钥及获取方式。
限制
- bioRxiv 和 medRxiv 不支持关键词搜索，只能按日期/DOI 浏览。
- arXiv 返回 Atom XML 而非 JSON，需解析或提取字段。
- PMC eFetch 全文返回 JATS XML。
- 速率限制：NCBI 无密钥 3 req/s、有密钥 10 req/s，需顺序请求；arXiv 每 3 秒最多 1 次请求；Crossref 公共 5 req/s、礼貌池（带 mailto）10 req/s。遇到 HTTP 429 应短暂等待后重试一次。
- 错误恢复：检查标识符格式、尝试替代标识符、换用其他数据库，并向用户报告失败情况。
- 结果过大时展示最相关部分并说明还有更多数据，但默认展示完整原始 JSON。