SuperAPI AI 工具集

jellyfin-cli

通用与其它

查看项目

更新于 10-16 00:03

技能介绍

用途:通过 Jellyfin 服务器的 REST API,在终端查询媒体库信息,所有命令均为只读操作。

主要能力:info 显示服务器名称、版本、操作系统与用户数;recent 列出最近添加的媒体,可用 --movies、--episodes 按类型过滤,--limit 控制数量;search 按关键词搜索,--type 接受逗号分隔的条目类型(如 Movie,Series,Episode);item 查看指定条目详情;libraries 列出媒体库名称、集合类型与 ID;browse 按库 ID 分页浏览;next-up 返回指定用户下一批未观看剧集;stats 显示电影、剧集、单集、歌曲总数。

使用方式:先在 Jellyfin 仪表盘 → API Keys 生成密钥,然后设置环境变量:export JELLYFIN_URL="http://your-server:8096"、export JELLYFIN_API_KEY="your-api-key-here"、export JELLYFIN_USER_ID="your-jellyfin-user-id"。运行 scripts/jellyfin-cli,全局标志 --json 输出机器可读结果,--dry-run 预览请求路径与参数而不发起网络调用。

限制:JELLYFIN_URL 必须包含协议与端口;recent、next-up、item 需要 JELLYFIN_USER_ID 或 --user-id,不会自动选择管理员;--movies/--episodes 为服务端过滤;search 的 --type 使用 Jellyfin 条目类型名;每个命令只返回一页结果,不自动分页,需用 --limit 控制;--help 与 --dry-run 无需凭据即可运行。密钥通过 X-Emby-Token 请求头发送。