开源轻量网页工具|一键批量查询NPM包历史下载量
文章目录
项目简介
一款纯前端网页工具,无需后端服务,直接调用 NPM 官方开放接口,用来查询NPM包的累计下载总量、分段下载数据,并绘制每日下载趋势图。
项目全面支持中英双语 :网页界面、项目README文档均提供中英文版本,国内、海外开发者都可以顺畅使用。
支持两种查询模式:
- 单包查询:输入包名,查看该包总下载量、首次发布日期、分段统计数据以及下载趋势折线图;
- 按作者批量查询:输入NPM作者用户名,一次性获取该作者名下全部公开包,自动汇总所有包的下载总量。
项目基于原生HTML+CSS+JavaScript开发,无重型框架依赖,部署简单,提供两个在线访问地址:
- Netlify 在线访问:https://npm-download-stats.netlify.app/
- GitHub Pages在线访问:https://dxiangwiki.github.io/npm-download-stats/
页面展示


✨ 功能特性
- 双查询模式:单包查询 / 作者批量查询
- 展示信息:包名称、总下载次数、首次发布时间、分段统计数据、每日下载趋势图
- 批量查询:自动遍历作者名下全部公开包,自动计算全部包下载总和
- 中英双语界面自由切换,README文档同样提供中英文版本
- 深色/浅色主题切换,浏览器本地持久记忆语言与主题偏好
- 纯前端实现,无后端,所有请求直接访问NPM官方API
- 页面底部附带数据免责提示与开源版权声明(MIT License)
🛠 使用方式
- 打开任意一个在线页面链接;
- 选择查询模式:
Single Package Query(单包查询) /Batch by Author(按作者批量查询); - 在输入框填写NPM包名或者NPM作者账号;
- 点击
Query按钮,等待接口请求完成,即可查看结果与趋势图表。
提示:
- NPM官方接口存在访问频率限制,批量查询大量包时,部分包有可能请求失败。
- NPM下载统计数据最早仅可追溯至2015年左右。
- 下载计数为安装次数,不等于独立用户数,CI/自动化重复安装会被多次统计。
- 国内用户访问NPM官方API可能出现网络超时。
- 页面底部提示:温情提示:该数据仅供参考,实际下载量可能因统计方式不同而有所差异。
🚀 本地部署 & 在线部署
本地运行
- 克隆仓库
bash
git clone https://github.com/dxiangwiki/npm-download-stats.git
cd npm-download-stats
- 在本地直接打开
index.html文件即可使用。
在线部署
支持两种静态托管方案:GitHub Pages、Netlify,直接上传静态文件即可一键上线。
📌 项目仓库地址
💡 写在最后
平时开发NPM包时,经常希望快速查看包的累计下载数据,尤其想要一次性统计同一个作者名下所有包的总下载量。
市面上很多工具大多只支持单包查询,批量统计作者全部包的工具较少,于是开发了这款轻量纯前端网页。
项目代码完全开源,网页与README均做了中英双语适配,方便国内外开发者使用。欢迎大家Star、Fork,也可以提交PR继续扩展功能。
