Skip to main content
Npm logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 12
  • Triggers: 0
  • Slug: NPM
  • Version: 20261101_00

Tools

Slug: NPM_DELETE_USER_TOKEN_LEGACYTool to delete a user authentication token using the legacy endpoint. Use when you need to revoke or remove a specific token from the npm registry.

Input Parameters

string
required
Token UUID/key to delete (e.g., ‘a1df1599-b022-4f1b-86c5-ee7a1df48f48’). This is the token identifier returned by the list tokens endpoint.
string
One-time password for two-factor authentication, if required by the user account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_ALL_PACKAGES_DOWNLOAD_POINTGet total npm registry download statistics for all packages for a specified time period. Returns aggregate download counts across the entire npm registry with start/end dates. Supports preset periods (last-day, last-week, last-month, last-year) or custom date ranges (YYYY-MM-DD:YYYY-MM-DD).

Input Parameters

string
required
Time period for downloads. Supported formats: (1) Preset periods: ‘last-day’, ‘last-week’, ‘last-month’, ‘last-year’. (2) Explicit date range: ‘YYYY-MM-DD:YYYY-MM-DD’ (max 365 days). Data available from 2015-01-10 onwards.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_DOWNLOAD_COUNTS_POINTGet total npm download counts and start/end dates for a single package, including scoped packages, over a preset period or custom date range.

Input Parameters

string
required
Time period for downloads. Supported formats: (1) Preset periods: ‘last-day’, ‘last-week’, ‘last-month’, ‘last-year’. (2) Explicit date range: ‘YYYY-MM-DD:YYYY-MM-DD’ (max 365 days for bulk queries, 18 months otherwise). Data available from 2015-01-10 onwards.
string
required
Name of the npm package to fetch download counts for. Supports single packages (e.g., ‘express’) and scoped packages (e.g., ‘@babel/core’). For multiple packages, query them individually as the bulk query format returns a different response structure.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_DOWNLOAD_COUNTS_RANGE_PACKAGETool to get download counts for an npm package over a specified date range. Use when you need historical daily download data.

Input Parameters

string
required
End date (inclusive) in YYYY-MM-DD format; must be the same or after start date
string
required
Start date (inclusive) in YYYY-MM-DD format
string
required
Name of the npm package, including optional scope (e.g., ‘@babel/core’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_DOWNLOAD_RANGE_ALLTool to get daily download counts for all npm packages over a specified period. Use when you need aggregate download statistics across the entire npm registry.

Input Parameters

string
required
Time period for downloads. Supported formats: (1) Preset periods: ‘last-day’, ‘last-week’, ‘last-month’, ‘last-year’. (2) Explicit date range: ‘YYYY-MM-DD:YYYY-MM-DD’ (e.g., ‘2023-01-01:2023-01-31’). Data available from 2015-01-10 onwards.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_REGISTRY_CHANGESFetch a batch of npm registry changes for replication, with optional sequence and limit controls. Returns a CouchDB-style change feed for following registry updates.

Input Parameters

integer
Maximum number of changes to return. Default is 1000, maximum is 10000.
integer
Sequence number to start from when retrieving changes. Use to continue from a previous position in the feed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_REGISTRY_METARetrieves npm registry metadata via meta endpoints. Use ‘ping’ to verify registry connectivity or ‘whoami’ to get the authenticated username.

Input Parameters

string ("ping" | "whoami")
required
Meta subpath to call; either ‘ping’ (check registry connectivity) or ‘whoami’ (get authenticated username).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_GET_VERSION_DOWNLOADSTool to get download counts for specific versions of a package over the last 7 days. Use when you need to understand which versions are most popular.

Input Parameters

string
required
Name of the npm package, including optional scope (e.g., ‘@babel/core’). For scoped packages, the ’/’ will be automatically encoded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_QUERY_BULK_SECURITY_ADVISORIESTool to bulk query security advisories for multiple npm packages. Use when you need to check vulnerability information for multiple packages and versions at once.

Input Parameters

object
required
JSON object mapping package names to arrays of version strings. Example: {“express”: [“4.17.1”], “lodash”: [“4.17.20”]}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_REGISTRY_GET_PACKAGETool to fetch metadata for a specified npm package. Use after confirming the exact package name, including scope. Responses can be large; prefer reading top-level fields like ‘dist-tags’, ‘description’, and ‘license’ rather than scanning the entire object.

Input Parameters

string
required
Name of the npm package to fetch, including optional scope (e.g., ‘@babel/core’).
string
Specific version or dist-tag to fetch (e.g., ‘latest’, ‘1.2.3’). If omitted, returns abbreviated metadata for all versions. Use ‘dist-tags.latest’ as the authoritative stable version; do not infer it from ‘versions’ or ‘time’ maps, which may include pre-releases or deprecated entries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_REGISTRY_GET_ROOTFetches npm registry root metadata including total package count and update sequence. Returns database statistics from the npm replication service. No parameters required. Use this to get current registry statistics like the total number of packages available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NPM_REGISTRY_SEARCH_PACKAGESSearch npm registry packages matching a search term. Results are returned in an objects array with package metadata and search scores.

Input Parameters

integer
Number of results to return (1-250). Default is 20.
string
required
Search query for packages (name, keywords, or description). Combine specific keywords (e.g., ‘react cli’, ‘testing framework’) to avoid loosely related results from broad queries.
integer
Offset for pagination. Default is 0.
number
Quality weight (0.0-1.0). Default is 1.0.
number
Popularity weight (0.0-1.0). Default is 1.0.
number
Maintenance weight (0.0-1.0). Default is 1.0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not