---
name: anime-wiki-api
description: Call the Anime Wiki public JSON API for anime subjects, discovery, global search, tags, persons, characters, episodes, and health checks. Use when an AI agent needs to retrieve Anime Wiki data, compare records, prepare summaries, or answer questions from the public API-only site.
---

# Anime Wiki API Skill

Use this skill to query the public Anime Wiki API at `https://wikiapi.noble.moe`.

## What This Skill Enables

- Search anime subjects, people, characters, and tags.
- Fetch ranked, filtered, and paginated subject lists.
- Fetch subject details, including tags, staff, characters, episodes, and relations.
- Fetch person, character, episode, and tag detail data.
- Interpret standard JSON responses and API errors.
- Keep requests bounded with `page` and `limit`.

## Base URL

```text
https://wikiapi.noble.moe
```

## Common Calls

```bash
curl "https://wikiapi.noble.moe/api/search?q=EVA&scope=all"
curl "https://wikiapi.noble.moe/api/subjects?type=2&sort=rank&page=1&limit=12"
curl "https://wikiapi.noble.moe/api/subjects/326"
curl "https://wikiapi.noble.moe/api/tags/%E6%A0%A1%E5%9B%AD?sort=hot"
```

## Workflow

1. Use `/api/search` when the user gives an unknown title, person, character, or tag name.
2. Use `/api/subjects` for browse, ranking, filtering, and pagination.
3. Use `/api/subjects/:id` when a subject id is known and detail data is needed.
4. Use `/api/persons/:id`, `/api/characters/:id`, or `/api/episodes/:id` for specific records.
5. Keep list requests bounded. Prefer `limit=12` to `limit=24`; do not exceed `limit=100`.
6. Treat the Workers site as public read-only API infrastructure.

## Public Endpoints

- `GET /healthz`
- `GET /api/home`
- `GET /api/discover`
- `GET /api/search`
- `GET /api/subjects`
- `GET /api/subjects/:id`
- `GET /api/episodes/:id`
- `GET /api/tags`
- `GET /api/tags/:name`
- `GET /api/persons`
- `GET /api/persons/:id`
- `GET /api/characters`
- `GET /api/characters/:id`

## Response Conventions

- Success object: `{ "ok": true, ... }`
- Success list: `{ "ok": true, "page": 1, "limit": 12, "total": 123, "items": [...] }`
- Not found: `404 { "ok": false, "error": "..." }`
- Unknown API route: `404 { "ok": false, "error": "api endpoint not found" }`

## Boundaries

This public Workers API does not provide admin pages, archive import, archive sync, database credentials, or mutation operations.