Jisu Movie

极速数据电影影讯（Jisu Movie）

基于 电影影讯 API 的 OpenClaw 技能，支持：

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/movie/

• 当前城市上映电影（/movie/on）
• 电影放映的电影院（/movie/movietheater）
• 电影院放映的电影（/movie/theatermovie）
• 电影详情（/movie/detail）
• 按城市获取电影院（/movie/theater）
• 获取电影城市列表（/movie/city）

非常适合在对话中回答「今天杭州有哪些上映的电影？」「附近哪家电影院在放某部电影？」「帮我查一下《盗梦空间》的详细信息」等问题。

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/movie/movie.py

使用方式与请求参数

1. 当前城市上映电影（/movie/on）

python3 skills/movie/movie.py on '{"cityid":"382","city":"杭州","date":"2018-07-08"}'

请求 JSON 示例：

{
  "cityid": "382",
  "city": "杭州",
  "date": "2018-07-08"
}

返回结果示例（结构与官网一致，截取部分字段）：

{
  "city": "杭州",
  "cityid": "382",
  "date": "2018-07-08",
  "list": [
    {
      "movieid": "137363",
      "moviename": "我不是药神",
      "pic": "http://api.jisuapi.com/movie/upload/movie/14/137363.jpg"
    }
  ]
}

2. 电影放映的电影院（/movie/movietheater）

python3 skills/movie/movie.py movietheater '{"cityid":"382","city":"杭州","movieid":"137363","date":"2018-07-08"}'

请求 JSON 示例：

{
  "cityid": "382",
  "city": "杭州",
  "movieid": "137363",
  "date": "2018-07-08"
}

返回结果包含电影院列表，每项含 theatername、address、issale、minprice、theaterid、lat、lng 等字段。

3. 电影院放映的电影（/movie/theatermovie）

python3 skills/movie/movie.py theatermovie '{"theaterid":"2059","date":"2018-07-08"}'

请求 JSON 示例：

{
  "theaterid": "2059",
  "date": "2018-07-08"
}

返回结果中 list 为该影院当日影片列表，每个影片包含 moviename、movieid、enname、director、actor、duration、class、year，以及 showlist 场次列表（时间、语言、厅名、价格、购票链接等）。

4. 电影详情（/movie/detail）

python3 skills/movie/movie.py detail '{"movieid":"14","moviename":"盗梦空间"}'

请求 JSON 示例：

{
  "movieid": "14",
  "moviename": "盗梦空间"
}

返回结果示例（部分字段）：

{
  "moviename": "盗梦空间",
  "movieid": "14",
  "enname": "Inception",
  "pic": "http://api.jisuapi.com/movie/upload/movie/1/14.jpg",
  "class": "动作 冒险 科幻",
  "year": "2010",
  "releasedate": "2010-09-01",
  "country": "美国",
  "director": "克里斯托弗·诺兰",
  "actor": "",
  "screenwriter": "克里斯托弗·诺兰",
  "publisher": "华纳兄弟影片公司",
  "summary": "",
  "screentype": "2D/IMAX",
  "duration": "148分钟"
}

5. 按城市获取电影院（/movie/theater）

python3 skills/movie/movie.py theater '{"cityid":"382","city":"杭州","keyword":"万达"}'

请求 JSON 示例：

{
  "cityid": "382",
  "city": "杭州",
  "keyword": "万达"
}

返回结果中 list 为影院列表，每项包含 theaterid、theatername、tel、address、hours、seatnum、roomnum、logo、score、summary、lat、lng 等字段。

6. 获取电影城市列表（/movie/city）

python3 skills/movie/movie.py city '{"parentid":"0"}'

请求 JSON 示例：

{
  "parentid": "0"
}

返回结果示例（部分）：

[
  {
    "cityid": "1",
    "name": "北京",
    "parentid": "0",
    "parentname": "",
    "topname": "",
    "depth": "1"
  },
  {
    "cityid": "30",
    "name": "浙江",
    "parentid": "0",
    "parentname": "",
    "topname": "",
    "depth": "1"
  }
]

常见错误码

来自 官方电影影讯文档 的业务错误码：

系统错误码：

在 OpenClaw 中的推荐用法

1. 用户提出需求，例如：「帮我看看今天杭州有什么电影可以看，并找一场今晚 8 点左右的场次。」
2. 代理先调用：movie on 获取当前城市上映电影列表，从中挑出热门影片供用户选择。
3. 用户选定某部电影后，调用：movie movietheater 获取这部电影在附近城市的放映电影院及最低票价。
4. 如需具体排片信息，再调用：movie theatermovie 查询某个电影院的当日场次列表，并根据 starttime、price、hallname 等字段为用户推荐合适场次和购票链接。
5. 如用户只问某部电影的信息，可直接调用：movie detail 获取影片详细资料（导演、演员、片长、简介等），进行摘要回答。