Grocy 库存技能

检查并管理您的Grocy库存、购物清单和电池。此技能连接到您的本地Grocy实例。

配置

变量	值
URL	http://localhost:14611
API密钥

mz43yGJzBKfwZdSOwG5EdnKPRrKnCbkGrEFbxXYv2JF61tQ9Mj |

快速命令

检查库存（冰箱/食品柜）

bash curl -s -H GROCY-API-KEY: $API_KEY $URL/api/stock

通过条形码查询详情

bash curl -s -H GROCY-API-KEY: $API_KEY $URL/api/stock/products/by-barcode/{barcode}

通过条形码消耗库存

bash curl -s -X POST -H GROCY-API-KEY: $API_KEY \ -H Content-Type: application/json \ -d {amount: 1, transaction_type: consume} \ $URL/api/stock/products/by-barcode/{barcode}/consume

通过条形码标记库存为已开封

bash curl -s -X POST -H GROCY-API-KEY: $API_KEY \ -H Content-Type: application/json \ -d {amount: 1} \ $URL/api/stock/products/by-barcode/{barcode}/open

通过条形码转移库存

bash curl -s -X POST -H GROCY-API-KEY: $API_KEY \ -H Content-Type: application/json \ -d {amount: 1, locationidfrom: 6, locationidto: 2} \ $URL/api/stock/products/by-barcode/{barcode}/transfer

获取所有电池

bash curl -s -H GROCY-API-KEY: $API_KEY $URL/api/batteries

记录电池充电

bash curl -s -X POST -H GROCY-API-KEY: $API_KEY \ -H Content-Type: application/json \ -d {battery_id: 7} \ $URL/api/batteries/7/charge

常见任务

任务	命令
通过条形码查找产品	GET /api/stock/products/by-barcode/{barcode}
通过条形码消耗

POST /api/stock/products/by-barcode/{barcode}/consume | | 通过条形码开封 | POST /api/stock/products/by-barcode/{barcode}/open | | 通过条形码转移 | POST /api/stock/products/by-barcode/{barcode}/transfer | | 检查电池状态 | GET /api/batteries | | 记录电池充电 | POST /api/batteries/{id}/charge |

提示

• - 使用 jq 格式化JSON日志：curl ... | jq
• 对于条形码，请使用 Stock by-barcode 标签中的直接 /by-barcode/{barcode} 端点。
• 完整API文档：参见 references/grocy-api.md