MoviePilot

Interact with MoviePilot API to search, subscribe, and manage movies/TV shows.

Prerequisites

Required environment variables (must be set before use):

• MOVIEPILOT_URL - MoviePilot server URL (e.g., http://127.0.0.1:3000)
• MOVIEPILOT_API_KEY - API Key for authentication (preferred)
• Or MOVIEPILOT_TOKEN - Bearer token (obtained via login)

If credentials are not set, ask the user to provide them.

Core Workflows

1. Subscribe to a Movie/TV Show

Typical user request: "帮我订阅《XXX》" or "Subscribe to XXX"

Steps:

1. Search for the media: scripts/moviepilot_api.sh search "title"
2. Parse results, confirm with user if multiple matches (show title, year, type, vote)
3. Extract tmdb_id (or douban_id), type, title, year from the chosen result
4. Create subscription:

   scripts/moviepilot_api.sh sub_add '{"name":"Title","type":"电影","tmdbid":12345,"year":"2024"}'
   

   • For TV shows, include "season": N if subscribing to a specific season
   • type must be "电影" (movie) or "电视剧" (TV show)

2. View Subscriptions

scripts/moviepilot_api.sh sub_list

Present results as a readable list: name, type, year, state.

3. Cancel Subscription

By subscription ID:

scripts/moviepilot_api.sh sub_delete <subscribe_id>

By media ID:

scripts/moviepilot_api.sh sub_delete_media "tmdb:12345"

4. Check Downloads

scripts/moviepilot_api.sh downloads

5. Browse Recommendations

# Options: douban_movie_hot, douban_tv_hot, tmdb_trending, tmdb_movies, tmdb_tvs, bangumi_calendar
scripts/moviepilot_api.sh recommend douban_movie_hot

6. Search Torrent Resources

scripts/moviepilot_api.sh search_resource "keyword"

Important Notes

• Media IDs use prefix format: tmdb:12345, douban:12345, bangumi:12345
• Always search first to get the correct media ID before subscribing
• When search returns multiple results, present them to the user for selection
• The type field in Chinese: "电影" for movies, "电视剧" for TV shows
• For detailed API docs, see references/api_reference.md

Script Reference

The helper script scripts/moviepilot_api.sh supports these actions: