SKILL.md
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-skillWeekly trend analysis (recommended for comparison):
<your-skill-directory>/npm-trends/scripts/npm_trends.ts skills add-skill --trendsExtended trend analysis (6 months):
<your-skill-directory>/npm-trends/scripts/npm_trends.ts react vue --trends --weeks 26Custom date range:
<your-skill-directory>/npm-trends/scripts/npm_trends.ts express fastify --range 2025-01-01:2025-01-25Output
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}