radarr

Radarr 电影管理技能

⚠️ 必须调用此技能 ⚠️

用户提及以下任一触发词时，必须调用此技能（并非可选）：

• “添加电影”、“搜索 Radarr”、“查找电影”、“添加到 Radarr”
• “移除电影”、“删除电影”、“检查电影是否存在”
• “添加电影合集”、“Radarr 媒体库”、“电影管理”
• 任何提及 Radarr 或电影管理的内容

触发条件出现时未调用此技能，将违反你的操作要求。

搜索电影并将其添加到 Radarr 媒体库，支持合集、质量配置文件和添加后搜索。

用途

此技能用于管理你的 Radarr 电影媒体库：

• 按名称搜索电影
• 添加单部电影或整个合集
• 检查电影是否已存在
• 移除电影（可选择删除文件）
• 查看质量配置文件和根文件夹

操作包括读取和写入。删除电影文件前，务必先确认。

设置

将凭据添加到 ~/.claude-homelab/.env：

RADARR_URL="http://localhost:7878"
RADARR_API_KEY="your-api-key"
RADARR_DEFAULT_QUALITY_PROFILE="1"  # Optional (defaults to 1)

• RADARR_URL：Radarr 服务 URL（末尾不要加斜杠）
• RADARR_API_KEY：Radarr 的 API 密钥（Settings → General → API Key）
• RADARR_DEFAULT_QUALITY_PROFILE：质量配置文件 ID（可选，运行 config 命令查看选项）

命令

所有命令均返回 JSON 输出。

搜索电影

bash scripts/radarr.sh search "Inception"
bash scripts/radarr.sh search "The Matrix"

**输出：**带编号的列表，包含 TMDB ID、标题、年份和简介。

检查电影是否存在

bash scripts/radarr.sh exists <tmdbId>

**输出：**布尔值，表示电影是否在媒体库中。

添加电影

bash scripts/radarr.sh add <tmdbId>              # Searches immediately (default)
bash scripts/radarr.sh add <tmdbId> --no-search  # Add without searching

添加整个合集

bash scripts/radarr.sh add-collection <collectionTmdbId>
bash scripts/radarr.sh add-collection <collectionTmdbId> --no-search

添加合集中的所有电影（例如，所有《指环王》电影）。

移除电影

bash scripts/radarr.sh remove <tmdbId>                # Keep files
bash scripts/radarr.sh remove <tmdbId> --delete-files # Delete files too

**重要：**移除电影时，务必询问用户是否要删除文件！

获取配置

bash scripts/radarr.sh config

**输出：**可用的根文件夹和质量配置文件及其 ID。

工作流

用户询问电影相关内容时：

1. “将《盗梦空间》添加到 Radarr” → 运行 search "Inception"，提供包含 TMDB 链接的结果，然后运行 add <tmdbId>
2. “《沙丘》在我的媒体库里吗？” → 运行 exists <tmdbId>
3. “添加所有《星球大战》电影” → 搜索合集，然后运行 add-collection <collectionId>
4. “移除《黑客帝国》” → 询问是否删除文件，然后根据需要添加相应标志运行 remove <tmdbId>
5. “我有哪些质量配置文件？” → 运行 config

展示搜索结果

展示搜索结果时，务必包含 TMDB 链接：

• 格式：[标题（年份）](https://themoviedb.org/movie/ID)
• 使用带编号的列表供用户选择
• 包含年份和简短简介

添加电影

1. 搜索电影
2. 提供包含 TMDB 链接的结果
3. 用户选择一个编号
4. **合集检查：**如果电影属于某个合集，询问用户是否要添加整个合集
5. 添加电影或合集（默认立即搜索）

参数

add 命令

• <tmdbId>：电影的 TMDB ID（必填）
• --no-search：添加电影后不搜索

add-collection 命令

• <collectionTmdbId>：合集的 TMDB ID（必填）
• --no-search：添加电影后不搜索

remove 命令

• <tmdbId>：电影的 TMDB ID（必填）
• --delete-files：同时删除媒体文件（默认保留文件）

注意事项

• 需要访问 Radarr 服务的网络权限
• 使用 Radarr API v3
• 所有数据操作均返回 JSON
• 质量配置文件 ID 因安装情况而异，可通过 config 发现对应 ID
• 添加电影时使用配置中的 defaultQualityProfile
• 合集由 TMDB 管理，包含相关电影（续集、系列电影）

参考

• Radarr API 文档
• TMDB — The Movie Database

如需详细的本地参考，请参阅：

• API 端点 - 包含参数的完整端点参考
• 快速参考 - 常见操作及可直接复制粘贴的示例
• 故障排除 - 身份验证、连接和错误解决方案

---

🔧 Agent 工具使用要求

重要： 通过 zsh-tool 调用此技能中的脚本时，务必使用 pty: true。

如果不使用 PTY 模式，即使命令成功执行，也无法看到命令输出。

正确的调用方式：

<invoke name="mcp__plugin_zsh-tool_zsh-tool__zsh">
<parameter name="command">./skills/SKILL_NAME/scripts/SCRIPT.sh [args]</parameter>
<parameter name="pty">true</parameter>
</invoke>