← Back to Skills Marketplace
463
Downloads
0
Stars
3
Active Installs
7
Versions
Install in OpenClaw
/install seerr
Description
Search for movies and TV shows via a Seerr instance and request them for download. Use when the user asks to download, find, request, or queue a movie or TV...
Usage Guidance
Before installing: 1) Note that SKILL.md requires SEERR_URL and SEERR_API_KEY (an API key). The registry metadata did not declare these — ask the publisher to update the manifest so the platform can surface the secret requirement. 2) Only provide SEERR_API_KEY if you trust the Seerr instance and the skill author; treat it as a secret and verify how the platform stores it. 3) Understand that the skill will auto-request items (POST /api/v1/request) which can trigger downloads via Radarr/Sonarr — if you don't want automatic requests, request a version that asks for explicit confirmation before POSTing. 4) Test on a local or non-production Seerr instance first. 5) If you use this in Discord, verify the channel IDs and that the agent's messaging permissions are limited. 6) If possible, create a Seerr API key with minimal permissions and ask the developer to declare required env vars in the registry so the platform can enforce least-privilege handling.
Capability Analysis
Type: OpenClaw Skill
Name: seerr
Version: 1.5.0
The skill bundle uses `curl` commands to interact with a Seerr instance, requiring `SEERR_URL` and `SEERR_API_KEY` from environment variables. The `SKILL.md` provides `curl` command templates that directly embed parameters like `PERCENT_ENCODED_QUERY` and `TMDB_ID`. If the OpenClaw agent does not properly sanitize or escape user-provided input before interpolating it into these `curl` commands, it could lead to command injection or JSON injection vulnerabilities, particularly in the `query` parameter of the search API call. While there is no explicit malicious intent in the skill's instructions, this pattern represents a significant vulnerability if the agent's execution environment is not robustly secured against such input.
Capability Assessment
Purpose & Capability
The functionality described (search Seerr, request movies/TV, post status to Discord) is coherent and consistent with the skill name/description. However, the skill's published metadata lists no required environment variables while the SKILL.md explicitly requires SEERR_URL and SEERR_API_KEY — the manifest and runtime instructions are mismatched.
Instruction Scope
SKILL.md stays narrowly focused on the Seerr API and Discord messaging. It provides explicit curl examples and a clear workflow (search → filter → optionally auto-request → post messages). It does instruct the agent to auto-request unavailable items (POST /api/v1/request) and to send separate Discord messages; these behaviors are within the stated purpose but are actions with side effects (initiating download requests) and therefore worth user attention. SKILL.md references SEERR_URL and SEERR_API_KEY although those were not declared in the registry.
Install Mechanism
This is an instruction-only skill with no install spec and no shipped code — minimal install/write-to-disk risk.
Credentials
The SKILL.md requires two environment values: SEERR_URL (base URL) and SEERR_API_KEY (secret). Those are proportional to the stated functionality, but the registry metadata lists no required env vars or primary credential. The omission is an incoherence: the skill needs a sensitive API key but the manifest does not declare it. Users should treat the SEERR_API_KEY as a secret and confirm how/where it will be stored and who can read it.
Persistence & Privilege
The skill is not configured 'always: true' and makes no claim to modify system-wide settings. Model invocation/autonomous operation is allowed (platform default) which means the agent could automatically call the Seerr API to request items — this is expected for the skill but is a behavior to be conscious of.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install seerr - After installation, invoke the skill by name or use
/seerr - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.0
**Seerr Skill v1.5.0** — Improved Discord integration and messaging workflow.
- Search results are now sent as separate Discord messages, each with its own poster and details.
- Each message includes title, year, rating, genres, a short overview, status emoji, and a Seerr link.
- Improved Discord message format: always use the media field for poster images.
- Status handling clarified: shows "available" vs auto-requests and confirms if not available.
- Removed instruction to combine results; now always send each match separately.
v1.4.0
**Seerr 1.4.0 changelog**
- Updated instructions for Discord: now responses use plain text with markdown, links, and poster images, not interactive buttons or cards
- Changed workflow so media is automatically requested if not already available, with confirmation sent to user
- Added rating and genre fields to result summary
- Clarified use of status emoji and Seerr link in all responses
- API and environment documentation remain unchanged
v1.3.0
No changes detected in this version.
- Version bump to 1.3.0 with no modifications to skill files or documentation.
- No user-facing changes.
v1.2.0
- Clarified that environment variables should be stored in the OpenClaw environment or `.env` file, with examples for both local and remote Seerr setup.
- Added an explicit note to always use `$SEERR_URL` (not hardcoded localhost) in API calls, ensuring compatibility with non-local instances.
- Adjusted Discord integration instructions to use `$SEERR_URL` dynamically in card button links.
- Made minor wording changes for clarity and setup guidance.
v1.1.0
- Added guidance for Discord integration with interactive cards and buttons for a one-click user experience.
- Documented the new Discord message format using `components` blocks, action rows, and status badges.
- Provided instructions for building Seerr request URLs and including status emojis.
- Clarified that `components` (not `embeds`) should be used for Discord v2, and how to handle multiple results.
- Existing API usage and workflow are unchanged.
v1.0.1
- Added an env section listing required environment variables (`SEERR_URL`, `SEERR_API_KEY`) to the skill manifest.
- No changes to functionality or workflow were made; documentation update only.
v1.0.0
Initial release of the Seerr skill for searching and requesting media:
- Search for movies and TV shows via a configured Seerr instance.
- Request movies (Radarr) or TV shows (Sonarr) for download directly from search results.
- Shows status for media requests and whether items are already available.
- Supports requesting all or specific TV seasons.
- Requires Seerr API key and instance URL for configuration.
Metadata
Frequently Asked Questions
What is Seerr Media Requests?
Search for movies and TV shows via a Seerr instance and request them for download. Use when the user asks to download, find, request, or queue a movie or TV... It is an AI Agent Skill for Claude Code / OpenClaw, with 463 downloads so far.
How do I install Seerr Media Requests?
Run "/install seerr" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Seerr Media Requests free?
Yes, Seerr Media Requests is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Seerr Media Requests support?
Seerr Media Requests is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Seerr Media Requests?
It is built and maintained by ximga (@ximga); the current version is v1.5.0.
More Skills