← Back to Skills Marketplace
island-x

Maoyan CLI

by IsLand-x · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
303
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install maoyan-cli
Description
查询猫眼影院排片、搜索电影和上映影院。当用户询问某影院排片(如“某某影城排片”)、某电影在哪家影院上映、某城市有哪些影院,或需要抓取猫眼排片和影院数据时使用。
README (SKILL.md)

猫眼影院排片与查询

本技能通过执行本地 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 会按 / 拆成 releaseInfodurText,便于单独展示(如「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:查特定影院的排片

  1. 运行 cinemas \x3Cci>,在返回的 JSON 中模糊匹配找到目标影院的 cinemaId
  2. 运行 shows \x3CcinemaId> \x3Cci> 获取并总结排片详情给用户。

场景 2:查某部电影在哪里上映

  1. 运行 search \x3C电影名> \x3Cci> 找到对应电影的 movieId
  2. 运行 movie-cinemas \x3CmovieId> \x3Cci> 获取影院列表并推荐给用户。

附加资源

Usage Guidance
This skill appears to do what it says: run the bundled Python CLI to scrape/query Maoyan mobile endpoints and return structured JSON. Before installing, note: (1) it requires a Python 3 runtime even though the registry metadata does not declare it — ensure the agent environment has Python and network egress to m.maoyan.com; (2) the skill will make outbound HTTP(S) requests to m.maoyan.com (no other endpoints) and may accept user-provided lat/lng values; (3) running code from third-party skills carries inherent risk — you reviewed this script and it only queries Maoyan, but only install if you trust the skill owner; (4) be mindful of any site Terms-of-Service or rate limiting when scraping external sites. If you want higher assurance, confirm the working-directory assumptions in SKILL.md (the script path) and consider running the script in an isolated environment.
Capability Analysis
Type: OpenClaw Skill Name: maoyan-cli Version: 1.0.1 The maoyan-cli skill is a legitimate tool designed to query movie schedules, search for films, and locate cinemas via the Maoyan (猫眼) platform. The core logic in scripts/maoyan_cli.py uses standard Python libraries (urllib, re, json) to interact with public mobile endpoints on m.maoyan.com. The script performs data fetching and HTML parsing to return structured JSON to the agent. No evidence of data exfiltration, unauthorized system access, or malicious prompt injection was found in the code or documentation.
Capability Assessment
Purpose & Capability
The name/description claim to query Maoyan for cities, cinemas, shows and movie details, and the code + SKILL.md implement exactly that by calling Maoyan mobile endpoints and parsing HTML/JSON. No unrelated services, credentials, or unexplained requirements are present.
Instruction Scope
SKILL.md instructs the agent to execute the included Python script and parse its JSON output. The instructions remain scoped to fetching/parsing Maoyan endpoints and using optional user location (lat/lng) to sort by distance. They do not request unrelated files, credentials, or external endpoints beyond m.maoyan.com. Note: SKILL.md refers to the runtime path 'skills/maoyan-cli/scripts/maoyan_cli.py' — the skill bundle contains scripts/maoyan_cli.py, which is consistent in intent but the exact working-directory assumption should be confirmed when installing.
Install Mechanism
There is no install spec (instruction-only), and the bundle includes a Python script that will be run locally. That is low risk compared to remote downloads. However, the metadata did not declare a required binary: the skill expects a Python 3 runtime (runs 'python ...') but 'required binaries' is empty in the registry metadata — a minor mismatch to be aware of.
Credentials
The skill requests no environment variables, no credentials, and no config paths. The included code does not read secrets or environment variables. All network calls are to the Maoyan mobile domain (m.maoyan.com), which matches the stated purpose.
Persistence & Privilege
The skill is not marked always:true and does not attempt to modify other skills or system-wide settings. It only runs as-invoked and outputs JSON; no persistent privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install maoyan-cli
  3. After installation, invoke the skill by name or use /maoyan-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- 调整所有命令路径为 skills/maoyan-cli/scripts/maoyan_cli.py,需要从项目根目录执行。 - 新增 detail 命令,通过解析猫眼电影详情页 HTML 获取电影详细信息,包括名称、类型、主演、时长、评分等字段。 - 更新工作流说明,包含 detail 命令的用途和参数。 - 其余命令保持不变,仅更新了脚本路径
v1.0.0
maoyan-cli 1.0.0 初始版本发布 - 支持通过命令行查询猫眼影院排片、搜索电影、查询上映影院和城市影院列表 - 全部命令输出结构化 JSON,便于自动解析和回答 - 提供查询城市 ID、影院列表、影院排片、电影搜素和放映影院的详细说明 - 包含典型场景使用流程与附加文档资源链接
Metadata
Slug maoyan-cli
Version 1.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Maoyan CLI?

查询猫眼影院排片、搜索电影和上映影院。当用户询问某影院排片(如“某某影城排片”)、某电影在哪家影院上映、某城市有哪些影院,或需要抓取猫眼排片和影院数据时使用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 303 downloads so far.

How do I install Maoyan CLI?

Run "/install maoyan-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Maoyan CLI free?

Yes, Maoyan CLI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Maoyan CLI support?

Maoyan CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Maoyan CLI?

It is built and maintained by IsLand-x (@island-x); the current version is v1.0.1.

💬 Comments