用途:该技能提供对 Prowlarr 索引器聚合的读写访问,用于搜索发布资源并管理索引器配置。
主要能力:跨所有已配置索引器搜索发布;按协议(torrent/usenet)与分类过滤;使用 TVDB ID 做剧集搜索、IMDB ID 做电影搜索;列出并监控索引器健康与统计;启用、禁用、删除索引器;测试索引器连通性;将索引器配置同步到 Sonarr、Radarr 等已连接应用;查看系统状态与健康检查。分类 ID 遵循 Newznab/Torznab 标准,如 2000 电影、5000 电视、3000 音频、7000 书籍,并有子分类如 2045 UHD 电影、5040 HD 电视。
使用方式:凭据存于 ~/.claude-homelab/.env,需设置 PROWLARR_URL(如 http://localhost:9696)与 PROWLARR_API_KEY;API 密钥可在 Prowlarr → Settings → General → Security → API Key 获取。通过脚本调用,例如搜索 ./scripts/prowlarr-api.sh search "ubuntu 22.04",可加 --torrents、--usenet、--category 参数;剧集搜索 ./scripts/prowlarr-api.sh tv-search --tvdb 71663 --season 1 --episode 1;电影搜索 movie-search --imdb tt0111161;索引器列表 indexers(可加 --verbose);统计 stats;测试 test-all 或 test <indexer-id>;管理 enable/disable/delete <indexer-id>;同步 sync;应用列表 apps;系统 status 与 health。通过 zsh-tool 调用脚本时必须使用 pty: true,否则输出不可见。
适用场景:查找发行资源、检查或测试索引器、查看使用统计、批量同步索引器到媒体管理应用。
限制:需要能访问 Prowlarr 服务器的网络;使用 Prowlarr API v1;数据操作返回 JSON;搜索会查询外部索引器,需遵守速率限制;删除索引器不可恢复,删除或禁用前应先确认;同步会把配置推送到所有已连接应用。收费、价格等信息暂未提供。