keeb/swamp-mal
1
0
Fork 0
Code Projects Releases Packages Wiki Activity
MyAnimeList integration for swamp — anime metadata search and seasonal catalog lookup via the Jikan API
1 commit 1 branch 0 tags 30 KiB
  • TypeScript 100%
Find a file
Exact
keeb 353b121986 Initial release: MyAnimeList integration 
@keeb/mal-lookup model — anime metadata search and seasonal catalog
lookup via the Jikan API. Synced from canonical local development copy
in swamp-media. Manifest pinned at 2026.05.06.1.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 15:47:14 -07:00
extensions/models Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
.gitignore Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
.swamp.yaml Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
CLAUDE.md Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
LICENSE.txt Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
manifest.yaml Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00
README.md Initial release: MyAnimeList integration 2026-05-06 15:47:14 -07:00

README.md

@keeb/mal

MyAnimeList integration for swamp. Wraps the public Jikan API behind structured swamp methods for anime metadata search and seasonal catalog research. One resource per show.

Installation

swamp extension install @keeb/mal

Models

@keeb/mal/lookup

Search MAL and pull seasonal catalogs. No credentials required — Jikan is a public scraping proxy with a ~1 req/s rate limit on the free tier.

models:
  - name: mal
    type: "@keeb/mal/lookup"

Methods

Method Args Description
search query, limit? (default 5) Search MAL by title, write top N results as anime resources
research year, season (winter/spring/summer/fall) Pull every show for a given season, one anime resource per unique show 
swamp model method run mal search --query "frieren"
swamp model method run mal research --year 2026 --season spring

Resource: anime

Identity: slugified title. Attributes include malId, title, titleEnglish, titleJapanese, type, episodes, status, score, scoredBy, rank, synopsis, genres, themes, demographics, season, year, studios, and url.

Resources have infinite lifetime with a garbage-collection retention of 50 versions per identity.

Rate limits

The Jikan free tier permits roughly one request per second. The research method paginates through full seasonal catalogs and sleeps 1s between pages to stay under the limit. Expect a few seconds of runtime for a typical season fetch.