Dify Tool Plugin - The Movie Database (TMDB)

This plugin allows you to search The Movie Database (TMDB) for movies, TV shows, and people. It provides comprehensive metadata and information from TMDB's extensive entertainment database.

Features

Movie Search: Search for movies by title, keywords, or phrases
TV Show Search: Search for TV shows by name, keywords, or phrases
Multi Search: Combined search for movies, TV shows, and people in a single request

Setup

Register for a TMDB account at https://www.themoviedb.org
Generate an API Read Access Token (v4 auth) at https://developer.themoviedb.org/reference/intro/authentication
Install the plugin in your Dify instance
Configure the plugin with your TMDB API Read Access Token

Usage

Movie Search

Search for movies by title or keywords:

Parameters:
- (required): Movie title or keywords
- (optional): ISO 639-1 language code (default: en-US)
- (optional): Filter by release year
- (optional): Number of results to return (1-20, default: 5)

TV Show Search

Search for TV shows by title or keywords:

Parameters:
- (required): TV show title or keywords
- (optional): ISO 639-1 language code (default: en-US)
- (optional): Filter by first air date year
- (optional): Number of results to return (1-20, default: 5)

Multi Search

Search for movies, TV shows, and people in a single request:

Parameters:
- (required): Search keywords
- (optional): ISO 639-1 language code (default: en-US)
- (optional): Whether to include adult content (default: false)
- (optional): Number of results to return (1-20, default: 10)

Development

Requirements

Python 3.12+
Dify Plugin SDK

Local Development

Clone this repository
Create a virtual environment and install dependencies:
Copy to and configure your development environment
Run the plugin:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This plugin uses the TMDB API
Data and images provided by The Movie Database (TMDB)