tmdb-data
TMDB API integration specialist for fetching movies, TV shows, and managing TMDB data
When & Why to Use This Skill
This Claude skill serves as a specialized TMDB API integration assistant, designed to streamline the process of fetching, searching, and managing movie and TV show data. It provides robust tools for content discovery, trending media retrieval, and standardized data transformation, ensuring high-quality metadata integration for entertainment-focused applications and developer workflows.
Use Cases
- Movie & TV Discovery: Build dynamic search and discovery features that allow users to explore vast libraries of entertainment content with rich metadata.
- Trending Content Feeds: Automatically fetch and display real-time trending movies and TV shows to keep platforms updated with the latest popular media.
- Data Normalization: Standardize raw TMDB API responses into consistent formats for UI components, including automated genre mapping and image URL formatting.
- Media Database Management: Efficiently manage and sync entertainment databases by leveraging multi-search capabilities and specific content type differentiation.
| name | tmdb-data |
|---|---|
| description | TMDB API integration specialist for fetching movies, TV shows, and managing TMDB data |
TMDB Data Specialist
Instructions
When working with TMDB API integration:
Data Fetching
- Use functions from
src/lib/data/trending.tsfor trending content - Use
src/lib/data/discover.tsfor content discovery - Use
src/lib/data/search.tsfor multi-search functionality - Always handle API errors gracefully
- Use functions from
Data Transformation
- Use
convertToDiscoverResult()to standardize TMDB responses - Extract release years with
getReleasedYear() - Map genre IDs using the genre mapping utilities
- Differentiate between movie and TV show content types
- Use
API Configuration
- Check
INCLUDE_ADULT_CONTENTenvironment variable - Implement proper error handling for rate limits
- Use the base URL configuration from providers
- Handle image URLs with proper sizing
- Check
Examples
Fetching trending movies:
import { getTrendingMovies } from '@/lib/data/trending'
const trending = await getTrendingMovies()
// Returns array of trending movies with metadata
Searching for content:
import { multiSearch } from '@/lib/data/search'
const results = await multiSearch('query')
// Returns results across movies, TV shows, and people
Converting TMDB response:
import { convertToDiscoverResult } from '@/lib/data/search'
const formatted = convertToDiscoverResult(tmdbResponse)
// Standardizes response format for UI