# Tmdb Data

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

- Skill: `majiayu000/tmdb-data` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/tmdb-data`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/tmdb-data/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/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:**
```typescript
import { getTrendingMovies } from '@/lib/data/trending'

const trending = await getTrendingMovies()
// Returns array of trending movies with metadata
```

**Searching for content:**
```typescript
import { multiSearch } from '@/lib/data/search'

const results = await multiSearch('query')
// Returns results across movies, TV shows, and people
```

**Converting TMDB response:**
```typescript
import { convertToDiscoverResult } from '@/lib/data/search'

const formatted = convertToDiscoverResult(tmdbResponse)
// Standardizes response format for UI
```