Registries
Supported registries
Section titled “Supported registries”| Registry | Package format | Time series | Data available |
|---|---|---|---|
| npm | express, @scope/pkg |
Yes (549 days) | lastDay, lastWeek, lastMonth |
| PyPI | requests |
Yes (180 days) | lastDay, lastWeek, lastMonth, total |
| NuGet | Newtonsoft.Json |
No | total |
| VS Code | publisher.extension |
No | total (installs), rating, trends |
| Docker Hub | namespace/repo |
No | total (pulls), stars |
| GitHub Releases | owner/repo |
No | total (asset downloads), releases, assets, latestTag |
The npm registry provides the richest data with up to 549 days of daily download history. Package names can be simple (express) or scoped (@scope/pkg).
Rate limits apply — space out bulk queries or expect 429 responses on large batches.
PyPI provides 180 days of daily download history. Package names are case-insensitive and normalized (hyphens and underscores are equivalent).
NuGet only reports all-time total download counts. No time-series data is available.
VS Code Marketplace
Section titled “VS Code Marketplace”VS Code extensions use the format publisher.extension (e.g., esbenp.prettier-vscode). The marketplace reports all-time install totals, rating, and trend indicators. No weekly/monthly breakdowns.
Docker Hub
Section titled “Docker Hub”Docker Hub images use the format namespace/repo (e.g., library/node). Reports total pull counts and star counts. GHCR (GitHub Container Registry) doesn’t expose public pull counts.
GitHub Releases
Section titled “GitHub Releases”GitHub repositories use the format owner/repo (e.g., mcp-tool-shop-org/prism-verify). Reports the cumulative download count of all uploaded release assets — binaries, checksums, and SBOMs — summed across every release, plus the release/asset counts and latest tag.
GitHub only counts manually-uploaded assets; it does not report downloads of the auto-generated source zipball/tarball, so a repo with source-only releases reports 0. The count is an all-time asset-download total, and the dashboard shows that total. It does not publish a weekly figure for GitHub. Set githubToken in registry-stats.config.json (or pass githubToken on StatsOptions) to raise the API rate limit from 60 to 5000 requests/hour. The CLI reads that field and sends it as Authorization: Bearer. --init does not write a token.
Adding custom registries
Section titled “Adding custom registries”You can register custom providers for registries not built in. See the Configuration page for the registerProvider API.