极速数据 ISBN 图书书号查询（Jisu ISBN）

基于 ISBN 图书书号查询 API 的 OpenClaw 技能，支持：

ISBN 精确查询：通过 10 位或 13 位 ISBN 查询图书详细信息；
关键字搜索：通过书名关键字搜索图书列表，获取书名、作者、封面及 ISBN。

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

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

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

使用方式

1. 按 ISBN 查询图书信息

python3 skills/isbn/isbn.py '{"isbn":"9787212058937"}'

请求 JSON：

{
  "isbn": "9787212058937"
}

2. 按关键字搜索图书（/isbn/search）

python3 skills/isbn/isbn.py search '{"keyword":"老人与海","pagenum":1}'

请求 JSON：

{
  "keyword": "老人与海",
  "pagenum": 1
}

其中 pagenum 为可选，默认第一页，每页 20 条。

请求参数

ISBN 查询

字段名	类型	必填	说明
isbn	string	是	10 位或 13 位 ISBN

关键字搜索

字段名	类型	必填	说明
keyword	string	是	书名关键字
pagenum	int	否	页码（默认第一页，一页 20 条）

返回结果示例

ISBN 查询返回（简化）

脚本直接输出接口 result 字段，结构与官网示例一致（参考 https://api.jisuapi.com/api/isbn/）：

{
  "title": "有理想就有疼痛",
  "subtitle": "中国当代文化名人访谈录",
  "pic": "http://api.jisuapi.com/isbn/upload/96/033c435b3f0f30.jpg",
  "author": "高晓春",
  "summary": "……",
  "publisher": "安徽人民出版社",
  "pubplace": "合肥",
  "pubdate": "2013-01",
  "page": 256,
  "price": "29.00",
  "binding": "",
  "isbn": "9787212058937",
  "isbn10": "7212058939",
  "keyword": "名人－访问记－中国－现代",
  "cip": "2012280296",
  "edition": "1版",
  "impression": "1",
  "language": "",
  "format": "23×18",
  "class": "K820.76",
  "sellerlist": [
    {
      "seller": "当当",
      "price": "20.80",
      "link": "http://product.dangdang.com/22921241.html"
    }
  ]
}

关键字搜索返回（简化）

{
  "keyword": "老人与海",
  "total": 10000,
  "pagenum": 1,
  "pagesize": 20,
  "list": [
    {
      "title": "老人与海",
      "author": " (美) 海明威, 著",
      "pic": "https://api.jisuapi.com/isbn//upload/99/780099.jpg",
      "isbn": "9787511024817"
    }
  ]
}

当出现错误（如 ISBN 不正确或无数据）时，脚本会输出：

{
  "error": "api_error",
  "code": 202,
  "message": "ISBN不正确"
}

常见错误码

来源于极速数据 ISBN 文档：

代号	说明
201	ISBN 为空
202	ISBN 不正确
205	没有信息

系统错误码：

代号	说明
101	APPKEY 为空或不存在
102	APPKEY 已过期
103	APPKEY 无请求权限
104	请求超过次数限制
105	IP 被禁止

在 OpenClaw 中的推荐用法

用户提供 ISBN：「帮我查一下 ISBN 9787212058937 这本书的信息」。
代理构造 JSON：{"isbn":"9787212058937"} 并调用：
python3 skills/isbn/isbn.py '{"isbn":"9787212058937"}'
从返回结果中提取书名、作者、出版社、出版时间、定价、摘要等字段，为用户生成简要介绍；
如果用户只有书名大致关键字，可先调用搜索接口：
python3 skills/isbn/isbn.py search '{"keyword":"老人与海","pagenum":1}'，
在结果列表中选出最符合的图书，再用其 ISBN 进行精确查询。