erikhellman/coop-cli/cmd

coop-cli — Coop.se Grocery Shopping CLI

You have access to coop-cli, a command-line tool for interacting with Coop.se online grocery shopping.

Setup

Authentication

All commands except stores require Coop.se credentials. Set them as environment variables:

export COOP_EMAIL="user@example.com"
export COOP_PASSWORD="password"

Or pass them as flags: --email / --password.

Store ID

Most commands require a store ID. Set it as an environment variable:

export COOP_STORE="012345"

Or pass it as a flag: --store. Find store IDs with the stores command.

If credentials or store ID are missing, prompt the user to set them up before proceeding.

Commands

Find stores (no auth required)

coop-cli stores <query>

Search by city, name, or address. The STORE ID column is the value to use with --store or COOP_STORE.

Search for products

coop-cli search <query> [--limit N]

Returns: ID, name, manufacturer, size, price, comparative price, and category. Default limit is 10 results.

Cart management

coop-cli cart list                      # Show cart contents
coop-cli cart add <product-id> [qty]    # Add product (default qty: 1)
coop-cli cart remove <product-id>       # Remove product
coop-cli cart clear                     # Empty the cart

Product IDs come from search results.

Self-update

coop-cli update

Workflow

When the user asks to shop for groceries or manage their cart, follow this pattern:

1. If no store is configured, help them find one with coop-cli stores <city or name>
2. Search for products with coop-cli search <query>
3. Present results and let the user pick which products to add
4. Add selected products with coop-cli cart add <product-id> [qty]
5. Show the cart with coop-cli cart list to confirm

Tips

• Product names and search queries are in Swedish (e.g., "mjolk" for milk, "brod" for bread)
• The comparative price (e.g., "kr/kg" or "kr/l") helps compare value across package sizes
• Cart operations return the full updated cart, so there's no need to call cart list after cart add