# supremeai npm package lookup

> supremeai npm package lookup is a paid API for AI agents from agents.supremeai.ca, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Looks up an npm package by name and returns its latest version, license, repository, dependency count, and weekly download stats.

## Facts

- Endpoint: POST https://agents.supremeai.ca/v1/npm/package?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/supremeai-npm-package-lookup-e2bb8a5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gpf2LwD118HU3LJ40maTw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability supremeai-npm-package-lookup-e2bb8a5d -d '<json body>'
```

Example prompt: Can you look up the npm package 'express' and tell me the latest version, its license, and how many weekly downloads it gets?

## When to prefer this

Use this endpoint when you need quick, structured npm package metadata without setting up an API key or account — ideal for AI agents that need to verify package details, check licenses, or assess popularity on the fly. Prefer over scraping npm's website or using the full npm registry API when you only need summary stats and want a simple pay-per-call model.

## Known failure modes

- Package not found — returns an error if the package name does not exist on npm
- Scoped package name malformed — incorrect use of '@scope/pkg' format may return an error
- Network/upstream timeout — npm registry may be temporarily slow or unavailable
- Payment failure — USDC payment not confirmed, request not processed

## How this service works

Pay-per-call tools for AI agents: x402 pre-flight checks (is this endpoint safe to pay?), web pages as clean markdown (with optional JavaScript rendering), Latin American tax-ID validation, npm/PyPI/GitHub lookups, and URL health checks. No API keys, no accounts — pay per request in USDC.

## Output

Returns a JSON object with the package name, latest version string, SPDX license identifier, GitHub (or other) repository URL, total number of dependencies, last publish timestamp, and weekly download count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "npm package name, e.g. 'express' or '@scope/pkg'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "express",
  "latest": "5.2.1",
  "license": "MIT",
  "repository": "https://github.com/expressjs/express",
  "dependencies": 27,
  "last_publish": "2026-01-15T00:00:00Z",
  "weekly_downloads": 30000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/supremeai-npm-package-lookup-e2bb8a5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.supremeai.ca](https://www.zero.xyz/host/agents.supremeai.ca/llms.txt)