SuperAPI AI 工具集

plex

通用与其它

查看项目

更新于 10-15 23:33

技能介绍

用途:通过 Plex API 以只读方式查询 Plex Media Server,包括浏览媒体库(电影、剧集、音乐、照片)、搜索指定媒体、查看最近添加内容、查看当前活跃播放会话、查看 On Deck 继续观看列表,以及列出可用客户端/播放器。

主要能力:提供辅助脚本 skills/plex/scripts/plex-api.sh,支持 info、libraries、library、search、recent、ondeck、sessions、clients、identity、metadata、children、playlists、refresh 等子命令;输出为 JSON,可用 jq 过滤格式化,也可直接使用 curl 调用接口。

使用方式:在 ~/.claude-homelab/.env 中配置 PLEX_URL(含端口,默认 32400)与 PLEX_TOKEN。Token 可在 plex.tv 的 Authorized Devices 中通过查看设备的 XML 获取 X-Plex-Token。示例:./skills/plex/scripts/plex-api.sh libraries;./skills/plex/scripts/plex-api.sh search "Inception";./skills/plex/scripts/plex-api.sh sessions。使用 curl 时需加 -H "Accept: application/json",否则默认返回 XML。媒体键形如 /library/metadata/12345。库分区键(1、2、3……)因服务器而异,应先列出分区。

适用场景:回答“Plex 上有什么”“搜索某影片”“最近添加了什么”“谁正在观看”“我该继续看什么”“列出我的电影”等问题;可监控媒体库与播放状态。

限制:所有调用均为只读 GET,未实现播放控制;需要网络访问 Plex 服务器;Token 与账户绑定,需妥善保管;多服务器场景需分别传入不同 PLEX_URL 与 PLEX_TOKEN;通过 zsh-tool 调用脚本时需使用 pty: true,否则输出不可见。

关于收费、价格、平台与效果等细节,资料暂未提供。