本文版权归作者所有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
转载自夜明的孤行灯
本文链接地址: https://www.huangyunkun.com/2023/07/04/torznab-search-bt-network/
在使用Sonarr等工具的时候，我们总会遇到找不到资源的情况，特别是一些冷门的中文资源（国产剧等）就更复杂了。
Sonarr搜索资源用的比较多的是搭配Jackett走Torznab协议。Torznab 协议是一种用于搜索引擎的协议，它可以帮助搜索引擎更方便地搜索 BitTorrent 网络中的资源。
Torznab 协议有以下特点：
- 标准化：Torznab 协议是一种标准化的协议，可以帮助搜索引擎更方便地搜索 BitTorrent 网络中的资源。
- 可扩展性：Torznab 协议支持多种参数，可以帮助搜索引擎更精确地搜索所需的内容。
- 易于实现：Torznab 协议的实现相对简单，开发者可以根据自己的需求选择适当的客户端库和示例代码，来实现搜索引擎的功能。
- 支持多种语言：Torznab 协议的客户端库支持多种编程语言，包括 C#、Java、Python、Ruby 等。
- 支持多种索引站点：Torznab 协议可以支持多种索引站点，包括私有站点和公共站点，可以帮助搜索引擎更全面地搜索 BitTorrent 网络中的资源。
当一个资源无法是私有或者根本就不是标准BitTorrent网络资源时，我们可以自己实现一套，帮助Sonarr自动下载需要的资源。
参数
Torznab 协议支持多种参数，以下是常见的一些参数：
- apikey：API 密钥，用于身份验证和授权。
- q：搜索关键字，用于指定搜索的内容。
- cat：资源分类，用于指定搜索的资源类型，如电影、电视剧、音乐等。
- limit：搜索结果数量限制，用于指定搜索结果的数量。
- offset：搜索结果偏移量，用于指定搜索结果的起始位置。
- imdbid：IMDb 编号，用于指定搜索的电影或电视剧。
- tvdbid：TVDB 编号，用于指定搜索的电视剧。
- tvmazeid：TVMaze 编号，用于指定搜索的电视剧。
- season：季数，用于指定搜索的电视剧季数。
- episode：集数，用于指定搜索的电视剧集数。
- sortby：排序方式，用于指定搜索结果的排序方式，如按热度、按时间等。
- minsize：最小文件大小，用于指定搜索结果的最小文件大小。
- maxsize：最大文件大小，用于指定搜索结果的最大文件大小。
Torznab 协议返回的内容包括以下信息：
- title：资源的标题或名称。
- category：资源的分类，如电影、电视剧、音乐等。
- link：资源的链接地址，用于下载或查看资源。
- size：资源的大小，以字节为单位。
- pubdate：资源的发布日期或时间。
- description：资源的描述信息，包括资源的简介、演员、导演等信息。
- guid：资源的全局唯一标识符，用于区分不同的资源。
- imdbid：IMDb 编号，用于指定搜索的电影或电视剧。
- tvdbid：TVDB 编号，用于指定搜索的电视剧。
- tvmazeid：TVMaze 编号，用于指定搜索的电视剧。
- season：季数，用于指定搜索的电视剧季数。
- episode：集数，用于指定搜索的电视剧集数。
- downloadurl：资源的下载链接地址，用于下载资源。
这些参数并不是要完整实现的，如果只是满足能够运行，可以自己尝试，只实现必要的字段。
协议参考
当然，要实现一个协议，只是一些参数还不够，还是需要看完整的文档。Torznab API Specification：该文档是 Torznab 协议的官方规范，其中包括协议的定义、参数意义、返回结果等详细信息。从该文档可以了解 Torznab 协议的基本原理和使用方法。
目前已经有一些开源的支持Torznab协议的应用，直接参考它们的文档也可以帮助更好理解
Jackett Wiki：Jackett 是一个实现了 Torznab 协议的搜索代理程序，其官方网站提供了详细的文档和示例代码，可以帮助您更好地理解和使用 Torznab 协议。
Radarr API Documentation：Radarr 是一个基于 Torznab 协议的电影搜索引擎，其官方文档中包括了 Torznab 协议的参数和使用方法，可以帮助您更好地理解和使用 Torznab 协议。
Sonarr API Documentation：Sonarr 是一个基于 Torznab 协议的电视剧搜索引擎，其官方文档中也包括了 Torznab 协议的参数和使用方法，可以帮助您更好地理解和使用 Torznab 协议。
本文版权归作者所有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
转载自夜明的孤行灯
本文链接地址: https://www.huangyunkun.com/2023/07/04/torznab-search-bt-network/