Movie & News Inquiry - 电影影讯查询

核心用法

jisu-movie 是基于极速数据电影影讯 API 的 OpenClaw 技能，通过 Python 脚本封装提供六大核心功能：查询城市上映电影、获取电影放映影院、查询影院当日排片、获取电影详细信息、按城市搜索影院、获取电影城市列表。使用时需先申请极速数据 API Key 并配置环境变量 JISU_API_KEY。

调用方式为命令行执行 python3 skills/movie/movie.py <action> '<json_params>'，支持灵活的城市 ID 或名称互斥传参，日期默认为当天。

显著优点

1. 数据覆盖全面：整合电影基本信息、实时排片、影院位置、票价及购票链接，满足从选片到购票的全链路需求
2. 查询维度丰富：支持城市→电影→影院→场次的逆向查询，也支持影院→排片的正向查询，场景适配性强
3. 响应结构规范：返回 JSON 格式统一，字段完整（含经纬度、评分、影厅类型等），便于下游解析和地图对接

潜在缺点与局限性

1. 商业 API 依赖：需单独申请极速数据 API Key，存在调用次数限制和潜在收费门槛
2. 数据时效性：依赖第三方数据商更新，热门档期可能出现排片延迟或票价未同步
3. 地域覆盖不均：三四线城市及县级影院数据完整度可能低于一线城市
4. 无用户身份体系：不支持个人账户、订单管理或观影历史记录

适合人群

• 需要快速集成电影票务查询能力的开发者
• 构建本地生活助手、影院导航类对话机器人的场景
• 对实时排片和比价有轻量需求的终端用户

常规风险

• API Key 泄露风险：JISU_API_KEY 以环境变量传递，若在多用户环境配置不当可能被窃取滥用
• 配额耗尽风险：免费额度用尽后接口返回 104/106 错误，需关注用量或升级套餐
• 数据准确性风险：影院临时调片、票价变动等实时信息可能与实际存在偏差，建议关键决策前二次确认

核心用法

jisu-movie 是一款基于极速数据（jisuapi.com）电影影讯 API 的 OpenClaw 技能，提供完整的电影信息查询能力。用户需先申请 API Key（JISU_API_KEY）并通过环境变量配置后方可使用。

该技能覆盖六大核心功能：

• `movie on`：查询指定城市当日上映电影列表
• `movie movietheater`：查询某部电影在城市的放映影院及票价
• `movie theatermovie`：查询指定影院的当日排片场次
• `movie detail`：获取电影详细信息（导演、演员、片长、简介等）
• `movie theater`：按城市搜索影院（支持关键词过滤）
• `movie city`：获取支持的电影城市层级列表

典型使用流程：先查城市上映影片 → 选片后查放映影院 → 查具体场次时间/票价/购票链接，形成完整的观影决策链路。

显著优点

1. 功能覆盖完整：从影片 discovery 到影院选择、场次预订的全链路支持，满足「今晚看什么、去哪看、几点看」的完整需求
2. 接口设计灵活：城市查询支持 ID/名称双模式，影片查询支持 ID/名称双模式，降低用户记忆成本
3. 数据维度丰富：返回字段包含价格、评分、厅名、语言、购票链接等实用信息，可直接用于决策
4. 安全实践良好：API Key 通过环境变量注入，无硬编码风险；代码结构清晰，输入验证完整
5. 轻量易部署：仅依赖 Python3 标准库 + requests，267 行代码，3 个文件，维护成本低

潜在缺点与局限性

1. 第三方服务依赖：极速数据为 T3 级别商业数据服务商（非顶级开源/大厂官方），服务稳定性、数据质量、长期可用性依赖第三方商业决策
2. 需付费获取 API Key：用户需自行注册并购买/申请极速数据 API 服务，存在使用门槛和潜在费用
3. 无内置缓存机制：每次查询均直接请求 API，高频使用可能触发速率限制（104 错误码）
4. 地域限制：主要覆盖中国大陆城市影讯数据，海外影院信息缺失
5. 实时性瓶颈：电影场次数据依赖上游影院系统同步，可能存在延迟或缺失
6. 无重试与降级：当前实现遇网络故障直接失败，无自动重试或缓存降级能力

适合人群

• 需要集成电影查询功能的对话式 AI 应用开发者
• 希望快速获取影讯数据用于个人脚本或小型项目的开发者
• 对数据实时性要求不极端苛刻的娱乐信息查询场景
• 愿意承担第三方 API 服务成本和管理 overhead 的用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 服务可用性 | 中 | 依赖极速数据服务状态，存在单点故障风险 |

| 数据准确性 | 低 | 影讯数据由上游影院提供，偶有场次缺失或延迟 |

| 成本控制 | 低 | API 调用按量计费，高频使用需注意配额管理 |

| 隐私泄露 | 极低 | 仅传输城市/影片等公开信息，无个人敏感数据 |

| 安全漏洞 | 极低 | 代码审计评分 95/100，无危险函数，TLS 加密传输 |