tmdb-cli 是一个面向终端的电影与电视剧发现工具，封装了 The Movie Database（TMDb）API v3，让用户可以直接在命令行中搜索、筛选和浏览影视内容。
用途 该工具适用于需要快速查询电影、电视剧、热门趋势、即将上映内容、类型列表和美国电影分级的场景。用户可以通过关键词搜索，也可以按类型、分级、评分和日期等条件进行发现式浏览。
主要能力
- 电影搜索：按关键词搜索电影，显示标题、发行年份和平均评分。
- 电影发现：按类型、分级、评分和日期范围筛选电影，支持复合过滤。
- 即将上映：查看即将上映的电影列表。
- 电视剧搜索：按关键词搜索电视剧，显示名称、首播年份和平均评分。
- 电视剧发现：按类型、评分和播出日期筛选电视剧。
- 热门内容：查看按天或按周统计的热门电影、电视剧或全部媒体。
- 类型列表：浏览可用的电影和电视剧类型。
- 分级查询：查看美国电影分级列表。
使用方式 首先在 themoviedb.org/settings/api 获取免费的 API 密钥或访问令牌，然后设置环境变量：
export TMDB_ACCESS_TOKEN="your-tmdb-access-token" # 推荐 export TMDB_API_KEY="your-tmdb-api-key"
--help 和 --dry-run 无需凭据即可使用（延迟认证）。
常用命令示例： tmdb-cli movie search --term "dune" tmdb-cli movie discover --genre horror --certification R tmdb-cli movie upcoming --limit 20 tmdb-cli tv search --term "severance" tmdb-cli tv discover --genre sci-fi tmdb-cli trending --type all --window day tmdb-cli genre list --type movie tmdb-cli certification
全局标志可在子命令前后任意位置使用： tmdb-cli --json movie search --term "dune" tmdb-cli --dry-run movie discover --genre horror tmdb-cli --quiet trending tmdb-cli --verbose movie search --term "alien"
适用场景 适合开发者、影视爱好者或需要在脚本中集成影视数据查询的用户。--json 输出便于机器读取，--dry-run 可用于预览而不实际调用 API。
限制与注意事项
- 类型名称匹配不区分大小写，且通过子字符串匹配，例如 --genre sci 可匹配 "Sci-Fi" 和 "Science Fiction"。
- 分级仅限美国：--certification 标志和 certification 子命令仅返回或接受美国分级（G、PG、PG-13、R、NC-17），不提供国际分级。
- 该 CLI 封装 TMDb API v3，端点和响应结构遵循 v3 规范。
- 分页默认：每个命令默认返回 10 条结果，使用 --limit 可获取更多，但不会自动翻页超过第一页。
- now-playing 子命令已注册在 argparse 中，映射到 TMDb 的 /movie/now_playing 端点。
参考资料
- scripts/tmdb-cli：CLI 二进制文件，遵循 cli-builder 模式构建，具有非交互式、--json、--dry-run、--quiet、--verbose、通过 emit() 双输出、延迟认证和结构化日志等特性。
- TMDb API v3 参考：官方 API 文档。
- TMDb API 设置（获取密钥）：免费 API 密钥注册。