tmdb-data

TMDB API integration specialist for fetching movies, TV shows, and managing TMDB data

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
nametmdb-data
descriptionTMDB API integration specialist for fetching movies, TV shows, and managing TMDB data

TMDB Data Specialist

Instructions

When working with TMDB API integration:

  1. Data Fetching

    • Use functions from src/lib/data/trending.ts for trending content
    • Use src/lib/data/discover.ts for content discovery
    • Use src/lib/data/search.ts for multi-search functionality
    • Always handle API errors gracefully
  2. 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
  3. API Configuration

    • Check INCLUDE_ADULT_CONTENT environment variable
    • Implement proper error handling for rate limits
    • Use the base URL configuration from providers
    • Handle image URLs with proper sizing

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