mcpField
S
sonarr

sonarr

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

sonarr について

Sonarr のテレビ番組ライブラリを管理するスキルです。番組の検索、追加、削除、設定確認に対応し、追加後にエピソードを検索するか選べます。

主な機能

  1. 01番組名でテレビ番組を検索
  2. 02検索設定を指定して番組を追加
  3. 03番組の登録状況を確認
  4. 04ファイル削除を選べる番組削除
  5. 05品質プロファイルとルートフォルダーの確認

活用シーン

  1. 01検索した番組を Sonarr に追加
  2. 02シリーズがライブラリにあるか確認
  3. 03ファイルの扱いを選んで番組を削除
  4. 04利用可能な品質プロファイルとルートフォルダーを確認

インストール

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

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

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

同梱ファイル

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

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

詳細

Sonarr のテレビ番組管理スキル

⚠️ スキルの呼び出しが必須です ⚠️

次のいずれかのトリガーにユーザーが言及した場合、このスキルを必ず呼び出してください（任意ではありません）。

  • 「テレビ番組を追加」「Sonarr を検索」「シリーズを探す」「Sonarr に追加」
  • 「番組を削除」「番組を消す」「番組が存在するか確認」
  • 「Sonarr ライブラリ」「テレビ番組の管理」「番組を追加」
  • Sonarr またはテレビ番組の管理に関する言及

トリガーが発生した際にこのスキルを呼び出さないと、運用要件に違反します。

監視オプション、品質プロファイル、追加時の検索に対応し、Sonarr ライブラリ内のテレビ番組を検索して追加します。

目的

このスキルを使用すると、Sonarr のテレビ番組ライブラリを管理できます。

  • 名前でテレビ番組を検索する
  • オプションを設定して番組をライブラリに追加する
  • 番組がすでに存在するか確認する
  • 番組を削除する（ファイルの削除は任意）
  • 品質プロファイルとルートフォルダーを表示する

読み取り操作と書き込み操作の両方が含まれます。ファイルを削除して番組を削除する場合は、必ず事前に確認してください。

セットアップ

.env ファイルに認証情報を追加します：~/.claude-homelab/.env

SONARR_URL="http://localhost:8989"
SONARR_API_KEY="<your_api_key>"
SONARR_DEFAULT_QUALITY_PROFILE="1"  # Optional: defaults to 1 if not set

設定変数：

  • SONARR_URL：Sonarr サーバーの URL（末尾にスラッシュを付けないでください）
  • SONARR_API_KEY：Sonarr の API キー（Settings → General → API Key）
  • SONARR_DEFAULT_QUALITY_PROFILE：品質プロファイル ID（任意。既定値は 1）

コマンド

すべてのコマンドは JSON 出力を返します。

番組を検索する
bash scripts/sonarr.sh search "Breaking Bad"
bash scripts/sonarr.sh search "The Office"

出力： TVDB ID、タイトル、年、概要を含む番号付きリスト。

番組が存在するか確認する
bash scripts/sonarr.sh exists <tvdbId>

出力： 番組がライブラリにあるかどうかを示すブール値。

番組を追加する
bash scripts/sonarr.sh add <tvdbId>              # Searches immediately (default)
bash scripts/sonarr.sh add <tvdbId> --no-search  # Add without searching
番組を削除する
bash scripts/sonarr.sh remove <tvdbId>                # Keep files
bash scripts/sonarr.sh remove <tvdbId> --delete-files # Delete files too

重要： 削除する際は、ファイルも削除するかどうかを必ずユーザーに確認してください。

設定を取得する
bash scripts/sonarr.sh config

出力： 利用可能なルートフォルダーと、それぞれの ID を含む品質プロファイル。

ワークフロー

ユーザーからテレビ番組について尋ねられた場合：

  1. 「Breaking Bad を Sonarr に追加して」 → search "Breaking Bad" を実行し、TVDB リンク付きの検索結果を提示してから、add <tvdbId> を実行します。
  2. 「The Office はライブラリにある？」 → exists <tvdbId> を実行します。
  3. 「Game of Thrones を削除して」 → ファイルも削除するか確認してから、適切なフラグを付けて remove <tvdbId> を実行します。
  4. 「どの品質プロファイルがある？」 → config を実行します。
検索結果の提示

検索結果を提示する際は、必ず TVDB リンクを含めてください。

  • 形式：[タイトル（年）](https://thetvdb.com/series/SLUG)
  • ユーザーが選べるよう、番号付きリストで表示します。
  • 年と簡潔な概要を含めます。
番組の追加
  1. 番組を検索します。
  2. TVDB リンク付きの検索結果を提示します。
  3. ユーザーが番号を選びます。
  4. 番組を追加します（既定ではエピソードを検索します）。

パラメーター

add コマンド
  • <tvdbId>：番組の TVDB ID（必須）
  • --no-search：追加後にエピソードを検索しません
remove コマンド
  • <tvdbId>：番組の TVDB ID（必須）
  • --delete-files：メディアファイルも削除します（既定ではファイルを保持します）

注意事項

  • Sonarr サーバーへのネットワークアクセスが必要です。
  • Sonarr API v3 を使用します。
  • すべてのデータ操作は JSON を返します。
  • 品質プロファイル ID はインストール環境によって異なります。config を使用して確認してください。
  • 番組の追加時には、.env の SONARR_DEFAULT_QUALITY_PROFILE が使用されます（既定値は 1）。

参考資料

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

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

重要： 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 対応