TMDb 技能是一个基于 TMDb(The Movie Database)API 的命令行工具,用于查询电影和电视剧的详细信息,并支持个性化推荐与待看列表管理。
用途 该技能面向需要快速检索影视资料、了解流媒体播放渠道或获取个性化观影建议的场景。它通过脚本调用 TMDb API,将搜索结果、详情、演员阵容、评分和播放渠道等信息以命令行输出呈现。
主要能力
- 搜索:search 命令可搜索电影,加 --tv 参数可搜索电视剧;person 命令可搜索演员、导演等人物。
- 详情查询:movie 命令按 ID 查看电影完整信息,加 --cast 附带演员表;tv 命令查看剧集详情;info 命令按名称先搜索再展示详情。
- 流媒体查询:where 命令可查询某部影片的流媒体播放渠道,支持按名称或 ID 查询,并可用 --region 指定地区(默认美国)。
- 发现与推荐:trending 查看本周热门(--tv 切换剧集);recommend 基于某部影片获取推荐;discover 支持按类型、年份、评分等条件筛选,例如 --genre action --year 2024 或 --genre sci-fi --rating 7.5。
- 个性化:suggest 命令结合 Plex 观看历史与用户偏好生成建议;pref 命令可设置偏好(类型、导演、回避类型)或查看当前偏好;watchlist 命令可添加、查看和移除待看影片。
使用方式 使用前需设置环境变量 TMDB_API_KEY,该密钥可在 themoviedb.org 免费获取。所有命令通过 uv run {baseDir}/scripts/tmdb.py 调用,后接子命令与参数。例如搜索电影使用 search "Inception",查询播放渠道使用 where "Inception" --region GB,设置偏好使用 pref <user_id> --genres "sci-fi,thriller,drama"。
适用场景 适合个人影视资料查询、流媒体渠道查找、基于偏好的观影推荐,以及维护个人待看列表。若环境中存在 Plex 技能,suggest 命令可拉取最近观看历史以优化推荐;若存在 ppl.gift(CRM)技能,偏好会以联系人备注形式存储,从而跨会话持久保存。
限制 TMDb 免费层 API 限制为每 10 秒 40 次请求。流媒体提供商因地区而异,默认地区为美国。个性化推荐依赖 TMDb 数据、用户偏好与观看历史,其中观看历史需要 Plex 技能支持,偏好持久化需要 ppl.gift 技能支持。类型筛选可使用常见类型 ID,如 action (28)、adventure (12)、animation (16)、comedy (35)、crime (80)、documentary (99)、drama (18)、family (10751)、fantasy (14)、horror (27)、mystery (9648)、romance (10749)、sci-fi (878)、thriller (53)、war (10752)。