abracadabra50/open-supermarkets

npm install -g open-supermarkets
or from source: git clone + npm install + npm link; npx playwright install chromium (browser-auth providers only)

Usage

• •CLI: supermarket search 'olive oil' --country ES
• •MCP: { mcpServers: { groceries: { command: 'supermarket-mcp' } } }
• •agent skills: drop SKILL.md + skills/ into Claude Code/OpenClaw

Key features

• ✓9 providers / 5 countries (Tesco, Sainsbury's, Ocado, Albert Heijn NL/BE, Mercadona, Kroger, Instacart)
• ✓4 of 5 countries need no credentials; no API key for most search
• ✓22 MCP tools incl. grocery_search, grocery_compare, batch search/add, basket, slots, checkout (dry_run default true), favourites, orders
• ✓batch mode: 30 queries in one invocation (~1.7s) instead of 30 round trips
• ✓manifest-based providers loaded on demand; --enrich adds Nutri-Score/NOVA/allergens from Open Food Facts
• ✓supermarket-api plain HTTP server for agents without filesystem
• ✓per-provider SKILL.md files capturing quirks

Best for

Meal-planning, price-tracking, and shopping agents across UK/NL/BE/ES/US.

Caveats

• ⚠most integrations unofficial — retailers change APIs and run bot protection
• ⚠automated access may conflict with retailer ToS; personal automation only
• ⚠checkout previews by default; real money needs --confirm
• ⚠cookie-auth sessions expire and need re-import
• ⚠Ocado slot booking/checkout blocked by AWS WAF