← 返回 Skills 市场
ericrosenberg

Jellyseerr

作者 EricRosenberg · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2231
总下载
1
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install jellyseerr
功能描述
Request movies and TV shows through Jellyseerr. Use when the user wants to add media to their Plex/Jellyfin server, search for content availability, or manage media requests.
使用说明 (SKILL.md)

Jellyseerr

Request movies and TV shows through your Jellyseerr server for automated downloading to Plex/Jellyfin.

Setup

Configure your Jellyseerr server:

scripts/setup.sh

You'll need:

  • Jellyseerr server URL
  • API key (from Jellyseerr Settings > General)

Usage

Request a movie:

scripts/request_movie.py "Movie Name"

Request a TV show:

scripts/request_tv.py "TV Show Name"

Search for content:

scripts/search.py "Content Name"

Examples

Request a movie:

scripts/request_movie.py "The Matrix"

Request a TV show (entire series):

scripts/request_tv.py "Breaking Bad"

Request specific TV season:

scripts/request_tv.py "Breaking Bad" --season 1

Automatic Availability Notifications

Get notified when your requested content becomes available.

Webhooks (Recommended)

For instant notifications, set up webhook integration. See references/WEBHOOK_SETUP.md for the complete guide.

Quick setup:

scripts/install_service.sh  # Run with sudo

Then configure Jellyseerr to send webhooks to http://YOUR_IP:8384/

Polling (Alternative)

For environments where webhooks aren't available, use cron-based polling:

crontab -l > /tmp/cron_backup.txt
echo "* * * * * $(pwd)/scripts/auto_monitor.sh" >> /tmp/cron_backup.txt
crontab /tmp/cron_backup.txt

Check pending requests:

scripts/track_requests.py

Configuration

Edit ~/.config/jellyseerr/config.json:

{
  "server_url": "https://jellyseerr.yourdomain.com",
  "api_key": "your-api-key",
  "auto_approve": true
}

API Reference

See references/api.md for Jellyseerr API documentation.

安全使用建议
What to consider before installing: - Functionality: The skill's code matches its description: it talks to a Jellyseerr server using a server URL + API key (stored at ~/.config/jellyseerr/config.json), can poll or receive webhooks, and queues notifications for a bot/Telegram. If that is what you want, the capability is coherent. - Review install scripts before running with sudo: install_service.sh writes a systemd unit and hardcodes SCRIPT_DIR (/home/clawd/...) and User=clawd. If you run it as-is on your machine it will likely point to the wrong path or create a service running under an unexpected user. Edit the service file (or install script) to set the correct WorkingDirectory and User for your environment, and inspect the unit before enabling it. - Network exposure: The webhook server binds 0.0.0.0:8384 by default. If you expose that port to the network, ensure firewall rules or a reverse proxy with TLS/auth are used. Prefer binding to localhost and using a reverse proxy if remote access is required. - Secrets: The Jellyseerr API key is stored locally in ~/.config/jellyseerr/config.json (the setup script sets 600 permissions). Ensure you trust the host and review scripts if you are concerned about accidental exfiltration. The code does not appear to transmit secrets elsewhere, but optional TELEGRAM_CHAT_ID or CLAWDBOT env vars may be used to route notifications. - Notifications integration: The scripts queue notifications in ~/.cache/jellyseerr/pending_notifications.json and expect an external actor (Clawdbot or send_notifications.py run in an appropriate context) to actually deliver messages. If you don't use Telegram/Clawdbot, either adjust the scripts or disable notification automation. - Minor hygiene: The crontab example uses $(pwd) which is fragile; prefer absolute paths. Also verify which user will own the service and files after installation and correct permissions as needed. If you are not comfortable editing the scripts or running systemd units created by this package, do not run the install_service/setup_webhook scripts with sudo; instead run scripts locally, inspect files, and adapt service/unit definitions to your environment.
功能分析
Type: OpenClaw Skill Name: jellyseerr Version: 1.0.0 The skill is classified as suspicious due to its use of high-risk capabilities, including establishing persistence via `crontab` modification (`SKILL.md`, `scripts/auto_monitor.sh`) and creating systemd services with `sudo` (`scripts/install_service.sh`, `scripts/setup_webhook.sh`). It also opens a network port (`0.0.0.0:8384`) using `scripts/webhook_server.py` to receive incoming webhooks. While these actions are plausibly required for the stated purpose of automated media requests and notifications, they represent significant system modifications and network exposure.
能力评估
Purpose & Capability
The code and instructions consistently implement Jellyseerr operations (search, request, poll, webhook receiver, notification queue) and require a Jellyseerr server URL + API key stored in ~/.config/jellyseerr/config.json. That aligns with the description. Note: install_service.sh hardcodes SCRIPT_DIR (/home/clawd/...) and User=clawd which is not consistent with a generic skill install and is unexpected for the described purpose.
Instruction Scope
SKILL.md and reference docs instruct the agent / operator to run setup scripts, install a systemd service, and add cron entries. The scripts write config files to ~/.config and cache files to ~/.cache (expected), but they also create a systemd service and start a network-listening webhook server on port 8384 (expected for webhook behavior) and require sudo for service install. The hardcoded paths and user in install_service.sh and slightly different behavior in setup_webhook.sh (uses $USER) are inconsistent and could cause the service to run as an unexpected user or point to the wrong script location. SKILL.md's crontab example injects a path using $(pwd) — that will depend on where the skill is located and could be brittle.
Install Mechanism
There is no separate package install spec (instruction-only), which minimizes external download risk. However the bundled scripts perform system modifications (create /etc/systemd/system/*.service, enable/start service) and require sudo for that. There is no network download of arbitrary archives or third-party install endpoints.
Credentials
The skill does not declare required environment variables but the code optionally reads TELEGRAM_CHAT_ID and CLAWDBOT_* env vars to populate chat IDs and channels. The primary secret (Jellyseerr API key) is stored in ~/.config/jellyseerr/config.json (entered interactively by setup.sh). The use of environment variables is reasonable for optional notification routing, but the lack of declared env requirements in metadata is a mismatch and worth noting.
Persistence & Privilege
The skill offers to install a persistent systemd service that opens a network port and runs continuously (webhook_server.py). Persistent network services are expected for webhooks, but they do raise the stakes: the service is installed system-wide and started with sudo. The hardcoded User and SCRIPT_DIR in install_service.sh increase risk of misconfiguration; depending on how scripts are run, the service could be created to run as root or reference non-existent paths. The skill does not modify other skills' configs, and always:false is set, but the systemd installation still grants significant persistence and network exposure.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install jellyseerr
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /jellyseerr 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: Request movies/TV shows through Jellyseerr with instant webhook notifications. Includes interactive CLI, automated tracking, and smart notification delivery.
元数据
Slug jellyseerr
版本 1.0.0
许可证
累计安装 2
当前安装数 2
历史版本数 1
常见问题

Jellyseerr 是什么?

Request movies and TV shows through Jellyseerr. Use when the user wants to add media to their Plex/Jellyfin server, search for content availability, or manage media requests. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2231 次。

如何安装 Jellyseerr?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install jellyseerr」即可一键安装,无需额外配置。

Jellyseerr 是免费的吗?

是的,Jellyseerr 完全免费(开源免费),可自由下载、安装和使用。

Jellyseerr 支持哪些平台?

Jellyseerr 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Jellyseerr?

由 EricRosenberg(@ericrosenberg)开发并维护,当前版本 v1.0.0。

💬 留言讨论