| name | movie-tv |
| description | Search movies and TV shows, get ratings, recommendations using TMDB. Use when: user asks about movies, TV shows, ratings, 'what should I watch', trending shows. Don't use when: user asks about YouTube videos, music, or live TV schedules. |
| version | 1.0.0 |
| metadata | {"openclaw":{"emoji":"🎬","requires":{"bins":[],"env":[]}}} |
Movie & TV
Search for movies and TV shows using The Movie Database (TMDB) API.
Use when
- Movie info ("Tell me about Dune")
- TV shows ("What's Severance about?")
- Recommendations ("Movies like Inception")
- What's trending
Don't use when
- YouTube videos or online content
- Music/podcasts/audiobooks
- Live TV schedules or streaming availability
API Key
TMDB requires a free API key. Check memory for TMDB_API_KEY.
User can get free key at: https://www.themoviedb.org/settings/api
API Endpoints
Search movies
web_fetch({
url: "https://api.themoviedb.org/3/search/movie?api_key={KEY}&query=Dune"
})
Get trending
web_fetch({
url: "https://api.themoviedb.org/3/trending/all/day?api_key={KEY}"
})
Response Format
🎬 Dune: Part Two (2024)
Rating: 8.3/10
Genre: Science Fiction, Adventure
Synopsis: Follow the mythic journey...
