Get npm Package Information

Retrieve detailed metadata for a specific npm package.

Usage

npx tsx scripts/info.ts <package-name> [options]

Arguments

| Argument | Required | Description | |----------|----------|-------------| | package-name | Yes | The exact package name (case-sensitive) |

Options

| Option | Description | |--------|-------------| | --no-cache | Bypass cache and fetch fresh data from API |

Output

react
------
Description: React is a JavaScript library for building user interfaces.
Latest: 18.2.0
License: MIT
Homepage: https://react.dev
Repository: https://github.com/facebook/react

Versions (last 5):
  18.2.0 - Published 2022-06-14
  18.1.0 - Published 2022-04-26
  18.0.0 - Published 2022-03-29
  17.0.2 - Published 2021-03-10
  17.0.1 - Published 2020-12-20

Maintainers:
  - @hzoo
  - @acdlite

Script Execution (Preferred)

npx tsx scripts/info.ts <package-name> [options]

Options:

--no-cache - Bypass cache and fetch fresh data from API

Run from the npm-registry plugin directory: ~/.claude/plugins/cache/npm-registry/

Package Metadata API

GET https://registry.npmjs.org/{package}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | package | Yes | The exact package name (case-sensitive) |

Examples

Get package metadata:

https://registry.npmjs.org/react

Response Format

The response contains comprehensive package metadata:

name - Package name
versions - Object mapping version numbers to full version metadata
dist-tags - Tags like latest, next, canary
time - Timestamps for each version publish
maintainers - Array of package maintainers
description - Package description
homepage - Project homepage URL
repository - Repository information (type, URL)
bugs - Bug tracker URL or email
license - License identifier
author - Author information
keywords - Array of keywords
dependencies - Production dependencies (per version)
devDependencies - Development dependencies (per version)
peerDependencies - Peer dependencies (per version)

Repository URL Formats

The registry accepts various repository URL formats:

https://github.com/owner/repo
git+https://github.com/owner/repo
git@github.com:owner/repo
ssh://git@github.com/owner/repo

These are automatically parsed and normalized.

Caching

Package metadata is cached for 6 hours. Versions change infrequently, and most metadata remains stable between releases.

Use the --no-cache flag to bypass the cache.

Use npm-search to find packages before getting details
Use npm-exists for a quick availability check
Use npm-downloads to see usage statistics

Error Handling

Package not found: If the package doesn't exist, you'll receive a 404 response. Use npm-exists to check availability first.

Invalid package name: Package names must be valid npm package names (lowercase, can contain hyphens, underscores, periods).

Scope issues: For scoped packages like @babel/core, include the scope in the name.

npm-info