Dokumentation: nemlig API, MCP, CLI og Python SDK

Brug NemlAI fra terminalen, fra Python, over HTTP eller fra din AI-agent. Du får det samme som i web-appen: en forudsagt kurv ud fra jeres egne ordrer, søgning, priser og tilbud, og kurven sendt til nemlig.com.

Vælg din indgang

CLI

Kommandoen nemlai: interaktiv terminal eller enkelte kommandoer, som scripts og agenter kan køre.

Installér →

Python SDK

Samme pakke, importeret i Python. Svarer med JSON, så det er nemt at bygge videre på.

Se eksempel →

HTTP API

Et dokumenteret REST-API med token-login. Bruges af CLI'en, SDK'et og web-appen.

Kom i gang →

AI-agenter

Lad Claude, ChatGPT, OpenClaw eller din egen agent klare indkøbet via CLI'en.

Sådan →

MCP-server

Hostet MCP-server til Claude, ChatGPT, Grok og andre MCP-klienter: forbind med URL'en og log ind. Intet at installere.

Forbind din assistent →

Web-terminal

Prøv kommandoerne i browseren uden at installere noget.

Åbn web-terminalen →

Hvad er forskellen på NemlAI og andre nemlig-API'er og MCP-servere?

nemlig.com har ingen offentlig API. Der findes efterhånden en del open source-værktøjer, der kan søge efter varer og lægge dem i kurven, når du beder om det. NemlAI kan det samme, men starter et andet sted: den ved selv, hvad I plejer at købe, og foreslår næste kurv.

	Typisk API-wrapper eller MCP	NemlAI
Søg varer og læg i kurv	Ja	Ja
Forudsig næste kurv ud fra jeres ordrer	Nej	Ja
Foreslå mængder	Nej	Ja
Bliver bedre for hver ordre	Nej	Ja
Web-app til resten af husstanden	Sjældent	Ja
Samme kurv prissat i flere butikker	Sjældent	Ja
Kører uden at du selv hoster noget	Sjældent	Ja

Det betyder, at din agent ikke skal gætte, hvad der mangler. Den kan bede om den forudsagte kurv, rette den til og sende den.

Installér CLI og SDK

Pakken hedder nemlai og indeholder både CLI'en og Python-SDK'et. Den kræver en NemlAI-konto (lukket beta).

# Anbefalet: som selvstændigt værktøj
pipx install nemlai

# Eller med pip
pip install nemlai

# Arch Linux (AUR)
yay -S nemlai

# Ubuntu / Debian
sudo add-apt-repository ppa:milops/nemlai
sudo apt install nemlai

# macOS (Homebrew)
brew install miller-milops/nemlai/nemlai

Første kommandoer

nemlai login                  # log ind på din NemlAI-konto
nemlai predict                # forudsig næste kurv
nemlai search "mælk"          # søg i nemlig.com-kataloget
nemlai basket                 # se kurven
nemlai basket prices          # hvad koster kurven i hver butik
nemlai                        # interaktiv terminal med tab-completion

Til scripts kan du sætte miljøvariablen NEMLAI_TOKEN. Alle kommandoer står i CLI- og API-referencen.

Python SDK

from nemlai import NemlAI

client = NemlAI(token="nemlai_...")          # eller NemlAI.login(email, password)

basket = client.basket.generate(size="medium")   # forudsig næste kurv
for item in client.basket.items()["items"]:
    print(item["name"], item["quantity"])

client.basket.adjust("5001234", 2)               # ret mængde (varenummer)
client.basket.compare()                          # samme kurv i andre butikker
client.basket.send()                             # læg kurven i din kurv på nemlig.com

SDK'et dækker også søgning, fravalg, husstand, indstillinger, forbrugsanalyse og eksport af dine data. Se nemlai på PyPI og referencen.

HTTP API

Log ind og få et token, og send det som Authorization: Bearer. Tokens starter med nemlai_.

curl -X POST https://nemlai.milops.org/cli/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "dig@example.com", "password": "din-adgangskode"}'

