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#

bash

pip install requests tmdbsimple

Capabilities#

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

Commands#

CommandDescriptionExamplerecommendRecommend titlespython3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py recommend [args]``searchSearch / filter titlespython3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py search [args]``detailTitle detailspython3 scripts/skills/movie-advisor/scripts/movie_advisor_tool.py detail [args]

Usage (from repository root)#

bash

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.

PlatformRoleOfficial siteNetflixSubscription SVOD; strong originals & licensed cataloghttps://www.netflix.comYouTubeRentals/purchases ( YouTube Movies & TV), free ad-supported titles, creator film channelshttps://www.youtube.com/moviesAmazon Prime VideoIncluded with Prime in many regions; add-on channelshttps://www.primevideo.com**Disney+**Disney, Pixar, Marvel, Star Wars, Nat Geohttps://www.disneyplus.comMax (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 Onehttps://tv.apple.comHuluUS-focused SVOD (Disney bundle in US)https://www.hulu.com**Paramount+**Paramount, CBS, Showtime (where available)https://www.paramountplus.comPeacockNBCUniversal (US)https://www.peacocktv.comCrunchyrollAnime & 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)#

markdown

# 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#

• TMDb API
• OMDb API
• Public APIs — entertainment

Patterns & community#

• Daily YouTube digest (OpenClaw use case)
• Hacker News — recommendation engines
• Reddit r/MovieSuggestions

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.