seer-cli

CLI for the Seer media request management API. Search movies and TV shows, create and manage media requests, manage users, track issues, and administer a self-hosted Seer instance. Use when asked to find, request, or manage media content, check what is trending, look up actors or collections, manage users, or check system status.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "seer-cli" with this command: npx skills add electather/seer-manager

seer-cli

CLI for interacting with a Seer media request management server.

Installation

Download the latest release archive and checksum file from the Releases page, verify, and install:

# Replace <os> and <arch> with your platform (linux/darwin, amd64/arm64)
curl -fsSL https://github.com/electather/seer-cli/releases/latest/download/seer-cli_<version>_<os>_<arch>.tar.gz -o seer-cli.tar.gz
curl -fsSL https://github.com/electather/seer-cli/releases/latest/download/seer-cli_<version>_checksums.txt -o checksums.txt
grep seer-cli_<version>_<os>_<arch>.tar.gz checksums.txt | sha256sum -c
tar -xzf seer-cli.tar.gz
sudo mv seer-cli /usr/local/bin/

Supports Linux and macOS (amd64 / arm64).

Docker

Run the MCP HTTP server in a container next to your Seer instance:

# With Bearer token auth
docker run --rm \
  -e SEER_SERVER=http://your-seer-instance:5055 \
  -e SEER_API_KEY=your-api-key \
  -e SEER_MCP_AUTH_TOKEN=your-secret-token \
  -p 8811:8811 \
  ghcr.io/electather/seer-cli:latest

MCP endpoint: http://localhost:8811/mcp — set Authorization: Bearer your-secret-token in your MCP client.

For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a secret path prefix:

docker run --rm \
  -e SEER_SERVER=http://your-seer-instance:5055 \
  -e SEER_API_KEY=your-api-key \
  -e SEER_MCP_ROUTE_TOKEN=your-secret-path \
  -e SEER_MCP_NO_AUTH=true \
  -e SEER_MCP_CORS=true \
  -p 8811:8811 \
  ghcr.io/electather/seer-cli:latest

MCP endpoint: http://localhost:8811/your-secret-path/mcp — no auth header required.

At least one of SEER_MCP_AUTH_TOKEN, SEER_MCP_ROUTE_TOKEN, or SEER_MCP_NO_AUTH=true must be set for HTTP transport.

docker-compose deployment

Use the included docker-compose.yml to deploy alongside Seer:

SEER_API_KEY=xxx SEER_MCP_AUTH_TOKEN=secret docker compose up -d

The default SEER_SERVER in the compose file points to http://seer:5055 (the Seer service name). Override it if your Seer instance is elsewhere.

Running CLI commands via Docker

Override the default CMD to run any CLI command:

docker run --rm \
  -e SEER_SERVER=http://your-seer-instance:5055 \
  -e SEER_API_KEY=your-api-key \
  ghcr.io/electather/seer-cli:latest \
  status system

Setup

seer-cli config set --server https://your-seer-instance.com --api-key YOUR_KEY
seer-cli config show   # verify

Environment variables also work: SEER_SERVER, SEER_API_KEY.

Global Flags

  • -s, --server — Seer server URL
  • -k, --api-key — API key
  • -v, --verbose — show request URLs and HTTP status codes
  • --config — path to config file (default ~/.seer-cli.yaml)

Output

All commands return JSON. Pipe to jq for filtering. With --verbose, extra info (URL, HTTP status) is printed before the JSON.

Commands

Search & Discovery

Find movies, TV shows, and people:

seer-cli search multi -q "The Matrix"              # search everything
seer-cli search multi -q "Nolan" --page 2           # paginated results
seer-cli search keyword -q "sci-fi"                 # TMDB keywords
seer-cli search company -q "A24"                    # production companies
seer-cli search trending                            # currently trending
seer-cli search trending --time-window week          # weekly trending
seer-cli search movies --genre 28                   # discover by genre
seer-cli search movies --studio 7505                # by studio
seer-cli search movies --sort-by popularity.desc    # custom sort
seer-cli search tv --genre 18 --network 213         # TV by genre + network

Search results include a mediaType field (movie, tv, or person) and a TMDB id used by other commands.

If mediaInfo exists on a result, it's already tracked. mediaInfo.status values: 1=unknown, 2=pending, 3=processing, 4=partially available, 5=available.

Movie Details

