hemkop

name	hemkop
description	Use the hemkop CLI to search for grocery products, manage your cart, and browse stores on Hemköp

hemkop CLI

A CLI for interacting with Hemköp's grocery store API. Use this skill when the user wants to search for groceries, manage their shopping cart, or look up store information on Hemköp.

Setup

The CLI requires Hemköp credentials. They can be provided via:

• Environment variables: HEMKOP_USERNAME and HEMKOP_PASSWORD
• Flags: -u <username> -p <password>
• A .env file in the current directory

Commands

Search for products

hemkop product search <query>

Returns a table of matching products with code, name, price, compare price, volume, and stock status.

Show product details

hemkop product show <product-code>

Product codes follow the format {id}_{unit} where unit is ST (piece) or KG (kilogram).

List stores

hemkop store list [filter]

Optionally filter by store name or town.

Show store details

hemkop store show <store-id>

View cart

hemkop cart list

Add product to cart

hemkop cart add <product-code> [quantity]

Default quantity is 1.

Remove product from cart

hemkop cart remove <product-code>

Clear cart

hemkop cart clear

Workflow tips

• Always search for a product first to find the correct product code before adding to cart.
• Status messages go to stderr, data goes to stdout. Use pipes and redirects to process product data.
• Use hemkop product search with broad queries; results are paginated (max 30 per search).