Skill

movie-goat

The movie CLI that combines TMDb's discovery engine with OMDb's multi-source ratings — and ships a SQLite watchlist that flags what's streaming on your services right now.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use movie-goat

Choose if

You're running a media-recommendation agent that needs to combine TMDb's discovery engine with OMDb's multi-source ratings, plus track what's streaming on the user's services right now from a SQLite watchlist. Alternative class is calling TMDb/OMDb APIs directly or using JustWatch — pick this for the typed CLI surface, the streaming-availability overlay, and franchise-marathon planning with total runtime.

Avoid if

You need write operations against TMDb (reviews, ratings) or coverage of short-form video (YouTube, TikTok). Also avoid for live-sports / live-TV scheduling — movies and shows only. For regions where TMDb's streaming provider data is incomplete, "streaming right now" answers will be lossy.

Risk Flags

  • LOW scope CLI is read-only by design — does not create, update, delete, publish, send, or mutate remote resources. Agents needing to push reviews to TMDb/IMDb must use those services directly.
  • MEDIUM rate_limit TMDb enforces ~40 req/10s. CLI has an adaptive limiter that ramps down on 429 automatically. Long actor filmography expansions can fan out aggressively — use `--since YEAR` to scope.
  • LOW data_quality Depends on external API availability (TMDb, OMDb). Both have had outages in the past; no offline fallback for fresh ratings (cache helps for already-fetched titles).

Cost

Type: Free · Free tier: The CLI binary is free. Both upstream APIs are free: TMDb v3 API key (free) and OMDb key (free, optional). No paid tier required for the documented use cases.

Install

Default

npx -y @mvanhorn/printing-press install movie-goat
# Configure free TMDb + (optional) OMDb keys:
export TMDB_API_KEY=<your-tmdb-v3-key>
export OMDB_API_KEY=<your-omdb-key-optional>

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js 18+ (via npx) or Go 1.26.3+ for source install

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT