name: jisu-barcode2 description: 使用极速数据商品条码查询 API，通过商品条形码查询商品名称、品牌、规格、产地、包装信息等基础资料。 metadata: { "openclaw": { "emoji": "🏷️", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }

极速数据商品条码查询（Barcode2）

基于 商品条码查询 API 的 OpenClaw 技能， 通过商品条形码（EAN8/EAN13，69 开头）查询商品基础信息。

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

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

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

使用方式

按条形码查询商品信息

python3 skills/barcode/barcode.py '{"barcode":"06917878036526"}'

请求参数以 JSON 形式传入，仅需一个字段：

{
  "barcode": "06917878036526"
}

请求参数

返回结果示例

脚本直接输出接口 result 字段，典型结构与官网示例一致（简化版）：

{
  "barcode": "06917878036526",
  "name": "雀巢咖啡臻享白咖啡",
  "ename": "NESCAFE White Coffee",
  "unspsc": "50201708 (食品、饮料和烟草>>饮料>>咖啡和茶>>咖啡饮料)",
  "brand": "NESCAFE",
  "type": "29g",
  "width": "70毫米",
  "height": "160毫米",
  "depth": "55毫米",
  "origincountry": "中国",
  "originplace": "",
  "assemblycountry": "中国",
  "barcodetype": "",
  "catena": ",",
  "isbasicunit": "0",
  "packagetype": "",
  "grossweight": "",
  "netcontent": "5条",
  "netweight": "145克",
  "description": "",
  "keyword": "雀巢咖啡臻享白咖啡",
  "pic": "",
  "price": "",
  "licensenum": "QS3117 0601 0440",
  "healthpermitnum": ""
}

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

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

常见错误码

基于 极速数据条码文档：

系统错误码：

在 OpenClaw 中的推荐用法

1. 用户拍照/输入条码号：「帮我查一下条码 06917878036526 是什么商品」。
2. 代理构造 JSON：{"barcode":"06917878036526"} 并调用：
   python3 skills/barcode/barcode.py '{"barcode":"06917878036526"}'
3. 从结果中读取 name/brand/type/netcontent/netweight/origincountry 等字段，为用户总结商品名称、品牌、规格和产地信息。