Agent skill · magnus919
tmdb-cli
Search and discover movies, TV shows, and trending content via The Movie
What it needs
About 3k tokens when loaded.
What this skill does
tmdb-cli — Movie & TV Discovery from the Terminal Search movies and TV shows by keyword, discover by genre/certification/rating/date, check trending and upcoming releases, browse genre lists, and view US certification ratings — all from TMDb's v3 API. Setup 1. Get a free API key or access token at themoviedb.org/settings/api 2. Set one of these environment variables: --help and --dry-run work without credentials (lazy auth). Essential Commands movie search — Search movies by keyword Shows: title, release year, vote average. movie discover — Discover movies by genre, certification, rating, and date movie upcoming — Upcoming movie releases tv search — Search TV shows by keyword Shows: name, first air year, vote average. tv discover — Discover TV shows by genre, rating, and air date trending — Trending content across day or week genre list — Browse available genres certification — View US movie certification ratings Global Flags These flags work in any position before, between, or after subcommands: Known Gotchas Genre name matching is case-insensitive — --genre Horror, --genre horror, and --genre HORROR all work. Names are matched via substring, so --genre sci matches "Sci-Fi" and "Science Fiction". Certifications are US-only — The --certification flag and the certification subcommand only return/accept US ratings (G, PG, PG-13, R, NC-17). International certifications are not available. API version — This CLI wraps TMDb API v3. Endpoints and response shapes follow the v3 spec. Pagination defaults — Every command defaults to 10 results. Use --limit to get more. The CLI does not auto-paginate beyond the first page. Now-playing is defined — The movie now-playing subcommand is registered in argparse and maps to the TMDb /movie/nowplaying endpoint. References scripts/tmdb-cli — The CLI binary. Built following the cli-builder patterns: non-interactive, --json, --dry-run, --quiet, --verbose, dual-output via emit(), lazy auth, structured logging. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/tmdb-cli