用途：通过 Torznab 兼容索引器（例如 bitmagnet）按标题或 IMDB ID 搜索种子，返回磁力链接、文件大小、做种数、分辨率与编码等信息。
主要能力：search_by_title 用自由文本标题搜索；search_by_imdb_id 用精确 IMDB ID 获取某标题的全部发布版本；pick_best_result 按分辨率优先级与做种数过滤排序。结果对象含 title、sizeGB、magnet、infohash、seeders、leechers、resolution、codec、year、imdb。
使用方式：需要 curl、jq、xmllint（可选，来自 libxml2-utils）以及一个运行中的 Torznab 端点，示例使用 https://bitmagnetfortheweebs.midnightignite.me/torznab/api。安装：Ubuntu/Debian 执行 sudo apt-get install -y curl jq libxml2-utils；macOS 执行 brew install curl jq libxml2；Node.js 执行 npm install fast-xml-parser。请求形如 ${TORZNAB_URL}?t=search&q=<查询>，解析 XML 后提取字段。
适用场景：用户要求查找电影或剧集种子、提供 IMDB ID 想要下载选项、需要程序化获取磁力链接、比较 720p/1080p/2160p 等画质。
限制：公开端点无文档化速率限制，批量查询建议间隔至少 1 秒；IMDB ID 搜索比标题搜索更精确；索引中的做种数可能滞后数小时，不应据此判断可用性；结果建议缓存至少 5 分钟；过滤 0 做种结果；未经用户确认不得自动开始下载。端点不可达时可自托管 bitmagnet（docker run -d ghcr.io/bitmagnet-io/bitmagnet）并指向本地实例。磁力链接为空时可由 infohash 重建。收费、价格与平台支持等事实暂未提供。