程序化搜索 NPM 包及其下载统计和版本历史

Source: Dev.to

NPM 包发现的问题

如果你曾经尝试以编程方式比较 NPM 包——比如用于依赖审计工具、技术雷达仪表盘，或是推荐库的 CLI——你一定体会过其中的痛点。官方的 NPM 注册表 API 繁杂且文档不足。直接抓取 npmjs.com 又非常脆弱。你真正想要的，只是一个干净的搜索端点，能够一次性返回包的元数据、下载量和版本信息。

NPM 包搜索 API

该 API 允许你按关键字搜索 NPM 包，并返回结构化结果，内容包括：

• 包名、描述和作者
• 每周和每月的下载统计
• 最新版本和发布时间
• 仓库及主页链接

一个端点，一个查询参数。返回整洁的 JSON。

示例用法

const response = await fetch(
  "https://udemy-course-search-production.up.railway.app/api/search?query=react"
);

const data = await response.json();

data.results.forEach(pkg => {
  console.log(`${pkg.name} v${pkg.version} — ${pkg.downloads} downloads/week`);
});

就是这么简单。基础使用不需要 API 密钥。你会得到一个包含所有比较或展示所需信息的匹配包的 JSON 数组。

使用场景

• 依赖审计仪表盘 – 将项目的 package.json 依赖导入此 API。标记下载量下降或版本陈旧的包。自动呈现更健康的替代方案。
• 技术栈分析器 – 构建分析 GitHub 仓库的工具？将检测到的包与此 API 交叉引用，为输出添加下载趋势和版本新鲜度信息。
• CLI 包推荐器 – 开发一个终端工具，接受使用场景（例如 “状态管理”、 “日期格式化”），返回按人气和新颖度排序的 NPM 包。

入门指南

NPM 包搜索 API 已在 RapidAPI 上提供免费层供快速开始。

NPM Package Search on RapidAPI – 订阅后获取你的 API 密钥，即可开始构建。无论是比较库、监控依赖，还是开发者工具，这个 API 都为你提供所需的数据层，免去抓取的烦恼。