Skip to main content

Shoko

@magistr/shokov2026.07.16.2· 9d agoMODELS
01README

Shoko anime metadata server API — series, episodes, files, and metadata.

Model:

  • @magistr/shoko — wraps the Shoko Server REST v3 API. Authenticate for a long-lived API key, then read server status, dashboard stats, series, episodes, files, import folders, and queue state, and trigger maintenance actions (run import, rescan a folder, remove missing files, discover available actions from the live OpenAPI spec).

The API key is marked sensitive so it is stored via the vault rather than persisted in cleartext, and the status/action-discovery endpoints work without authentication.

02Release Notes

Release 2026.07.16.2 — align model versions with manifests

Maintenance release across the @magistr extensions. For most packages this carries no functional change: the only edit is the model's version: field, brought back in line with its manifest version so the published model type version and the package version no longer drift.

Functional changes in this release are limited to:

  • anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.

  • arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.

Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.

03Models1
@magistr/shokov2026.07.16.2extensions/models/shoko.ts
fn authenticate(user: string, pass: string, device: string)
Exchange username/password for a long-lived apikey. Stash the returned key in your vault and put it in the model's globalArgs.apiKey afterward.
ArgumentTypeDescription
userstring
passstring
devicestring
fn status()
Get server init status (no auth required)
fn dashboard()
Fetch dashboard stats (series count, file size on disk, queue health, etc.)

Resources

status(infinite)— Server init status (does not require auth)
dashboard(infinite)— Dashboard stats (series count, missing episodes, etc.)
series(infinite)— Series listing or single series detail
files(infinite)— File listing (recognized, unrecognized, manually-linked, etc.)
episodes(infinite)— Episode listing (e.g., missing episodes per release management)
queue(infinite)— Queue overview (general, hasher, image, AniDB)
importFolders(infinite)— Configured import folders
actions(infinite)— Available action endpoints (Action/* in API)
task(infinite)— Result of a triggered action
auth(infinite)— Result of authenticate (apikey is sensitive — store in vault)
04Previous Versions2
2026.06.05.1
2026.05.25.1

Merge pull request #5 from umag/extensions/jscad-stl-pair

extensions: add 15 more @magistr extensions + auto-discover CI

05Stats
A
100 / 100
Downloads
1
Archive size
11.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
06Platforms
07Labels