核心用法
jisu-movie 是 OpenClaw 平台的电影影讯查询技能,基于极速数据电影API构建,提供六大核心功能:
| 功能 | 命令 | 典型场景 |
|------|------|---------|
| 当前城市上映电影 | `movie on` | 「今天杭州有什么电影?」 |
| 电影放映的电影院 | `movie movietheater` | 「哪里能看《XX》?」 |
| 电影院放映的电影 | `movie theatermovie` | 「这家影院今天有什么场次?」 |
| 电影详情 | `movie detail` | 「《盗梦空间》是谁导演的?」 |
| 按城市获取电影院 | `movie theater` | 「附近有哪些万达影城?」 |
| 获取电影城市列表 | `movie city` | 获取全国城市层级数据 |
调用方式:通过 Python 脚本 skills/movie/movie.py 传入子命令和 JSON 参数,需配置 JISU_API_KEY 环境变量。
显著优点
- 数据维度丰富:覆盖影片基础信息、影院地址/坐标、实时排片场次、票价、购票链接等完整链路
- 查询灵活性高:支持城市名/城市ID双模式、电影名/电影ID互查、关键词搜索影院
- 场景闭环设计:从「查有什么电影」→「哪里能看」→「几点场次」→「多少钱」形成完整决策链条
- 地理位置支持:返回经纬度坐标,可结合地图服务做距离排序
潜在缺点与局限性
- 依赖第三方API:极速数据为商业数据服务,存在接口稳定性、数据更新延迟、服务变更风险
- API密钥成本:免费额度有限,高频调用需付费,存在
104请求次数限制错误码 - 地域覆盖盲区:部分三四线城市或偏远地区影院数据可能不全
- 实时性限制:排片数据非毫秒级实时,热门影片开售瞬间的座位信息可能滞后
- 无用户身份体系:无法对接用户会员、优惠券、积分等个性化服务
适合人群
- 本地生活助手类AI Agent开发者
- 需要快速集成电影查询能力的对话机器人
- 影院周边服务(餐饮、停车)的推荐场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | `JISU_API_KEY` 明文存储于环境变量 | 使用密钥管理服务,避免硬编码 |
| 成本失控 | 高频查询消耗API额度 | 增加请求缓存、限流机制 |
| 数据合规 | 影院位置信息涉及POI数据授权 | 确认极速数据的数据源合规性 |
| 服务中断 | 第三方API故障导致功能不可用 | 设计降级策略,返回静态提示语 |
错误码速查
业务错误:201-210(参数缺失、资源不存在、无信息);系统错误:101-108(密钥问题、限流、IP封禁、维护停用)。