papersearch
v0.7.1
Published
PaperSearch: an agent-friendly command for searching and downloading academic papers from multiple sources.
Maintainers
Readme
PaperSearch 提供 paper-search 命令和一份随包 Skill。装好后,Claude Code、Codex、DeepSeek、GLM、Kimi Code、Qwen Code、CodeBuddy 等支持本机命令调用的 AI 工具,就能替你:
- 检索论文:一次查 PubMed、Crossref、OpenAlex、Semantic Scholar、arXiv 等 20 多个数据源,按 DOI 合并重复,核对 DOI。
- 搜正文片段:利用 Semantic Scholar 收录的论文正文,搜原句,找到方法、结果的原文和出处。
- 查期刊 IF 与分区:利用 EasyScholar,查找 JCR 影响因子、JCR 分区和中科院分区。
- 查引文和参考文献:顺着一篇论文,找出引用它的研究和它引用的文献。
- 下载全文和补充材料:
演示视频
https://github.com/user-attachments/assets/c6ba529d-0b4e-4c2a-82cb-1ef8ba53274c
快速开始
1. 安装
把这句话发给你的 AI 工具(Claude Code、Codex、DeepSeek、GLM、Kimi Code、Qwen Code、CodeBuddy 等等都行):
请帮我安装 PaperSearch 的 Skill:npx skills add dr-dumpling/PaperSearch -g -yWindows 上这条命令需要 Git,没有的话先装 Git for Windows。
装好后引用 Skill,发这句:
/paper-search 请开始配置AI 会先问你要不要装 PaperSearch 的命令行程序,你同意后装好,再带你配置学校订阅下载和 API key。
2. 配置时装上学校订阅下载
说了“请开始配置”后,AI 会先问你要不要装学校订阅下载:用学校账号下载非 OA 文章的全文和补充材料,需要 Chrome(没有的话一起装)。你同意后它才安装,装完问你的学校并设好,然后弹出设置窗口。
3. 按需填 API key
说了“请开始配置”后,AI 先问你要不要用学校订阅下载,再按你的选择一步步来:
- 用学校订阅下载:API key、下载文件夹、等待时间和提醒都在设置窗口里填,每个 key 都能点“测试”。之后想改,让 AI 打开设置,或点胶囊上的齿轮。
- 不用:AI 列出还缺的 key 和申请入口(也见 API key),你在终端运行
paper-search setup填入,输入时不显示;填完 AI 逐个测试能不能用。
4. 开始使用
配置好后,引用 PaperSearch 的 Skill,说出你需要搜索的内容,比如:
| 想做什么 | 可以这样说 |
|---|---|
| 检索论文 | /paper-search 找 2020 年以来 SGLT2 抑制剂治疗心力衰竭的随机对照试验,核对 DOI |
| 搜正文片段 | /paper-search 这些试验的主要终点,原文是怎么定义的?摘几段原文 |
| 查期刊 IF 与分区 | /paper-search 它们发表在哪些期刊?影响因子和分区各是多少 |
| 查引文和参考文献 | /paper-search DAPA-HF 试验发表后,有哪些研究引用了它 |
| 下载全文和补充材料 | /paper-search 把这些论文的全文和补充材料下载到指定路径 |
拿到结果:
- 检索、正文片段、期刊指标和引文,直接在对话里列给你。
- 每次下载在下载文件夹里新建一个
年月日-时分秒_PaperSearchDownload文件夹:PDF 直接放在里面;取到了补充材料的论文单独一个文件夹,PDF、补充材料(supplements/)都在其中;每篇的 PDF 和补充材料在这一篇下载时一起完成;没拿到的篇目告诉你原因。
可选配置
功能对比:
| | 装好就能用 | API key | 学校订阅下载 | |---|:---:|:---:|:---:| | 检索 | | | | | 检索论文、查引文和参考文献 | ✅ | — | — | | 更多检索来源、限额 | — | ✅ | — | | 期刊与正文 | | | | | 查影响因子和分区 | — | ✅ | — | | 搜正文片段 | — | ✅ | — | | 下载 | | | | | 下载 OA 文章 | ✅ | — | — | | 下载非 OA 文章 | — | ✅(Elsevier、Springer) | ✅(30+主流出版社) | | 下载补充材料 | — | — | ✅ |
1. 学校订阅下载
开放渠道下不到的论文,可以借你学校的订阅来下:程序经你学校所属的学术身份联盟登录出版社,用学校账号下载。配置时只要说出学校名称,即可登录下载非OA文献。
1.通过 eduGAIN 互联,如中国CARSI、香港HKAF,新加坡SGAF等; 2.没有加入本国联盟的学校,有 OpenAthens 权限的,也能经它登录。
支持的学术身份联盟
| 大洲 | 区域 | 已支持(地区:联盟) | |---|---|---| | 亚洲 | 东亚 | 中国内地、澳门:CARSI;中国内地科研机构:CSTCloud(中国科技云联盟);香港:HKAF;日本:GakuNin(学認);韩国:KAFE;台湾:经 OpenAthens | | 亚洲 | 东南亚 | 新加坡:SGAF;马来西亚:SIFULAN;泰国、菲律宾等:经 OpenAthens | | 亚洲 | 南亚 | 印度:INFED;斯里兰卡:LIAF;孟加拉:TIGERfed;巴基斯坦:PKIFED | | 亚洲 | 西亚 | 土耳其:YETKİM;沙特阿拉伯:Maeen;塞浦路斯:CyNet;以色列:IUCC;伊朗:IRFED;阿塞拜疆:AzScienceNet;阿曼:OMREN | | 欧洲 | 西欧 | 英国:UK federation;爱尔兰:Edugate;法国:RENATER;荷兰:SURFconext;比利时:Belnet;卢森堡:eduID Luxembourg | | 欧洲 | 北欧 | 丹麦(含冰岛、格陵兰):WAYF;瑞典:SWAMID;芬兰:Haka;挪威:Feide | | 欧洲 | 中欧 | 德国:DFN-AAI;瑞士:Switch edu-ID;奥地利:ACOnet;波兰:PIONIER.Id;捷克:eduID.cz;斯洛伐克:safeID;匈牙利:eduId.hu | | 欧洲 | 南欧 | 西班牙:SIR;葡萄牙:RCTSaai;意大利:IDEM;希腊:GRNET;马耳他:RiċerkaNET;斯洛文尼亚:ArnesAAI;克罗地亚:AAI@EduHr;塞尔维亚:iAMRES;黑山:IDeduME;北马其顿:AAIEduMk;阿尔巴尼亚:RASH;保加利亚:BIF;罗马尼亚:RoEduNetID | | 欧洲 | 东欧 | 爱沙尼亚:TAAT;拉脱维亚:LAIFE;立陶宛:LITNET FEDI;白俄罗斯:FEBAS;乌克兰:PEANO;摩尔多瓦:LEAF | | 美洲 | 北美洲 | 美国:InCommon;加拿大:CAF | | 美洲 | 中美洲 | 墨西哥:FENIX | | 美洲 | 南美洲 | 巴西:CAFe;智利:COFRe;哥伦比亚:COLFIRE;厄瓜多尔:MINGA | | 大洋洲 | 澳大利亚与新西兰 | 澳大利亚:AAF;新西兰:Tuakiri | | 非洲 | 东部非洲 | 乌干达:RIF;肯尼亚:RAFIKI;坦桑尼亚:TERNET IF;马拉维:MAREN;赞比亚:FIDERN | | 非洲 | 西部非洲 | 尼日利亚:NgRENID;加纳:GARNET;布基纳法索:eduID.bf;多哥:eduID.tg | | 非洲 | 北部、南部非洲 | 摩洛哥:eduIDM;南非:SAFIRE |
各联盟的全称、学校数和实测过的学校,见 学术联盟支持表。
学校登录不上,或想支持你的学校,请用“学校登录不上”模板提 Issue,写明学校名称、官网域名,以及出问题的出版社和文章 DOI。
学校账号就能用:不用另外申请 key;出版社 API key 只覆盖 Elsevier、Springer 两家。
深度适配出版社:深度优化了下载的通用流程,并且针对 30 多家出版社逐家写了专门规则,机构登录入口在哪、PDF 和补充材料怎么取,都按各自出版社的实际情况来,下载更准、更少漏篇。优化的出版社主要有:
验证框自动点击:遇到人机验证,程序自动定位并点击,网站放行后继续下载;过不去才提醒你。
后台下载不打扰:浏览器在后台工作。屏幕角落的进度胶囊显示进度;需要你登录学校或手动验证时变成琥珀色,点一下就切到浏览器,处理完程序接着下载。
安装:
paper-search school install # 安装时选择你的学校
paper-search school status --format text # 查看是否装好进度胶囊
自动过验证
自动登录学校
需要你时提醒
结束清单
2. API key
按用途分四类,需要哪类就申请对应的 key(邮箱直接填,不用申请),再用快速开始第 3 步里的任一方式填入。
推荐配置
| 功能 | 要填的 key | 去哪里申请 |
|---|---|---|
| 查影响因子和分区 | EASYSCHOLAR_KEY | EasyScholar(申请教程) |
| 搜正文片段 | SEMANTIC_SCHOLAR_API_KEY | Semantic Scholar(申请教程) |
| 下载时找免费全文 | PAPER_SEARCH_UNPAYWALL_EMAIL | 不用申请(Unpaywall 说明) |
| 检索论文、核对 DOI 是否真实 | CROSSREF_MAILTO | 不用申请(Crossref 说明) |
下载订阅全文(非必须)
| 出版社 | 要填的 key | 去哪里申请 |
|---|---|---|
| Elsevier | ELSEVIER_API_KEY;校外下订阅文章还要 ELSEVIER_INSTTOKEN | Elsevier |
| Springer | SPRINGER_API_KEY | Springer Nature |
增加检索来源(非必须)
| 来源 | 要填的 key | 去哪里申请 |
|---|---|---|
| Web of Science | WOS_API_KEY | Clarivate |
| IEEE Xplore | IEEE_API_KEY | IEEE |
| ScienceDirect、Scopus | ELSEVIER_API_KEY(和上面同一个) | Elsevier |
| Springer | SPRINGER_API_KEY(和上面同一个) | Springer Nature |
检索更快、更稳定(非必须)
| 来源 | 要填的 key | 去哪里申请 |
|---|---|---|
| PubMed | PUBMED_API_KEY | NCBI |
| OpenAlex(被引超过 1 万篇时列全) | OPENALEX_API_KEY | OpenAlex |
| CORE | CORE_API_KEY | CORE |
| OpenAIRE | OPENAIRE_API_KEY | OpenAIRE |
配置保存在 ~/.config/paper-search-cli/config.json,只有你自己能读。下载文件夹、代理和自动更新等其他设置,见 使用说明 · 其他设置。
更多文档
使用说明:命令示例、工作方式、检索来源、Agent Skill、全部命令、排障。也可以在终端运行 paper-search tools --pretty 查看全部工具和参数。
更新记录:每个版本按安装与配置、检索与核对、开放下载、学校订阅下载、进度窗口、下载结果、文档七个方面列出。
路线图
接下来计划做这几件事:
- 进度胶囊优化:提醒时机更准,学校登录页能自动放行时不提前打扰;减少 Windows 上浏览器启动、换页时短暂跳到前台的情况,优化显示效果。
- 并行下载:不同出版社之间并行下载,同时处理多篇,缩短几十上百篇的总耗时;每家出版社仍遵守下载上限。
- 检索论文、搜正文片段再优化:参考同类工具的做法,进一步提升检索论文和搜正文片段的效果。
完整计划见 路线图,原理和代码结构见 架构说明。还想要什么功能,欢迎提 Issue 和 PR;下载失败或想支持某家出版社,请用对应的 Issue 模板,想自己加出版社规则见 school/CONTRIBUTING.md。
致谢
- 感谢 LINUX DO 社区:命令 + Skill 的路线和工作流改进来自社区交流与开源分享。
- openags/paper-search-mcp:本项目参考了它的思路,并改成独立的命令行工具。
- Dianel555/paper-search-mcp-nodejs(MIT):命令行版最初由它的 Node.js 实现改编而来。
- Rimagination/scansci-pdf(MIT):机构下载后端(
school/)借鉴了它的架构(CARSI 等联盟登录、出版社网站抓取、会话复用、PDF 捕获)。
License
AGPL-3.0,另提供商业授权。
