# NPM Registry Search (Markdown Format)

> NPM Registry Search (Markdown Format) is a paid API for AI agents from x402-v2-mint-npm-search.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Searches the npm registry by keyword and returns results formatted as Markdown, including package name, version, description, weekly downloads, and links.

## Facts

- Endpoint: POST https://x402-v2-mint-npm-search.vercel.app/v1/npm-search/fmt/markdown?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/npm-registry-search-markdown-format-914b1746
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wPuNH3YrWN5BsznihVAIe

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 npm-registry-search-markdown-format-914b1746 -d '<json body>'
```

Example prompt: Search npm for packages related to 'csv parsing' and show me the top 5 results — include each package's name, version, description, weekly downloads, and links, formatted as markdown.

## When to prefer this

Use this endpoint when you need npm package search results already formatted as Markdown — ideal for agents that will display or forward results directly in a Markdown-supporting interface. Prefer it over JSON-format siblings when the consumer expects human-readable output. It requires no API key, only a micro-payment per call, making it suitable for keyless agent workflows using the x402 payment protocol.

## Known failure modes

- Empty or invalid search text returns HTTP 400 with charged:false — no charge applied
- Size parameter exceeding 20 is rejected or clamped
- npm registry unavailable may cause timeouts or errors
- Very niche or misspelled queries may return zero results, triggering 400 with no charge

## Output

A Markdown-formatted list of up to 20 npm packages matching the search query. Each result includes the package name, current version, description, weekly download count, and relevant links (e.g., npm page, homepage, repository). Returns a 400 error with charged:false if the query yields no valid results.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/npm-registry-search-markdown-format-914b1746/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-npm-search.vercel.app](https://www.zero.xyz/host/x402-v2-mint-npm-search.vercel.app/llms.txt)