find_subtitles
Search OpenSubtitles for subtitle candidates without downloading, so users can choose one or verify an exact-file hash match before spending a download.
Instructions
Search OpenSubtitles and return the candidates without downloading anything. Use this when the user should choose, or to check what exists before spending a download. Each result carries a file_id for download_subtitle, plus moviehash_match — true means it is synced to this exact file. Costs no download quota. Requires the user's own OpenSubtitles API key in the opensubtitles_api_key setting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_subtitles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Video to match against. Defaults to the playing file. | |
| hash | No | Match by file hash as well as title (default true). Set false to search by title only. | |
| query | No | Search text. Omit to derive a title from the playing file's name. | |
| languages | No | Comma-separated OpenSubtitles language codes, e.g. "zh-CN,en" |