npms-suggest

# Get npm Package Name Suggestions (NPMS.io)

Get package name suggestions and autocomplete from NPMS.io based on a search query.

## Usage

```bash
npx tsx scripts/suggest.ts <query> [options]
```

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `query` | Yes | Search query (minimum 2 characters) |

### Options

| Option | Description |
|--------|-------------|
| `--size=N` | Number of suggestions to return (default: 25, max: 250) |
| `--no-cache` | Bypass cache and fetch fresh data from API |

### Output

```
Suggestions for "react" (25 results)
------------------------------------

1. react
   Score: 1000000
   URL: https://www.npmjs.com/package/react

2. react-dom
   Score: 950000
   URL: https://www.npmjs.com/package/react-dom

3. react-redux
   Score: 923000
   URL: https://www.npmjs.com/package/react-redux

...

Top 10 suggestions:
  react, react-dom, react-redux, react-router, react-scripts,
  react-native, react-hook-form, react-query, react-test-renderer
```

## Script Execution (Preferred)

```bash
npx tsx scripts/suggest.ts <query> [options]
```

Options:
- `--size=N` - Number of suggestions to return (default: 25, max: 250)
- `--no-cache` - Bypass cache and fetch fresh data from API

Run from the npms-io plugin directory: `~/.claude/plugins/cache/npms-io/`

## Suggestions API

```
GET https://api.npms.io/v2/search/suggestions?q={query}
```

### Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `q` | Yes | Search query (minimum 2 characters) |

### Examples

Get suggestions:
```
https://api.npms.io/v2/search/suggestions?q=react
```

Scoped packages:
```
https://api.npms.io/v2/search/suggestions?q=@babel
```

## Response Format

The response contains an array of package suggestions:

```json
[
  {
    "name": "react",
    "score": 1000000,
    "searchScore": 1000000
  },
  {
    "name": "react-dom",
    "score": 950000,
    "searchScore": 950000
  }
]
```

**Fields:**
-