Movie Advisor

Data & APIs

Suggests movies and TV shows based on your taste or mood, providing ratings, cast, runtime, and where to stream globally with data-backed details.

Install

openclaw skills install movie-advisor

Movie Advisor — Recommendations & Deeper Takes

Overview

Helps users pick movies and TV shows that fit their preferences, mood, or occasion, and supports short analytical takes (themes, tone, comparable titles). Use for weekend picks, group viewing, discovering lesser-known gems, or understanding a title before watching.

Trigger keywords: movie recommendation, TV show, film, what to watch, similar to [title], streaming

Prerequisites

pip install requests tmdbsimple

Capabilities

Data-backed lookups — TMDb / OMDb–style workflows for titles, ratings, cast, and metadata (see references/movie_advisor_guide.md).
Taste-aware suggestions — recommendations by genre, mood, “like this title,” or scenario (date night, family, short runtime).
Title briefs — scores, synopsis, key cast, runtime, and where to watch pointers on major global streaming services (outside mainland China’s domestic apps).

Commands

Command	Description	Example
`recommend`	Recommend titles	`python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py recommend [args]`
`search`	Search / filter titles	`python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py search [args]`
`detail`	Title details	`python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py detail [args]`

Usage (from repository root)

python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py recommend --like 'Interstellar' --count 5
python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py search --year 2026 --sort rating
python3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py detail --title 'Oppenheimer'

Major global streaming platforms (reference)

When suggesting where to watch, prefer well-known international services and official hubs. Availability varies by country and title; remind users to check their region.

Platform	Role	Official site
Netflix	Subscription SVOD; strong originals & licensed catalog	https://www.netflix.com
YouTube	Rentals/purchases (YouTube Movies & TV), free ad-supported titles, creator film channels	https://www.youtube.com/movies
Amazon Prime Video	Included with Prime in many regions; add-on channels	https://www.primevideo.com
Disney+	Disney, Pixar, Marvel, Star Wars, Nat Geo	https://www.disneyplus.com
Max (HBO catalog in many markets)	HBO originals & Warner Bros. library (branding varies by region)	https://www.max.com
Apple TV+	Apple originals; often bundled with Apple One	https://tv.apple.com
Hulu	US-focused SVOD (Disney bundle in US)	https://www.hulu.com
Paramount+	Paramount, CBS, Showtime (where available)	https://www.paramountplus.com
Peacock	NBCUniversal (US)	https://www.peacocktv.com
Crunchyroll	Anime & Asian drama (global)	https://www.crunchyroll.com

Aggregator (where to watch by country): JustWatch — useful to cross-check Netflix / Prime / Apple / etc. for a specific title.

Do not invent “available on X” without a source; when unsure, say availability is region-dependent and point to JustWatch or the platform’s own search.

Output format (for the agent’s report)

# Movie Advisor report

**Generated**: YYYY-MM-DD HH:MM

## Key picks
1. [Title — one-line why]
2. …
3. …

## Snapshot
| Title | Score / source | Genre | Runtime |
|-------|----------------|-------|---------|

## Notes
[Themes, tone, or “if you liked X” — grounded in facts you have]

## Where to watch (verify locally)
| Title | Platform hints (region-dependent) |
|-------|-----------------------------------|

References

APIs & data

Patterns & community

Notes

Base scores and metadata on API or user-provided data; do not fabricate ratings or availability.
Mark missing fields as unavailable instead of guessing.
Streaming lineups change often; region and date matter.