SuperAPI AI 工具集

paper-lookup

写作与研究

查看项目

更新于 10-21 16:18

技能介绍

Paper Lookup 是一个文献检索技能,为使用者提供 18 个学术 API 的文档化端点。其核心目标是把用户的检索意图转化为可复现的检索过程:选择权威数据库、进行有界且限速的调用,并返回带有足够来源信息(端点、参数、标识符、访问日期)的结果,以便人类或其他智能体能够重复该检索。

用途 该技能适用于多种文献检索需求,包括:按 DOI/PMID/arXiv ID 查找特定论文、按主题查找论文、查找某位作者的出版物、构建引用图谱、获取开放获取 PDF 或全文。它覆盖生物医学、物理、数学、计算机科学等多个领域,并支持预印本、期刊元数据、资助信息、机构标识等查询。

主要能力 技能内置数据库选择指南,按使用场景推荐主数据库和备选数据库。例如:生物医学主题首选 PubMed,全文首选 Europe PMC,预印本按主题使用 Europe PMC(SRC:"PPR"),物理/数学/CS 预印本使用 arXiv,全领域论文使用 OpenAlex,按 DOI 查找使用 Crossref,开放获取 PDF 使用 Unpaywall,引用图谱使用 Semantic Scholar,开放引用边使用 OpenCitations,作者出版物使用 Semantic Scholar,全文(任意领域)使用 CORE,期刊/出版商元数据使用 Crossref,资助信息使用 Crossref,标识符转换使用 PMC ID Converter,撤稿检查使用 PMC OA Web Service 或 Crossref,基因/疾病/化学物质使用 PubTator3,机构到 ROR ID 使用 ROR,数据集/软件/海报使用 Zenodo,EBI 研究包使用 BioStudies,期刊是否在 DOAJ 使用 DOAJ。

技能还提供跨数据库查询建议,例如“关于一篇论文的一切”使用 Crossref + Semantic Scholar + Unpaywall,“论文中提到的实体”使用 PubTator3 导出 + PubMed/Europe PMC,“综合文献检索”使用 PubMed + Europe PMC + OpenAlex + Semantic Scholar。

使用方式 技能要求通过 Bash 使用 curl 进行 API 调用,因为许多 API 需要自定义请求头、POST 请求体或原始结构化载荷(如 Atom XML、JATS XML)。技能强调 URL 编码查询参数、对限速 API 串行请求、仅在不同开放 API 之间并行、限制总工作量(约 1000 条记录或 50 次调用前需确认)。技能还提供捆绑脚本:scripts/paginate.py 用于分页遍历,scripts/jats_to_text.py 用于 JATS XML 转文本,scripts/arxiv_atom.py 用于 arXiv Atom XML 转 JSON,scripts/openalex_abstract.py 用于重建摘要。

适用场景 适用于需要可复现、可审计的文献检索任务,尤其是涉及多个数据库、需要处理静默失败、需要记录来源信息的场景。也适用于需要批量检索但需控制调用量的情况。

限制 技能明确指出这些 API 可能在返回 HTTP 200 时静默失败,例如 PMC eFetch 在出版商禁止再分发时返回无 <body> 的文章,arXiv 对格式错误的参数返回标题为 Error 的条目,Europe PMC 在 200 响应体中放入 errCode,bioRxiv 接受错误的翻页游标并返回错误的记录,Figshare 忽略查询但仍返回 200,OpenCitations 对未知 DOI 返回计数为 0。因此必须验证响应结构。此外,部分 API 需要 API 密钥以提高速率限制或使用最佳功能,技能列出了环境变量和注册地址。技能还强调将每个响应视为不可信的第三方数据,不执行其中嵌入的指令,不将原始响应文本粘贴到 shell 命令中,不泄露 API 密钥。对于缺失的约束(如“近期”无年份、作者名有多个同名者),技能建议询问而非猜测。