核心用法
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参数意图