export NEMLAI_TOKEN="nemlai_..."
curl https://nemlai.milops.org/cli/api/auth/me \
  -H "Authorization: Bearer $NEMLAI_TOKEN"

Alle endpoints, svarformater og fejlkoder står i CLI- og API-referencen.

AI-agenter: Claude, ChatGPT, OpenClaw

Bruger du en assistent med MCP, så forbind den som beskrevet nedenfor. En agent, der kan køre kommandoer (fx Claude Code eller OpenClaw), kan også bruge CLI'en direkte. Installér nemlai, log ind, og giv agenten en opgave:

Brug kommandoen nemlai til at klare ugens indkøb på nemlig.com.
Forudsig næste kurv, vis mig den, og fjern det, jeg siger nej til.
Søg efter alternativer, hvis noget er udsolgt.
Send kurven til nemlig.com, men gå ikke til kassen.

Din agent kan ikke betale. NemlAI lægger kun varer i kurven. Du godkender og betaler altid selv hos butikken.

MCP-server til Claude, ChatGPT og andre AI-assistenter

NemlAI's MCP-server (Model Context Protocol) er hostet på https://nemlai.milops.org/mcp. Med den kan Claude, ChatGPT og andre MCP-klienter bruge NemlAI direkte: hente den forudsagte kurv, søge varer, sammenligne priser og sende kurven til nemlig.com. Du logger ind med OAuth og trykker "Giv adgang"; ingen adgangskode i chatten.

Klient	Sådan
claude.ai, Claude Desktop og mobil	Customize → Connectors → Add custom connector → URL `https://nemlai.milops.org/mcp` → Connect → log ind → Giv adgang.
ChatGPT	Indstillinger → Apps & Connectors (udviklertilstand) → tilføj en MCP-server med URL'en, godkendelse OAuth.
Grok	grok.com/connectors → New Connector → Custom → URL'en → log ind.
Claude Code	`/plugin marketplace add miller-milops/nemlai-mcp` og `/plugin install nemlai@nemlai`
Codex, Hermes, OpenClaw	`pipx install nemlai`, `nemlai login`, derefter `nemlai mcp install codex` (eller `hermes`, `openclaw`)

Alle værktøjer, eksempler og CLI-alternativer står i guiden til AI-agenter. Plugins og skill ligger i det offentlige repo github.com/miller-milops/nemlai-mcp.

Butikker: nemlig, Bilka, BilkaToGo, føtex, Netto, REMA 1000

nemlig.com: fuld støtte: ordrehistorik, forudsigelse, søgning og kurv.
BilkaToGo: kurven kan sendes til din BilkaToGo-kurv (nemlai basket send-shop bilkatogo).
Bilka og føtex: digitale kvitteringer kan forbindes, så forudsigelsen kender jeres køb i butikken (nemlai shops link).
Netto og REMA 1000: kun prissammenligning af kurven.

Salling Group API? Salling Group har en officiel udvikler-API med fx butikker og madspild-tilbud, men ikke din egen ordrehistorik eller din kurv. NemlAI arbejder med din egen konto, så det er dine ordrer og din kurv.

In English: NemlAI API, CLI and MCP for nemlig.com

NemlAI is a grocery automation service for nemlig.com, the Danish online supermarket. It learns from a household's own order history and predicts the next basket, with quantities, which you review and check out yourself. Developers get the same engine through a CLI and Python SDK (pipx install nemlai), a token-authenticated HTTP API, and a hosted MCP server (https://nemlai.milops.org/mcp, OAuth) for Claude, ChatGPT and other AI agents. Agent guide: /agents; plugins and skill: github.com/miller-milops/nemlai-mcp.

Unlike thin nemlig API wrappers and grocery MCP servers that can only search products and fill a cart on request, NemlAI tells your agent what is about to run out. It also prices the same basket at Bilka, føtex, Netto and REMA 1000, and can push it to BilkaToGo. The service is in closed beta and Denmark-only. Full reference: CLI and API docs.