npm Trends

Fetch and compare download statistics for npm packages using the official npm registry API.

Usage

<your-skill-directory>/npm-trends/scripts/npm_trends.ts <package1> [package2] ... [options]

Options

Option Description

--period

Time period: last-day , last-week , last-month , last-year . Default: last-month

--range

Custom date range: YYYY-MM-DD:YYYY-MM-DD (overrides --period )

--daily

Show daily breakdown (with --range )

--trends

Show weekly trends with growth analysis and ASCII chart

--weeks

Number of weeks for trend analysis (default: 12, max: 52)

Examples

Compare packages (last month totals):

<your-skill-directory>/npm-trends/scripts/npm_trends.ts skills add-skill

Weekly trend analysis (recommended for comparison):

<your-skill-directory>/npm-trends/scripts/npm_trends.ts skills add-skill --trends

Extended trend analysis (6 months):

<your-skill-directory>/npm-trends/scripts/npm_trends.ts react vue --trends --weeks 26

Custom date range:

<your-skill-directory>/npm-trends/scripts/npm_trends.ts express fastify --range 2025-01-01:2025-01-25

Output

Basic mode

• Total downloads and daily average

• Comparison ranking with bar chart

Trends mode (--trends )

• Weekly download totals

• Growth rate (overall and recent 4 weeks)

• Momentum indicator (📈 accelerating, ➡️ steady, 📉 decelerating)

• ASCII chart showing weekly downloads

• Crossover analysis (when comparing 2 packages)

• Gap analysis showing which package is gaining ground

API Reference

Uses the official npm downloads API:

• Point: https://api.npmjs.org/downloads/point/{period}/{package}

• Range: https://api.npmjs.org/downloads/range/{start:end}/{package}