什么是Maoyan CLI
Maoyan CLI 是一个命令行工具，用于查询猫眼电影平台的影院排片信息、电影上映情况以及影院分布数据。该工具通过执行本地 Python 脚本的方式，调用猫眼公开数据接口，并以结构化的 JSON 格式返回结果，方便开发者或用户快速获取所需的电影资讯。其核心功能覆盖从城市定位到具体场次信息的完整链路，支持按地理位置筛选和排序，适用于需要实时抓取或自动化处理猫眼数据的场景。所有命令均基于项目根目录下的 `skills/maoyan-cli/scripts/maoyan_cli.py` 脚本运行，无需额外依赖即可直接使用。
核心功能特点
- 支持按城市名称获取城市 ID，作为后续查询的基础参数
- 可查询指定城市内的影院列表，并可选传入经纬度实现距离排序
- 能获取特定影院的详细排片信息，包括电影名称、评分、场次时间、票价及选座购票链接
- 提供电影搜索功能，根据片名返回匹配的电影 ID 及相关元数据
- 支持查询某部电影在特定城市的上映影院列表，并附带直达选场页面的链接
- 电影详情解析涵盖片名、类型、主演、上映时间、时长、评分、简介等结构化字段
适用场景
Maoyan CLI 主要面向需要快速获取猫眼平台电影排片和影院信息的用户或开发者。典型使用场景之一是用户在询问某家影院的当日或近期排片情况时，可通过先查询该影院的 cinemaId，再调用 shows 命令获取完整的场次安排，包括每部电影的放映时间、票价和直接购票入口。另一个常见需求是用户想知道某部电影在当前城市有哪些影院上映，此时可先用 search 命令匹配电影 ID，再通过 movie-cinemas 接口列出所有相关影院及其选场页链接，便于用户就近选择。此外，当系统需集成猫眼数据到内部应用（如票务聚合平台或本地生活助手）时，该工具也能高效完成数据抓取与初步解析工作。由于输出为标准化 JSON，下游系统可轻松对接解析，提升开发效率。