seer-cli movies get 157336                  # details by TMDB ID
seer-cli movies ratings 157336              # ratings
seer-cli movies ratings-combined 157336     # combined RT/IMDB ratings
seer-cli movies recommendations 157336      # recommended movies
seer-cli movies similar 157336              # similar movies

TV Show Details

seer-cli tv get 72844                       # show details
seer-cli tv ratings 72844                   # ratings
seer-cli tv recommendations 72844           # recommendations
seer-cli tv similar 72844                   # similar shows
seer-cli tv season 72844 1                  # season details + episodes

Requesting Media

Create requests for movies or TV shows using their TMDB ID:

# Request a movie
seer-cli request create --media-type movie --media-id 157336

# Request a TV show (all seasons)
seer-cli request create --media-type tv --media-id 72844 --seasons all

# Request specific seasons
seer-cli request create --media-type tv --media-id 72844 --seasons 1,2

# Request 4K version
seer-cli request create --media-type movie --media-id 157336 --is4k

Manage existing requests:

seer-cli request list                       # list all requests
seer-cli request get 5                      # get specific request
seer-cli request count                      # counts by status
seer-cli request approve 5                  # approve
seer-cli request decline 5                  # decline
seer-cli request retry 5                    # retry failed request
seer-cli request delete 5                   # delete

Media Management

seer-cli media list                         # list all tracked media
seer-cli media status 1 available           # update status
seer-cli media watch-data 1                 # get watch data
seer-cli media delete 1                     # remove from Seer
seer-cli media delete-file 1                # delete file from Radarr/Sonarr

Issues

Report and track problems with media:

seer-cli issue list                         # list all issues
seer-cli issue create                       # create new issue
seer-cli issue get 3                        # get issue details
seer-cli issue count                        # issue counts
seer-cli issue comment 3                    # add comment
seer-cli issue update-status 3 resolved     # resolve issue
seer-cli issue delete 3                     # delete issue

Watchlist

seer-cli watchlist add --media-type movie --tmdb-id 157336
seer-cli watchlist add --media-type tv --tmdb-id 72844
seer-cli watchlist delete 1                 # remove by watchlist ID

Blocklist

Prevent media from appearing in discovery:

seer-cli blocklist list                     # list blocked items
seer-cli blocklist get 157336               # get by TMDB ID
seer-cli blocklist add --tmdb-id 157336     # add to blocklist
seer-cli blocklist delete 1                 # remove by ID

People

seer-cli person get 525                     # person details
seer-cli person combined-credits 525        # all movie + TV credits

Collections

seer-cli collection get 2344               # collection details (e.g., a film series)

Users

seer-cli users list                         # list all users
seer-cli users get 1                        # user details
seer-cli users create                       # create user
seer-cli users update 1                     # update user
seer-cli users delete 1                     # delete user
seer-cli users requests 1                   # user's requests
seer-cli users watchlist 1                  # user's watchlist
seer-cli users watch-data 1                 # user's watch data
seer-cli users quota 1                      # user's request quota
seer-cli users import-from-plex             # import Plex users
seer-cli users import-from-jellyfin         # import Jellyfin users
seer-cli users bulk-update                  # bulk permission update
seer-cli users settings get 1               # get user settings
seer-cli users password reset 1             # reset password

Services (Radarr / Sonarr)

seer-cli service radarr-list                # list Radarr servers
seer-cli service radarr-get 1               # profiles + root folders
seer-cli service sonarr-list                # list Sonarr servers
seer-cli service sonarr-get 1               # profiles + root folders
seer-cli service sonarr-lookup 72844        # look up series in Sonarr

TMDB Metadata

seer-cli tmdb genres-movie                  # movie genre IDs
seer-cli tmdb genres-tv                     # TV genre IDs
seer-cli tmdb languages                     # supported languages
seer-cli tmdb regions                       # supported regions
seer-cli tmdb network 213                   # network details (e.g., Netflix)
seer-cli tmdb studio 7505                   # studio details
seer-cli tmdb backdrops                     # trending backdrops

Other Lookups

seer-cli other certifications-movie         # movie age ratings by country
seer-cli other certifications-tv            # TV age ratings by country
seer-cli other keyword 180547               # keyword details
seer-cli other watchprovider-regions        # available streaming regions
seer-cli other watchproviders-movies        # movie streaming providers
seer-cli other watchproviders-tv            # TV streaming providers

Override Rules

Custom rules for request routing:

seer-cli overriderule list                  # list rules
seer-cli overriderule create                # create rule
seer-cli overriderule update 1              # update rule
seer-cli overriderule delete 1              # delete rule

