Prowlarr

核心功能

Prowlarr是Arr系列生态的元搜索索引器管理工具，该Skill提供完整的API封装能力：

• 聚合搜索：跨所有配置的Torrent/Usenet索引器统一检索，支持关键词、TVDB/IMDB精准匹配
• 分类过滤：内置Newznab标准分类（2000电影/5000剧集/3000音频等），支持4K/蓝光等子类别
• 索引器管理：启用/禁用/删除索引器、健康检测、用量统计、一键测试可用性
• 生态同步：自动将索引器配置推送至Sonarr/Radarr/Lidarr等关联应用

显著优势

效率提升：单次搜索覆盖数十个索引器，避免逐个站点查询；API响应速度优于Web UI批量操作。生态整合：深度集成Arr系列工作流，索引器变更自动同步下游应用。灵活性：支持Shell脚本化调用，便于自动化脚本与定时任务集成。开源透明：基于Sonarr团队维护的成熟开源项目，社区活跃更新频繁。

潜在局限

配置门槛：需预先部署Prowlarr服务并获取API密钥，对非Arr生态用户有学习成本。索引器依赖：搜索结果质量完全取决于配置的索引器可用性与质量，需自行维护健康索引源。无下载能力：仅提供元数据检索，需配合qBittorrent/Transmission/SABnzbd等下载工具。地理限制：部分索引器需代理或特定网络环境访问。

适用人群

• 已部署Sonarr/Radarr等媒体管理系统的自动化用户
• 需要统一检索多站点资源的技术爱好者
• 追求工作流脚本化的高级NAS/服务器用户
• 熟悉Docker化部署的DevOps实践者

风险提示

版权合规：Skill本身为中性工具，但索引器可能指向受版权保护内容，用户需确保当地法律允许及自有内容授权。API密钥安全：配置文件存储明文API密钥，需确保~/.clawdbot/credentials目录权限严格限制（建议600）。网络暴露：Prowlarr服务若公网暴露需配合反向代理与认证，避免未授权索引器管理。来源可信度：T1级开源项目，但具体索引器来源需用户自行甄别，存在恶意种子或虚假文件风险。

核心用法

Prowlarr Skill 是一款面向 *arr 媒体管理生态系统的索引器聚合工具，通过封装 Prowlarr REST API 提供命令行交互能力。用户配置 Prowlarr 实例地址与 API Key 后，即可执行六大类操作：资源搜索（支持关键词、IMDB/TVDB ID 精准匹配）、索引器生命周期管理（启用/禁用/删除/测试）、健康状态监控（统计使用量、连通性检测）、应用同步（向 Sonarr/Radarr 等推送配置变更）及系统状态查询。

搜索功能覆盖 Torrent 与 Usenet 双协议，内置 2000+ 标准分类 ID 映射（电影、剧集、音频、书籍、游戏等），支持通过子分类筛选画质（SD/HD/UHD/BluRay）。典型工作流包括：用 search 快速检索最新发行版，用 tv-search/movie-search 按元数据 ID 精准定位单集或影片，用 sync 确保下游应用索引器配置同步。

显著优点

生态整合度高：无缝对接 Sonarr、Radarr、Lidarr、Readarr 等主流媒体管理工具，消除多应用重复配置索引器的痛点。

协议与分类全覆盖：同时支持 Torrent 与 Usenet，内置标准化分类体系，满足电影、剧集、音乐、电子书、软件等多元需求。

运维友好：提供 stats 用量分析、test-all 批量健康检测、health 系统诊断，降低索引器失效导致的搜索失败风险。

配置灵活：支持 JSON 配置文件与环境变量双重注入，兼容私有化部署与容器化场景。

依赖极简：仅依赖系统级 curl 与 jq，无额外运行时或第三方库，部署零负担。

潜在缺点与局限性

前置基础设施依赖：必须自建 Prowlarr 实例并维护索引器订阅，对无现有 *arr 生态的用户门槛较高。

无结果聚合与去重：返回原始 API 响应，需用户自行处理跨索引器的重复条目与质量排序。

交互模式受限：纯命令行输出，缺乏交互式筛选、结果预览或下载直链生成，体验较原生 Web UI 简陋。

分类 ID 认知成本：依赖数字分类编码（如 2045=UHD 电影），新用户需查阅映射表。

网络可达性要求：部分索引器需代理或特定网络环境，Skill 本身不处理连通性故障排查。

适合的目标群体

• 已部署 Prowlarr 的 *arr 生态用户，寻求 CLI 快速操作与自动化脚本集成
• 运维人员需批量检测索引器健康状态或执行配置同步
• 开发者构建基于 Prowlarr 的下游工具或 CI/CD 流水线
• 偏好终端工作流的高级用户，追求轻量、可脚本化的搜索体验

使用风险

配置泄露风险：API Key 以明文存储于用户目录 JSON 文件，建议设置 600 权限并避免版本控制提交。

网络传输安全：虽强制 HTTPS，但用户可能误配 HTTP URL 导致密钥暴露；建议部署时校验 TLS 版本。

索引器合规风险：Prowlarr 本身不验证索引器内容合法性，用户需自行确保搜索与下载行为符合当地版权法规。

服务可用性依赖：Prowlarr 实例或上游索引器故障将直接导致 Skill 不可用，无本地降级方案。

输入验证缺失：当前版本对 indexer ID 等参数缺乏格式校验，异常输入可能导致 API 返回 400 错误而非友好提示。