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:

pi install npm:pi-nyaa

This installs 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:

pi install -l npm:pi-nyaa

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

/reload

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

pi -e npm:pi-nyaa

Load from this repository

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

extensions/nyaa.ts

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

For a one-off run from another directory:

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

Examples

Ask pi:

用 nyaa_search 在 nyaa 查詢 "frieren"，依 seeders 排序，列出前 5 筆。

用 nyaa_view 查 nyaa id 2097677，不要 description，只列 category、size 和 files。

用 nyaa_search 在 sukebei 查詢 "test"，limit 3。

Notes

• site is required and must be nyaa or sukebei.
• sukebei is the adult index; request it explicitly.
• 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.