القائمة
Search and retrieve TV series, movie, and people info from TheTVDB. Get details by ID, list episodes, seasons, and artwork. Use when looking up TV/movie metadata from TheTVDB.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use GitHub Copilot SDK to programmatically call Copilot from Python. Use when integrating AI capabilities via Copilot CLI into applications.
Search IMDB for movies, TV series, and people. Get details by name or ID, browse upcoming/popular titles. Use when looking up movie/TV/celebrity info from IMDB.
Search and download ebooks from Library Genesis (LibGen). Use when the user needs to find or download ebooks, EPUBs, or PDFs from LibGen.
Search and download movie torrents from YTS (YIFY releases). Use when the user needs to find or download movie torrents with quality and rating filters.
Manage audiobooks: download missing covers, organize metadata, embed cover art, and download from AudiobookBay. Use when working with audiobook libraries, cover images, or AudiobookBay searches.
Interact with the Audiobookshelf API to manage audiobook libraries, update metadata, scan directories, and manage authors. Use when working with Audiobookshelf server instances.
استنادا إلى تصنيف SOC المهني
| name | tvdb |
| description | Search and retrieve TV series, movie, and people info from TheTVDB. Get details by ID, list episodes, seasons, and artwork. Use when looking up TV/movie metadata from TheTVDB. |
| license | MIT |
| compatibility | Requires Python 3.13+, uv, and tvdb_v4_official |
Search and retrieve TV series, movie, episode, and people information from
TheTVDB using the official tvdb_v4_official Python package (TVDB API v4).
TVDB_API_KEY=your-api-key-here
scripts/tvdb_v4_official (GitHub)| Script | Purpose |
|---|---|
tvdb_client.py | Core client: wraps tvdb_v4_official with env-based auth |
search.py | Search TVDB by query (series, movies, people) |
get_series.py | Get TV series info by TVDB ID |
get_movie.py | Get movie info by TVDB ID |
get_episodes.py | List episodes for a series |
get_person.py | Get person info by TVDB ID |
TVDB_API_KEY from .env via the tvdb_v4_official.TVDB client| Parameter | Type | Description |
|---|---|---|
query | String | Search term (series name, movie title, person) |
type | String | Filter: series, movie, person |
year | Integer | Filter by year |
limit | Integer | Max results to return |
from tvdb_client import get_client
tvdb = get_client()
results = tvdb.search("Breaking Bad", type="series")
for r in results:
print(f"{r['name']} ({r.get('year', 'N/A')}) - ID: {r.get('tvdb_id')}")
from tvdb_client import get_client
tvdb = get_client()
series = tvdb.get_series(81189) # Breaking Bad
print(series["name"], series.get("year"))
from tvdb_client import get_client
tvdb = get_client()
series = tvdb.get_series_extended(81189)
for season in series.get("seasons", []):
print(f"Season {season['number']} ({season['type']['name']})")
from tvdb_client import get_client
tvdb = get_client()
info = tvdb.get_series_episodes(81189, season_type="default", page=0)
for ep in info["episodes"]:
print(f"S{ep['seasonNumber']:02d}E{ep['number']:02d} - {ep['name']}")
from tvdb_client import get_client
tvdb = get_client()
movie = tvdb.get_movie(31) # Avengers
print(movie["name"])
# Extended info with characters
movie_ext = tvdb.get_movie_extended(31)
for c in movie_ext.get("characters", []):
print(f" {c.get('name')} - {c.get('personName')}")
from tvdb_client import get_client
tvdb = get_client()
person = tvdb.get_person_extended(253463)
print(person["name"])
from tvdb_client import get_client
tvdb = get_client()
next_aired = tvdb.get_series_nextAired(81189)
print(next_aired)
| Method | Description |
|---|---|
search(query, **kwargs) | Search across series, movies, people |
get_series(id) | Basic series record |
get_series_extended(id) | Full series with seasons, characters, artwork |
get_series_episodes(id, season_type, page) | Paginated episode list |
get_series_nextAired(id) | Next airing episode |
get_series_artworks(id, lang) | Series artwork |
get_movie(id) | Basic movie record |
get_movie_extended(id) | Full movie with characters, artwork |
get_episode(id) | Basic episode record |
get_episode_extended(id) | Full episode details |
get_season(id) | Basic season record |
get_season_extended(id) | Full season with episodes |
get_person(id) | Basic person record |
get_person_extended(id) | Full person with roles |
get_all_genres() | List all genres |
cd skills/tvdb/scripts
uv run python search.py "Breaking Bad"
uv run python search.py "Breaking Bad" --type series
uv run python search.py "Avengers" --type movie --year 2012
uv run python get_series.py 81189
uv run python get_series.py 81189 --extended
uv run python get_movie.py 31
uv run python get_movie.py 31 --extended
uv run python get_episodes.py 81189
uv run python get_episodes.py 81189 --season 1
uv run python get_person.py 253463