System Status

seer-cli status system                      # server version + status
seer-cli status appdata                     # app data volume info

MCP Server

seer-cli mcp serve starts a Model Context Protocol server that exposes the Seer API as tools. This lets AI agents (including Claude Desktop) use seer-cli without invoking the CLI directly.

stdio transport (Claude Desktop)

Claude Desktop spawns the process and communicates over stdin/stdout. No authentication or network configuration required.

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "seer": {
      "command": "/usr/local/bin/seer-cli",
      "args": ["mcp", "serve"],
      "env": {
        "SEER_SERVER": "https://your-seer-instance.com",
        "SEER_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP transport

For MCP clients that connect over HTTP with Bearer token auth:

seer-cli mcp serve --transport http --addr :8811 --auth-token mysecrettoken

Endpoint: http://localhost:8811/mcp — set Authorization: Bearer mysecrettoken in your client.

For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a secret path prefix via --route-token (or SEER_MCP_ROUTE_TOKEN):

# Add --cors if connecting from a browser-based client (e.g. claude.ai)
seer-cli mcp serve --transport http --addr :8811 --route-token abc123 --no-auth --cors
# Endpoint becomes: http://localhost:8811/abc123/mcp

Both methods can be combined for defense in depth:

seer-cli mcp serve --transport http --route-token abc123 --auth-token mysecrettoken

All flags are configurable via environment variables:

FlagEnvironment variableDefault
--transportSEER_MCP_TRANSPORTstdio
--addrSEER_MCP_ADDR:8811
--auth-tokenSEER_MCP_AUTH_TOKEN—
--no-authSEER_MCP_NO_AUTHfalse
--route-tokenSEER_MCP_ROUTE_TOKEN—
--corsSEER_MCP_CORSfalse
--tls-certSEER_MCP_TLS_CERT—
--tls-keySEER_MCP_TLS_KEY—

Pass --cors (or SEER_MCP_CORS=true) to enable CORS headers for browser-based clients (e.g. claude.ai). Disabled by default.

The HTTP transport does not implement OAuth 2.0. Use stdio for Claude Desktop.

MCP tools available

CategoryTools
Searchsearch_multi, search_discover_movies, search_discover_tv, search_trending
Moviesmovies_get, movies_recommendations, movies_similar, movies_ratings
TVtv_get, tv_season, tv_recommendations, tv_similar, tv_ratings
Requestsrequest_list, request_get, request_create, request_approve, request_decline, request_delete, request_count
Mediamedia_list, media_status_update
Issuesissue_list, issue_get, issue_create, issue_status_update, issue_count
Usersusers_list, users_get, users_quota
People & Collectionsperson_get, person_credits, collection_get
Servicesservice_radarr_list, service_sonarr_list
Settingssettings_about, settings_jobs_list, settings_jobs_run
Watchlist & Blocklistwatchlist_add, watchlist_remove, blocklist_list, blocklist_add, blocklist_remove
Systemstatus_system

Common Workflows

Find and request a movie

seer-cli search multi -q "Interstellar"     # find TMDB ID
seer-cli movies get 157336                  # confirm details
seer-cli request create --media-type movie --media-id 157336

Find and request a TV show

seer-cli search multi -q "Breaking Bad"    # find TMDB ID
seer-cli tv get 1396                        # confirm details
seer-cli request create --media-type tv --media-id 1396 --seasons all

Check what genre IDs mean

seer-cli tmdb genres-movie                  # e.g., 28=Action, 18=Drama
seer-cli tmdb genres-tv

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

PinchTab Browser Ops

Browser automation via PinchTab CLI (nav/snap/find/click/fill/press/text) with low-token accessibility-tree flow. Use when the user asks to operate websites,...

Registry SourceRecently Updated
640WisZhou
Coding

Aigames

Create a mini HTML game, organize files in a new folder, and upload it to the brianclan/aigames GitHub repo for www.thenext.games.

Registry SourceRecently Updated
1690brianclan
Coding

Api Tester Cn

API请求构造、curl命令生成、Mock数据、API文档、HTTP状态码速查、Headers说明。API request builder, curl generator, mock data, API documentation, HTTP status codes, headers reference. Us...

Registry SourceRecently Updated
2550bytesagain
Coding

Miaoda App Builder

Create, modify, generate, and deploy websites, web apps, dashboards, SaaS products, internal tools, interactive web pages, Weixin mini program , games on the...

Registry SourceRecently Updated
3552seiriosPlus