Magnus Hedemarkandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
bd92ed3fca
- Replace raw-argv dispatch with parsed-attribute routing; add the documented nested `genre list --type movie|tv` subparser while keeping the flat legacy form a clean argparse rejection instead of a crash. - Route `tv search` through client.search_tv (/search/tv) with TV formatting (name / first_air_date) via new cmd_tv_search. - Gate find --source to exactly the official eight external_source values (imdb_id, facebook_id, instagram_id, tvdb_id, tiktok_id, twitter_id, wikidata_id, youtube_id); docs explicitly reject retired freebase_mid/freebase_id; SKILL.md documents both --type variants. Adds parser-level regression tests for genre list, endpoint-selection and output-shape tests for tv search, and parameterized acceptance and rejection tests for external_source values (13 tests, 10 subtests, green under pytest strict-markers, unittest discover, and the proxy trap). Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
TMDb Metadata Skill
Why Install This Skill
Give your agent a dependable terminal workflow for exploring movie and television metadata without hand-building every HTTP request. It can start from a title, an IMDb ID, or a discovery filter, then enrich the result with credits, recommendations, images, and provider metadata.
The skill also makes TMDb's easy-to-miss rules visible: choose one authentication mode, respect the 500-page ceiling, use the correct nested /find response, and URL-encode compound provider paths.
What You Get
| Path | Purpose |
|---|---|
SKILL.md |
Setup, commands, recipes, gotchas, and routing |
scripts/tmdb |
Executable JSON-capable CLI for search, detail, find, discovery, and trends |
scripts/test_tmdb.py |
Offline pytest/unittest coverage with mocked HTTP behavior |
references/auth-pagination-and-errors.md |
Authentication, pagination, errors, rate limits, and image construction |
references/find-and-details.md |
External IDs, IMDb entry points, details, credits, and compound responses |
references/search-discover-trending.md |
Search, discovery filters, trending, genres, and certifications |
evals/evals.json |
Runnable examples covering normal and negative routing |
Quick Start
export TMDB_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
tmdb movie search --term "Dune" --limit 5 --json
tmdb find tt0111161 --source imdb_id --json
tmdb movie detail 550 --append credits,videos --json
Triggers
Load this skill when the request involves movie or TV metadata, title search, IMDb/TVDB resolution, credits, release dates, certifications, recommendations, images, trending media, or provider metadata.
Requirements
- Python 3.8 or newer
requestsPython package- A TMDb API Read Access Token or v3 API key
jqfor the shell pipeline examples
This is a read-oriented metadata workflow. It does not play media, search torrents, or maintain personal watch history.