mcpField
R
radarr

radarr

github.com/jmagarその他8752 回インストール29 週間前に更新
リポジトリ

radarr について

スクリプトと Radarr API v3 を使って映画ライブラリを管理するスキルです。映画やコレクションの検索・追加、登録確認、削除、設定参照に対応し、ファイル削除前には確認を求めます。

主な機能

  1. 01映画とコレクションの検索
  2. 02映画または全作品の追加
  3. 03映画の登録状況確認
  4. 04ファイル削除を選べる映画の削除
  5. 05ルートフォルダーと品質プロファイルの確認

活用シーン

  1. 01追加前の映画検索
  2. 02ライブラリ内の登録確認
  3. 03映画コレクションの追加
  4. 04ファイルを残して映画を削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jmagar/claude-homelab --skill radarr

インストール後、Claude Code で/radarrを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

load-env.sh
README.md
references/
api-endpoints.md
quick-reference.md
troubleshooting.md
scripts/
radarr.sh

詳細

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. 「Inception を Radarr に追加して」 → search "Inception" を実行し、TMDB リンク付きで検索結果を提示してから、add <tmdbId> を実行します。
  2. 「Dune はライブラリにある？」 → exists <tmdbId> を実行します。
  3. 「Star Wars の映画を全部追加して」 → コレクションを検索してから、add-collection <collectionId> を実行します。
  4. 「The Matrix を削除して」 → ファイルを削除するか確認してから、適切なフラグを指定して remove <tmdbId> を実行します。
  5. 「どの品質プロファイルがある？」 → config を実行します。
検索結果の提示

検索結果を提示する際は、必ず TMDB リンクを含めます。

  • 形式：[Title (Year)](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 を使用して確認してください。
  • 映画を追加する際は、設定の defaultQualityProfile が使用されます。
  • コレクションは TMDB 固有のもので、関連作品（続編、シリーズ作品）が含まれます。

参照

詳しいローカルリファレンスについては、以下を参照してください。

🔧 エージェントツールの使用要件

重要： このスキルのスクリプトを 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>

コメント

Markdown 対応