一键管理你的影音收藏库

通过 API 管理 Radarr 电影库，支持智能搜索、系列电影一键添加及 TMDB 元数据链接展示，实现自动化媒体管理。

基本信息

• 技能名称?Radarr
• 中文名称?一键管理你的影音收藏库
• 作者?jordyvandomselaar
• 分类?专业技能
• 版本?1.3.0
• 标签?radarr, movie-management, media-automation, tmdb, home-theater, command-line-tool, api-client

使用方法

使用说明
核心用法
Radarr Skill 是面向媒体自动化管理场景设计的命令行工具，通过与 Radarr 服务端 API 交互，实现电影搜索、添加、收藏管理等功能。用户配置服务端 URL 和 API Key 后，可通过自然语言指令完成工作流：搜索电影名称 → 获取带 TMDB 链接的候选列表 → 选择目标 → 可选择性添加整个电影系列。
关键特性 ：
智能搜索 ：支持模糊匹配，返回 TMDB 链接便于用户核验
系列收藏识别 ：自动检测电影所属系列，提供一键添加全集选项
灵活添加策略 ：默认立即触发搜索，支持 --no-search 仅入库
根目录与质量配置 ：内置配置查看命令，便于用户调试
显著优点
降低操作门槛 ：封装复杂 API 调用为简洁命令，适合非技术用户
防重复机制 ： exists 命令预先检查库中是否已存在
元数据透明 ：强制展示 TMDB 链接，减少误添加风险
系列管理高效 ：解决系列电影逐部添加的繁琐问题
潜在局限
本地依赖 ：需预装 curl 和 jq ，部分精简环境可能缺失
配置固定性 ： defaultQualityProfile 为静态配置，频繁切换需手动修改
无交互确认 ：除 remove 外，多数操作无二次确认，依赖用户仔细核对
网络依赖 ：TMDB 和 Radarr 服务端需同时可达
适合人群
自建媒体库（NAS/服务器）的影音爱好者
使用 Radarr 实现自动化下载的用户
偏好命令行高效操作的技术用户
常规风险
误删风险 ： remove --delete-files 为物理删除，需严格确认
API 密钥泄露 ：配置文件中明文存储，需确保 ~/.clawdbot/ 目录权限正确（建议 600）
重复下载 ：若误操作添加已存在电影，可能触发重复下载任务
系列误判 ：TMDB 系列数据可能包含无关影片，需人工核对链接
使用建议
首次使用先运行 config 确认质量配置 ID 匹配预期
对系列添加操作，建议先点击 TMDB 链接查看完整系列列表
移除操作务必确认 --delete-files 参数意图