kassalapp-connector

MCP-server og CLI for kassal.app sitt API. Gir AI-agenter (Claude Desktop, Claude Code eller andre MCP-klienter) tilgang til norske dagligvarepriser på tvers av kjeder — Meny, Kiwi, Rema 1000, Oda, Joker, Spar, Coop, Bunnpris m.fl. — for prissammenligning og prishistorikk.

Typisk bruk: en handleagent slår opp varen, sammenligner prisen på tvers av butikkene med compare_prices_by_ean, og legger varen i kurven der den er billigst.

Funksjoner

• Produktsøk på tvers av butikker, med filter på kjede, leverandør, merke og pris

• Prissammenligning per EAN/strekkode — billigste butikk, sortert liste og potensiell besparelse i kroner

• Prisers alder følger med (price_age_days); priser eldre enn 90 dager markeres stale og holdes utenfor billigst-beregningen, siden butikkene slutter å oppdatere priser på utgåtte varer

• Oppslag og sammenligning fra produkt-URL (f.eks. en meny.no-lenke)

• Prishistorikk i bulk for inntil 100 EAN-er (opptil 90 dager på gratisnivået)

• Fysiske butikker: søk på navn, kjede eller posisjon (lat/lng + radius)

• Handlelister — les, opprett og oppdater handlelistene på kassal.app-kontoen (synkroniseres med Kassalapp-mobilappen); varer koblet til produkt viser billigste butikk akkurat nå

Søkeresultater komprimeres til feltene en agent trenger (pris, enhetspris, butikk, EAN, URL) for å spare tokens; full detalj hentes med get_product.

Related MCP server: oda-mcp

Oppsett

1. Lag en konto på kassal.app og generer en API-nøkkel under profil → API (gratis for ikke-kommersiell bruk, 60 forespørsler/min).

2. Bygg og legg inn nøkkelen:

   npm install
   npm run build
   node dist/index.js auth set-key <nøkkel>

   Nøkkelen lagres i ~/.kassalapp-connector/config.json (chmod 600). Alternativt kan du sette miljøvariabelen KASSALAPP_API_KEY eller legge KASSALAPP_API_KEY=<nøkkel> i en .env-fil i prosjektroten (ignorert av git). Prioritet: miljøvariabel → config-fil → .env.

3. Registrer MCP-serveren i klienten din, med absolutt sti:

   # Claude Code
   claude mcp add --scope user kassalapp -- node /sti/til/kassalapp-connector/dist/index.js mcp

   // Claude Desktop (claude_desktop_config.json)
   {
     "mcpServers": {
       "kassalapp": {
         "command": "node",
         "args": ["/sti/til/kassalapp-connector/dist/index.js", "mcp"]
       }
     }
   }

MCP-verktøy

CLI

kassalapp-connector product search melk --store MENY_NO --sort price_asc
kassalapp-connector product ean 7038010000065      # prissammenligning
kassalapp-connector prices 7038010000065 --days 90
kassalapp-connector store search --group KIWI --lat 59.91 --lng 10.75 --km 3
kassalapp-connector list ls                        # handlelister
kassalapp-connector list add 12345 "Tine Helmelk 1l" --product 33529

Kjør uten argumenter for full hjelpetekst.

Merknader

• API-et er rent lesende — ingen bestilling skjer via denne connectoren.

• Gratisnivået er begrenset til 60 forespørsler/min; connectoren venter og prøver én gang på nytt ved HTTP 429.

• store/group filtrerer på kjede (koder som MENY_NO, KIWI — se store_code i søkeresultater); vendor filtrerer på leverandør (f.eks. TINE SA). unique=true gir katalogtreff uten pris/butikk.

• Handleliste-endepunktene er ikke med i kassal.app sin API-dokumentasjon, men er verifisert mot API-et (september 2026). De kan endres uten varsel.

• Uoffisiell klient, ikke tilknyttet kassal.app. Se deres API-vilkår for bruksbetingelser.

Lisens

MIT