/install maoyan-cli
猫眼影院排片与查询
本技能通过执行本地 Python 脚本查阅猫眼电影数据。所有命令都会输出结构化的 JSON 格式结果。请根据需要解析输出的数据并回答用户的问题。
核心工作流与命令
执行以下命令完成特定任务(从项目根目录执行,脚本路径为 skills/maoyan-cli/scripts/maoyan_cli.py):
1. 获取城市 ID(所有操作的基础)
python skills/maoyan-cli/scripts/maoyan_cli.py cities -q \x3C城市名>
说明:从输出中提取 ci(城市 ID)供后续命令使用(如北京对应的 ci 是 1)。
2. 查询城市中的影院列表
python skills/maoyan-cli/scripts/maoyan_cli.py cinemas \x3Cci> [--lat \x3C纬度> --lng \x3C经度>] --limit 20
说明:用于查找特定名称影院的 cinemaId,或回答“某地有哪些影院”。如果有用户的具体位置信息,请传入经纬度以按距离排序。
3. 查询指定影院的排片(含场次和价格)
python skills/maoyan-cli/scripts/maoyan_cli.py shows \x3CcinemaId> \x3Cci>
说明:获取该影院当日及未来几日的排片情况,包括上映的电影信息(含 posterUrl 封面图链接、nm 片名、sc 评分、选场页链接 cinemaPageUrl)、具体场次(seqNo)、价格(originPrice)及直达选座买票的链接(seatUrl)。
4. 电影详情(从详情页 HTML 正则解析)
python skills/maoyan-cli/scripts/maoyan_cli.py detail \x3CmovieId> [ci] [--cinemaId \x3C影院ID>] [--lat \x3C纬度> --lng \x3C经度>]
说明:请求 https://m.maoyan.com/asgard/movie/{movieId} 详情页 HTML,用正则解析片名(nm)、英文名(enm)、类型(cat)、主演(actors)、上映/开播信息(releaseInfo)、时长文案(durText)、时长分钟数(dur)、原始拼接串(showTime)、猫眼评分(sc)、评分人数(scoreCount)、简介(desc)、海报(posterUrl)、关键词(keywords)等。showTime 会按 / 拆成 releaseInfo 与 durText,便于单独展示(如「2019-10-06美国开播」+「45分钟」)。可选 --cinemaId、--lat、--lng 与详情页 URL 一致(带影院或位置上下文)。
5. 搜索特定电影及查询上映影院(“某电影在哪看”)
# 第一步:搜索电影,从返回的 movies 列表中提取正确的 movieId(每项含 posterUrl 封面图、nm、id 等)
python skills/maoyan-cli/scripts/maoyan_cli.py search \x3C电影名> \x3Cci>
# 第二步:使用获取到的 movieId 查询放映该电影的影院列表(输出中会包含该影院该电影的选场页链接 cinemaPageUrl)
python skills/maoyan-cli/scripts/maoyan_cli.py movie-cinemas \x3CmovieId> \x3Cci> [--lat \x3C纬度> --lng \x3C经度>] --limit 20
典型场景示例
场景 1:查特定影院的排片
- 运行
cinemas \x3Cci>,在返回的 JSON 中模糊匹配找到目标影院的cinemaId。 - 运行
shows \x3CcinemaId> \x3Cci>获取并总结排片详情给用户。
场景 2:查某部电影在哪里上映
- 运行
search \x3C电影名> \x3Cci>找到对应电影的movieId。 - 运行
movie-cinemas \x3CmovieId> \x3Cci>获取影院列表并推荐给用户。
附加资源
- 完整的数据结构与接口说明:见 reference.md
- 更多的命令使用示例:见 examples.md
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install maoyan-cli - 安装完成后,直接呼叫该 Skill 的名称或使用
/maoyan-cli触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Maoyan CLI 是什么?
查询猫眼影院排片、搜索电影和上映影院。当用户询问某影院排片(如“某某影城排片”)、某电影在哪家影院上映、某城市有哪些影院,或需要抓取猫眼排片和影院数据时使用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 303 次。
如何安装 Maoyan CLI?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install maoyan-cli」即可一键安装,无需额外配置。
Maoyan CLI 是免费的吗?
是的,Maoyan CLI 完全免费(开源免费),可自由下载、安装和使用。
Maoyan CLI 支持哪些平台?
Maoyan CLI 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Maoyan CLI?
由 IsLand-x(@island-x)开发并维护,当前版本 v1.0.1。