Parse a media filename
guessitParse movie or TV filenames and release names into structured metadata including title, year, season, episode, codecs, language, and release group. Accepts file names or full paths.
Instructions
Extract metadata from one movie or TV episode filename or release name: title, year, season, episode, episode_title, screen_size, source, video_codec, audio_codec, language, subtitle_language, release_group, streaming_service, container, type (movie or episode) and more (56 properties). Output matches Python guessit's JSON. Pass just the file name or a full path; directory names help (e.g. "Show/Season 2/episode.mkv").
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"filename": "<filename>"
},
"name": "guessit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | Optional guessit options, as in the library and Python guessit: type ("movie" | "episode"), output ("python" default: language/country as names like "French"; "codes": {"alpha3": "fra"} objects that keep regions such as pt-BR), expected_title, allowed_languages, allowed_countries, name_only, date_day_first, date_year_first, excludes, includes. | |
| filename | Yes | Filename, path or release name, e.g. "The.Matrix.1999.1080p.BluRay.x264-GRP.mkv" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| year | No | ||
| title | No | ||
| season | No | ||
| episode | No |