frisco

Unofficial CLI & MCP server for the Frisco.pl grocery delivery API.

> Disclaimer: This is an independent, community project — not affiliated with Frisco. Use at your own risk.

• Interactive cart TUI (Bubble Tea)
• Product search with category filtering and nutrition info
• Delivery slot reservation
• Order history
• Batch cart additions from JSON shopping lists
• MCP server for AI assistant integration
• Session management (cURL import, browser login)

• Go 1.26+ (per go.mod)
• For frisco session login: a locally installed browser supported by chromedp (e.g. Chrome/Chromium)

go install github.com/rrudol/frisco/cmd/frisco@latest

Local build:

make build
./bin/frisco --help

1. Log in via browser (recommended):

frisco session login

1. Or save session from a cURL command:

frisco session from-curl --curl "curl 'https://www.frisco.pl/app/commerce/api/v1/users/123/cart' -H 'authorization: Bearer ...' -H 'cookie: ...'"

1. Verify your session works:

frisco session verify

frisco cart                    # Interactive TUI (list, +/-, remove, refresh)
frisco cart show
frisco cart add --product-id <id> --quantity 1
frisco cart add-batch --file list.json        # --dry-run for parse-only
frisco products search --search banana
frisco products search --search apple --category-id 18707
frisco products nutrition --product-id 4094
frisco reservation slots --days 2
frisco reservation reserve --date 2026-03-25 --from-time 06:00 --to-time 07:00
frisco reservation cancel
frisco account show
frisco account orders list --all-pages
frisco session login               # Interactive browser login
frisco session refresh-token       # Refresh access token
frisco mcp                         # Start MCP server (stdio)

1. frisco session verify — make sur