npm Public Registry API：包元数据与版本查询

npm 官方仓库文档列出包元数据、指定版本与搜索接口的 GET 相对路径及 JSON 字段。本附件没有单独确证 API base URL、认证、费用或限流；仅文档整理，未实测。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：软件供应链／npm 公共包与版本元数据 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 48687ce7b8ea48f3304d1be82bd567ff366fd59204a03cad2d48e0ffef8cf6ae

本卡聚焦 Public Registry API 的 GET /{package} 与 GET /{package}/{version}。文档将包元数据称为 packument，描述 dist-tags、versions、依赖和分发链接，并另列搜索参数及示例。分发 tarball 的 URL 模板不直接替代 API base URL 声明。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-0806525017377ae56c25dfbc · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-0806525017377ae56c25dfbc
名片版本: 2
资料更新: 2026-10-24T17:08:32.7505650+00:00
原作者 / 提供者: npm
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

package：包名；/{package}/{version} 的 version 可为版本号或 latest。
搜索另用 /-/v1/search，text 为全文查询，size 默认20、最大250，from 为偏移量；质量、流行度和维护度权重另有参数。

输出

包元数据文档 packument：字段含 name、description、dist-tags、versions、time、author、repository、readme。
版本信息含 name、version、dependencies、devDependencies、scripts、license 及 dist 中的 shasum、tarball 链接等。
搜索示例含 objects、total、time 及评分字段；文档中的样例时间、版本和统计不是当前查询结果。

使用方式

类型: HTTP 接口
入口: 未知
HTTP 方法: GET

鉴权：未知。本附件未明确公开元数据 GET 的认证要求，标题 Public 不等于完整的认证保证。

运行前提

依据附件相对路径查询 package，或 package 与 version；完整 API base URL 待明确证据补充。
本附件出现 registry.npmjs.org 的 tarball URL 模板，但不将分发模板自动视作全部 API 的 host 契约。
只整理文档，不使用 npm、下载 tarball、执行 scripts 或调用 registry。

公开请求示例

{
  "method": "GET",
  "notes": "\u76F8\u5BF9\u8DEF\u5F84\u793A\u4F8B\uFF0C\u5C1A\u7F3A\u672C\u9644\u4EF6\u72EC\u7ACB\u786E\u8BC1\u7684 API base URL\uFF1B\u672A\u6267\u884C\u3002",
  "path": "/{package}",
  "path_parameters": {
    "package": "yargs"
  }
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。唯一附件未声明 API 收费或免费额度。

价格来源 · 未知

资料去向

提供者服务器。文档描述公共 registry 的远程包查询，未给查询日志与保留政策。本次未发送包名、凭据、文件或执行包内容。

限制

本文只列相对 API 路径；本卡未补造完整 GET 调用地址。
latest 是允许的版本参数或 dist-tag，不在本卡推断其必然代表最新正式版本。
scripts 和 tarball 是元数据字段，不代表应执行脚本或下载包。
本页没有明确认证、API 费用、调用配额、限流、数据新鲜度或 SLA；旧示例不可视为现行实际响应。

仍需核对

本附件独立确证的 API base URL、认证、费用、限流、配额和 SLA 未知。
当前包的实际版本、响应格式兼容性及数据完整性未实测。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T17:06:15.4527040+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

registry/docs/REGISTRY-API.md at main · npm/registry · GitHub · 官方文档 · 2026-10-25T01:06:15.452704+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
  "final_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
  "status_code": 200,
  "title": "registry/docs/REGISTRY-API.md at main \u00B7 npm/registry \u00B7 GitHub",
  "description": "npm registry documentation. Contribute to npm/registry development by creating an account on GitHub.",
  "checked_at": "2026-10-24T17:06:15.452704\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-0806525017377ae56c25dfbc",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。