条码查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-1qazsc77/barcode-query
技能介绍
问题背景
在商品信息核验、库存管理或零售扫码场景中,开发者常面临商品基础数据缺失或更新不及时的问题。手动查询条码信息效率低下,且难以集成到自动化流程中。本技能针对EAN8/EAN13商品条码设计,通过标准化接口返回结构化数据,覆盖产品名称、品牌、规格、原产地等关键字段,解决数据获取的碎片化痛点。
技能实现
核心能力:
- 支持EAN8/EAN13格式条码的在线查询
- 返回字段包含
barcode、name、brand、type、originplace等结构化数据 - 基于HTTP API的轻量级集成,通过
scripts/query_barcode.py脚本实现本地调用
工作流程:
- 用户输入目标条码(如
6901028075018) - 脚本调用接口并携带
ChinazVer=1.0及API Key - 解析返回的JSON数据,按状态码判断结果有效性
- 输出包含产品详细信息的响应
适用边界与注意点
- 单次查询限制:接口设计为一次仅处理一个条码,批量任务需循环调用
- 数据准确性:返回结果受网络时效性影响,建议关键场景多次校验
- 密钥安全:API Key仅用于单次查询,禁止存储或回显完整密钥
- 错误处理:需处理
missing_api_key、invalid_input等错误码,引导用户完成配置
使用场景
- 零售门店收银时扫描条码,核对商品名称与品牌信息
- 仓库盘点时查询条码对应的规格型号与净含量
- 电商平台商品上架前,通过条码获取原产地与产品描述
- 供应链管理时验证商品条码的有效性与基础参数
适合人员
- 零售门店店员,需要在收银时快速确认商品条码对应的名称、品牌与规格参数,避免录入错误
- 仓库管理人员,盘点时需通过条码查询产品规格型号与净含量,确保库存数据与实物一致
- 电商运营人员,商品上架前需获取条码关联的原产地与描述信息,完善商品详情页内容
- 供应链质检人员,验证商品条码有效性时需查询基础参数,确保产品符合入库标准