tmdb

What This Skill Does

The TMDb skill for OpenClaw provides a powerful interface for interacting with The Movie Database (TMDb) API. It serves as a comprehensive entertainment assistant, enabling users to search for movies and television shows, retrieve detailed cast and crew metadata, view real-time streaming availability, and generate intelligent, personalized content recommendations. Whether you are looking for specific actor filmographies, trending media, or advanced discovery based on genres and ratings, this skill bridges the gap between raw data and your media consumption.

Installation

To integrate this skill into your environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/dbhurley/tmdb

Ensure you have your TMDb API key ready, as you must set the TMDB_API_KEY environment variable for the script to authenticate and fetch data from the provider.

Use Cases

This skill is designed for film enthusiasts and power users who want to automate their entertainment research. It is particularly effective for managing "watchlists" by allowing you to add or remove titles directly via the CLI. Furthermore, its integration with the Plex skill allows for an automated feedback loop where your recent watch history informs the recommendation engine, ensuring that suggestions are tailored to your actual viewing habits. By storing preferences as notes via the ppl skill, the agent maintains context across sessions, remembering which genres you love and which you prefer to avoid.

Example Prompts

1. "Find out where I can stream the movie Inception right now and show me the lead cast."
2. "Recommend some sci-fi movies released in 2024 that have a rating of at least 7.5."
3. "Add Dune: Part Two to my watchlist and tell me what other movies I might like based on my current preferences."

Tips & Limitations

To maximize the utility of the TMDb skill, take advantage of the explicit genre filters and regional availability options. Note that while searching by title is convenient, using internal IDs (such as the integer IDs provided by TMDb) will always yield more precise results for movie details or watchlist management. The personalization feature is most effective when the Plex skill is configured, as it provides the necessary historical data to refine the recommendation algorithm. Be aware that the API rate limits are governed by TMDb's terms, and users should ensure their environment variables are properly exported to avoid failed requests during peak usage.