用途:基于 TMDb(The Movie Database)API 提供影视信息检索与个性化推荐,覆盖搜索、详情、播放渠道、趋势发现、偏好设置和片单管理。
主要能力:可搜索电影、电视剧及人物(演员、导演);查看电影或剧集的完整信息并可附带演员阵容;按名称查询详情;查询流媒体播放渠道(可指定地区);查看本周趋势内容;基于某部影片获取推荐;使用类型、年份、评分等条件进行高级发现;按用户设置偏好并生成个性化建议;维护用户片单(添加、查看、删除)。若可用,可与 Plex 技能集成,用最近观看历史优化推荐;与 ppl.gift(CRM)集成,将偏好保存为用户联系人备注以跨会话持久化。
使用方式:需设置环境变量 TMDB_API_KEY(可在 themoviedb.org 免费获取)。命令通过 uv run {baseDir}/scripts/tmdb.py 调用,支持 search、person、movie、tv、info、where、trending、recommend、discover、suggest、pref、watchlist 等子命令。例如:uv run {baseDir}/scripts/tmdb.py search "Inception";uv run {baseDir}/scripts/tmdb.py where "Inception" --region GB;uv run {baseDir}/scripts/tmdb.py pref <user_id> --genres "sci-fi,thriller,drama"。discover 的 --genre 可使用类型 ID(如 action 28、sci-fi 878)。
适用场景:查找影视资料与演员信息、确认某地区流媒体播放渠道、发现新片、按个人口味生成推荐、管理观看片单。
限制:免费层 TMDb API 为每 10 秒 40 次请求;流媒体播放渠道因地区而异,默认地区为美国;个性化推荐依赖 TMDb 数据、用户偏好与观看历史,部分集成能力需相应技能可用。价格、费用等其他信息暂未提供。