智能剧集管理助手

基于 Sonarr API 的电视节目管理工具，支持搜索、添加、删除剧集，需用户自行配置本地实例，适合媒体库自动化管理。

基本信息

• 技能名称?sonarr
• 中文名称?智能剧集管理助手
• 作者?jordyvandomselaar
• 分类?专业技能
• 版本?v1.2.0
• 标签?content-media, automation, api, productivity

使用方法

使用说明
核心用法
Sonarr Skill 是一个用于管理 Sonarr 媒体库的命令行工具，通过 Bash 脚本封装 Sonarr API 实现电视节目管理。用户需先在 ~/.clawdbot/credentials/sonarr/config.json 配置 Sonarr 实例地址和 API 密钥，即可通过自然语言指令完成剧集搜索、添加、删除等操作。
主要工作流程为：使用 search "剧名" 搜索节目，系统返回带 TVDB 链接的编号列表供用户确认，随后执行添加并自动触发下载搜索。支持 --no-search 参数跳过立即搜索，以及 remove 命令配合 --delete-files 删除媒体文件。
显著优点

1. 操作简洁直观 ：将复杂的 Sonarr API 调用封装为简单命令，降低使用门槛
2. 安全设计完善 ：URL 参数使用 jq @uri 编码，无命令注入风险；删除文件前强制用户确认
3. 依赖精简可靠 ：仅依赖系统标准工具 curl 和 jq ，无额外动态加载
4. 错误处理健全 ：使用 set -e 确保异常安全退出，API 错误不泄露敏感信息
5. 配置灵活 ：支持默认质量配置，同时允许单次操作覆盖
   潜在缺点与局限性
6. 单实例限制 ：仅支持配置单一 Sonarr 实例，不适合多服务器管理场景
7. T3 来源风险 ：由个人开发者维护，长期更新和支持存在不确定性
8. 网络协议默认 HTTP ：配置示例使用 HTTP，公网场景需用户自行改为 HTTPS
9. 无交互式配置向导 ：新用户需手动编辑 JSON 配置文件，体验不够友好
10. 功能边界清晰 ：专注电视节目，不支持电影管理（需 Radarr 等其他工具）
    适合的目标群体
    已部署 Sonarr 的 NAS/家庭媒体服务器用户
    希望通过自然语言快速添加剧集的自动化爱好者
    熟悉命令行操作、具备基础 JSON 配置能力的用户
    追求简洁工具链、不愿使用复杂 Web 界面的效率型用户
    使用风险
11. 配置泄露风险 ：API 密钥以明文存储于本地文件，需确保文件权限（建议 600）
12. 误删文件风险 ：虽有人工确认环节，但批量操作时仍需警惕 --delete-files 参数
13. 网络暴露风险 ：默认 HTTP 通信，公网部署建议配合 VPN 或反向代理 HTTPS
14. 服务可用性依赖 ：Skill 本身不验证 Sonarr 实例健康状态，异常时依赖 curl 超时机制