Search Commands
Search for movies, TV shows, episodes, and games across multiple databases.
Movie Search
Search for movies and view detailed information.
/movie query:<title>Parameters:
query(required) - Movie title to search for
Features:
- TMDB integration for comprehensive movie data
- OMDB integration for additional ratings
- Rotten Tomatoes scores (Critics & Audience)
- IMDb ratings and links
- Trakt.tv integration
- Letterboxd links
- Release dates and runtime
- Cast and crew information
- Genre and content ratings
- Streaming availability via JustWatch
Example:
/movie query:Big Trouble in Little ChinaTV Show Search
Search for TV shows and view series information.
/tv query:<title>Parameters:
query(required) - TV show title to search for (optionally include episode name)
Features:
- Complete series information
- Season and episode counts
- Air dates and network info
- Cast and crew details
- Ratings from multiple sources
- Streaming availability
- Episode guide links
Example:
/tv query:Stranger ThingsEpisode Search
Search for specific episodes of TV shows.
/episode show:<show-name> episode:<episode>Parameters:
show(required) - Name of the TV showepisode(required) - Episode title or number (e.g., "Sandkings", "s3e11", "3x11")
Features:
- Episode-specific information
- Air dates
- Episode summaries
- Guest cast
- Ratings and reviews
Example:
/episode show:The Outer Limits episode:Sandkings
/episode show:Stranger Things episode:s1e1Episode List
View a list of all episodes in a season.
/episode-list series:<show-name> season:<number>Parameters:
series(required) - Name of the TV showseason(required) - Season number (integer)
Features:
- Complete season overview
- Episode titles and air dates
- Episode numbers and descriptions
- Quick navigation to specific episodes
Example:
/episode-list series:Breaking Bad season:5Game Search
Search for video games and view detailed information.
/game query:<title>Parameters:
query(required) - Game title to search for
Features:
- RAWG database integration
- Release dates and platforms
- Metacritic scores
- Genre and tags
- Developer and publisher info
- Store links
- Screenshots and trailers
Example:
/game query:The Legend of Zelda Tears of the KingdomBoard Game Search
Search for board games and view detailed information.
/boardgame query:<title>Parameters:
query(required) - Board game title to search for
Features:
- BoardGameGeek database integration
- Player count and playtime
- Complexity ratings
- User ratings and rankings
- Categories and mechanics
Example:
/boardgame query:CatanSearch Tips
Exact Matches
Use the full, exact title for best results:
/movie query:The Thing 1982Partial Matches
The bot will find the closest match if the exact title isn't found:
/tv query:mandalorian
→ Finds "The Mandalorian"Year Disambiguation
Include the year to distinguish remakes or similar titles:
/movie query:Total Recall 1990
/movie query:Total Recall 2012Special Characters
The search handles special characters and punctuation automatically:
/tv query:It's Always Sunny in PhiladelphiaRate Limiting
Search commands are subject to rate limiting to prevent spam:
- Per-user cooldown: 3 seconds between searches
- Guild-wide limit: Depends on server configuration
- Abuse detection: Repeated rapid searches trigger automatic cooldowns
See Rate Limiting for more information.
API Data Sources
The Movie Database (TMDB)
- Required - Primary data source
- Movies, TV shows, episodes
- Images, cast, crew
- Get API Key
OMDB
- Optional - Additional ratings
- IMDb scores and details
- Get API Key
Trakt.tv
- Optional - Watch tracking
- Social features
- Get API Key
RAWG
- Optional - Game database
- Screenshots and trailers
- Get API Key
Troubleshooting
"No results found"
- Check spelling of the title
- Try searching with just keywords
- Include release year for disambiguation
- Verify the content is in the database
"Rate limit exceeded"
- Wait for the cooldown to expire
- Check server rate limiting configuration
- Contact server administrators if limits seem incorrect
Missing information
- Ensure all API keys are configured
- Some older or obscure titles may have limited data
- Try alternative search terms or titles
