메뉴
Reference for the Plex Media Server REST API. Use when adding, debugging, or extending Plex API calls (library/section queries, sessions, playback, collections, server identity, response schemas).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Launch, build, run, start, screenshot, or smoke-test the Librariarr Next.js webapp end-to-end. Use when asked to run librariarr, bring up the dev stack, take a screenshot of the dashboard or any UI page, verify a change in the running app, or check that the app boots cleanly.
Generate a new Next.js API route with project boilerplate (auth, validation, sanitize, Prisma). Use when creating new API endpoints.
Generate an integration test for an API route with all required mocks and boilerplate. Use when creating tests for API endpoints.
Quick reference for all Librariarr project conventions and patterns. Consult when writing or reviewing code to verify correct patterns.
Create a Prisma migration file for schema changes. Required for production — db push only works in dev. Use after modifying schema.prisma.
Scaffold a complete new feature end-to-end (Prisma model, migration, schemas, API routes, tests). Use for new CRUD resources or features that span multiple layers.
| name | plex-api |
| description | Reference for the Plex Media Server REST API. Use when adding, debugging, or extending Plex API calls (library/section queries, sessions, playback, collections, server identity, response schemas). |
Plex does not publish a stable server-fetchable URL for its OpenAPI spec — the official developer site (https://developer.plex.tv/) only offers it via a browser-side blob: URL that changes on every page load and cannot be hit with curl.
Primary (recommended) source — LukeHagar/plex-api-spec:
https://raw.githubusercontent.com/LukeHagar/plex-api-spec/main/plex-api-spec.yaml
This is the community-maintained OpenAPI 3.1 spec that powers the Speakeasy-generated official Plex SDKs. Stable URL, kept in sync with PMS releases.
Official (volatile) alternative: browse to https://developer.plex.tv/, click "Download" to save openapi.json locally, then query the local file. Use this if the LukeHagar mirror looks stale or you need to verify against the upstream source.
Auth is the X-Plex-Token: <token> header (security scheme name token in the spec). Most identifying client headers (X-Plex-Client-Identifier, X-Plex-Product, etc.) are also expected on real calls — check components.parameters for the canonical list.
The spec is YAML, not JSON — use yq (mikefarah, v4) directly, or pipe through yq -o json into jq:
curl -sL <url> | yq '.paths | keys'curl -sL <url> | yq '.paths."/library/collections"'curl -sL <url> | yq '.components.schemas.Metadata'curl -sL <url> | yq -o json | jq '[.paths | to_entries[] | select(.value | .. | .tags? // [] | index("Library")) | .key]'curl -sL <url> | yq '.tags[].name'curl -sL <url> | yq '{security: .components.securitySchemes, headers: (.components.parameters // {} | to_entries | map(select(.value.in == "header")) | from_entries)}'