npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

papersearch

v0.7.1

Published

PaperSearch: an agent-friendly command for searching and downloading academic papers from multiple sources.

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 -y

Windows 上这条命令需要 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 和补充材料怎么取,都按各自出版社的实际情况来,下载更准、更少漏篇。优化的出版社主要有:

    • 综合:Elsevier(含 Cell、Lancet)、Springer Nature(含 Nature、BMC)、Wiley、Oxford Academic、Taylor & Francis、Sage、PNAS、Science
    • 医学:NEJM、JAMA、AHA、ASH、Wolters Kluwer、Karger、Thieme
    • 理工:ACS、IEEE、ACM
    • 完整列表见 出版社支持表
    • 需要支持别的出版社,欢迎提 Issue,附上一篇你有权限的文章 DOI;适配规则会持续维护和更新。
  • 验证框自动点击:遇到人机验证,程序自动定位并点击,网站放行后继续下载;过不去才提醒你。

  • 后台下载不打扰:浏览器在后台工作。屏幕角落的进度胶囊显示进度;需要你登录学校或手动验证时变成琥珀色,点一下就切到浏览器,处理完程序接着下载。

安装:

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 查看全部工具和参数。

更新记录:每个版本按安装与配置、检索与核对、开放下载、学校订阅下载、进度窗口、下载结果、文档七个方面列出。

路线图

接下来计划做这几件事:

  1. 进度胶囊优化:提醒时机更准,学校登录页能自动放行时不提前打扰;减少 Windows 上浏览器启动、换页时短暂跳到前台的情况,优化显示效果。
  2. 并行下载:不同出版社之间并行下载,同时处理多篇,缩短几十上百篇的总耗时;每家出版社仍遵守下载上限。
  3. 检索论文、搜正文片段再优化:参考同类工具的做法,进一步提升检索论文和搜正文片段的效果。

完整计划见 路线图,原理和代码结构见 架构说明。还想要什么功能,欢迎提 Issue 和 PR;下载失败或想支持某家出版社,请用对应的 Issue 模板,想自己加出版社规则见 school/CONTRIBUTING.md。

致谢

License

AGPL-3.0,另提供商业授权。