# pi-nyaa

Project-local pi extension for querying public metadata from:

- <https://nyaa.si/>
- <https://sukebei.nyaa.si/>

The extension registers two tools:

- `nyaa_search` — searches RSS metadata and returns titles, categories, size, dates, swarm counts, comments, and view-page URLs.
- `nyaa_view` — fetches one `/view/<id>` page and returns public metadata, description, and file list.

The tools intentionally do **not** return torrent download links or magnet links.

## Install / load

### Install from npm

This extension is published as an npm pi package:

```bash
pi install npm:@narumitw/pi-nyaa
```

This installs `@narumitw/pi-nyaa` into your global pi settings, so `nyaa_search` and `nyaa_view` are available in all pi sessions.

To install it only for the current project, write it to the project-local `.pi/settings.json` instead:

```bash
pi install -l npm:@narumitw/pi-nyaa
```

After installing, restart pi. If pi is already running, use:

```text
/reload
```

You can also load the npm package for a single run without installing it:

```bash
pi -e npm:@narumitw/pi-nyaa
```

### Load from this repository

This repository also places the extension in pi's conventional package path:

```text
extensions/nyaa.ts
```

Start `pi` from this repository, then run `/reload` if pi was already open.

For a one-off run from another directory:

```bash
pi -e /home/narumi/workspace/pi-nyaa/extensions/nyaa.ts
```

## Examples

Ask pi:

```text
Use nyaa_search to search for "ばにぃうぉ～か～", sort by seeders, and list the top 5 results.
```

```text
Use nyaa_search on nyaa to search for "frieren", sort by seeders, and list the top 5 results.
```

```text
Use nyaa_view for nyaa id 2097677. Do not include the description; only list category, size, and files.
```

```text
Use nyaa_search on sukebei to search for "test" with limit 3.
```

## Notes

- `site` accepts `nyaa` or `sukebei`; `nyaa_search` defaults to `sukebei` when omitted.
- `sukebei` is the adult index; pass `site: "nyaa"` for the non-adult index.
- `category` accepts raw Nyaa category IDs such as `0_0` or `1_2`.
- Search output is capped at 50 items and tool output is truncated to pi's default limits.