Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man npm-package-stats

/npm-package-stats

agentutility / web-probe / npm-package-stats
PRICE / CALL
$0.003
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobe
CATEGORY
uncategorized
STATUS
live
NAME
npm-package-stats npm package stats / npm registry lookup / npm downloads / package release history / lightweight package metadata
SYNOPSIS
POST https://x402.agentutility.ai/npm-package-stats
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

npm package stats / npm registry lookup / npm downloads / package release history / lightweight package metadata. Fetches the public npm registry record for a package and returns description, license, repository, latest version, total version count, recent versions with publish timestamps and deprecation flags, age in days, days since last release, maintainer count + list, and downloads for the last day, week, month, year. Lightweight companion to package-risk-npm — same registry, but just the numbers, no LLM risk synthesis. Public npm registry (registry.npmjs.org + api.npmjs.org), no auth, commercial use permitted under the npm Public Registry Open Source Terms.

INPUTrequest schema
propertytypedescriptionreq?
packagestringnpm package name. Supports scoped names ('@types/node', '@vercel/next').required
recent_versionsnumberHow many most-recent version entries to include. 1-20. Default 5.optional
OUTPUTresponse shape
fieldtypedescription
packagestringEcho of the requested package name.
namestringCanonical package name as recorded in the npm registry document.
descriptionstringPackage description string from the registry document. null if unset.
licensestringLicense identifier (e.g. 'MIT') extracted from the registry document. null if unset.
homepagestringHomepage URL from the registry document. null if unset.
repositorystringRepository URL from the registry document. null if unset.
keywordsarrayPackage keywords array from the registry document.
latest_versionstringCurrent 'latest' dist-tag from the registry.
total_versionsnumberTotal number of versions ever published with timestamps in the registry.
recent_versionsarrayMost-recent N versions, each with version string, published ISO timestamp, and deprecated boolean.
first_publishedstringISO timestamp of the earliest version publish. Useful for age math.
last_publishedstringISO timestamp of the most recent version publish.
age_daysnumberDays since the first publish.
days_since_last_releasenumberDays since the most recent publish — staleness signal.
maintainer_countnumberCount of registered maintainers on the package.
maintainersarrayFirst 10 maintainer usernames.
downloadsobjectObject with last_day, last_week, last_month, last_year integer download counts from api.npmjs.org. Individual fields may be null if the registry returned an error for that window.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/npm-package-stats \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# MCP packages on npm under
# @agentutility/mcp-*  (one per cluster)
#
# Catalog + install:
# https://mcp.agentutility.ai
#
# Or call npm-package-stats directly over HTTP — see above.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
web-probenpmpackage-statsdownloadsregistrydependency
methods
POST
cluster
webprobe
price
$0.003 USDC per call
ADJACENTother endpoints in webprobe
endpointdescriptionprice
crates-io-statsCrates.io package stats / Rust crate registry lookup / cargo package metadata / Rust ecosystem stats.$0.003
homoglyph-checkHomoglyph attack detector / Unicode lookalike scanner.$0.003
jwt-decodeJWT decoder / token inspector / debug tool.$0.003
pypi-package-statsPyPI package stats / Python package registry lookup / pip package metadata / pypistats downloads / Python ecosystem metadata.$0.003
url-metadata-extractURL metadata extractor / OG tags / Open Graph parser / Twitter Card parser / meta tag extractor / link preview / page metadata / favicon…$0.003
arxiv-bibtexarXiv to BibTeX / arxiv citation generator / paper bibtex / LaTeX citation builder / academic citation lookup.$0.002
github-readmeGitHub README fetch / repo readme / open-source-readme-as-markdown / package documentation puller.$0.002
keyword-suggestKeyword autocomplete / search suggest / SEO keyword research / query expansion / autocomplete suggestions.$0.002
SEE ALSO
agentutility · webprobe · x402 · mcp · llms.txt · registry.json · bazaar.x402.org