Parse a media filename
guessitExtract 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 |