核心用法
jisu-movie 是 OpenClaw 平台的电影影讯查询技能,基于极速数据电影影讯 API构建。该技能提供 6 个核心接口:获取当前城市上映电影(/movie/on)、查询某电影放映的电影院(/movie/movietheater)、获取某电影院放映的电影及场次(/movie/theatermovie)、查询电影详情(/movie/detail)、按城市获取电影院列表(/movie/theater)、获取电影城市列表(/movie/city)。用户可通过城市名或城市 ID、电影 ID 或电影名等灵活参数进行查询,支持日期筛选和关键词搜索。
显著优点
1. 功能全面:覆盖电影信息查询的全链路场景,从城市影讯→影院筛选→场次详情→影片资料,形成完整闭环。
2. 参数设计灵活:城市/城市 ID、电影名/电影 ID 均可互换使用,降低调用门槛;支持日期参数,可查询未来排片。
3. 返回信息丰富:场次信息包含时间、语言、厅名、价格、购票链接等实用字段,影院数据含坐标、评分、座位数等结构化信息。
4. 中文本土化:针对国内电影市场设计,城市数据和影院信息贴合实际使用场景。
潜在缺点与局限性
1. 数据依赖第三方:极速数据的覆盖范围和更新频率决定技能质量,偏远城市或小影院可能存在数据缺失(错误码 210)。
2. API 调用限制:需要申请 APPKEY 并受次数限制(错误码 104),免费额度可能无法满足高并发场景。
3. 时效性约束:电影行业变动快,排片信息可能延迟或临时调整,API 数据与实际购票平台(猫眼、淘票票)可能存在差异。
4. 功能边界明确:仅支持查询,不支持直接购票跳转后的支付状态跟踪,需用户自行完成购票流程。
适合人群
- 本地生活助手开发者:需集成电影查询能力的对话机器人
- 影院信息聚合工具:需要批量获取影院排片数据的运营人员
- 个人用户:通过自然语言快速了解「附近有什么电影」「某影院今晚有什么场次」
常规风险
1. 密钥泄露风险:JISU_API_KEY 需妥善保管,避免硬编码在公开仓库
2. 配额耗尽风险:高频调用可能触发次数限制(错误码 104),建议增加缓存机制
3. 数据准确性风险:API 返回的票价、场次可能非实时,用户决策前建议二次确认
4. IP 封禁风险:异常请求模式可能导致 IP 被禁止(错误码 105/106)